diff --git a/README.md b/README.md
index 2c7b71a..dde8d5c 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,38 @@
-# mist
-The mist compiler
+# Mist Language: A C++ inspired langauge in the Rust ecosystem
+
+
+
+
+
+
+
+
+
+
+
+**Fast and works with Rust**
+
+- All of your favourite Rust libraries work with Mist
+- Compiles directly into efficient Rust code
+- Zero-cost abstractions, no runtime overhead
+
+**Ergonomic development experience**
+- C/C++ style syntax for quick onboarding
+- Minimal friction compared to raw Rust
+- Designed for fast, readable systems code
+
+**Class and type system**
+- class is syntactic sugar for a Rust struct
+- `struct B extends A` provides inheritance-style syntax over struct composition
+- Classes and structs compile into the same underlying Rust type system model
\ No newline at end of file
diff --git a/code.png b/code.png
new file mode 100644
index 0000000..86aedcb
Binary files /dev/null and b/code.png differ
diff --git a/logo.png b/logo.png
new file mode 100644
index 0000000..998430f
Binary files /dev/null and b/logo.png differ
diff --git a/logo.svg b/logo.svg
new file mode 100644
index 0000000..79d3d46
--- /dev/null
+++ b/logo.svg
@@ -0,0 +1,13 @@
+
+
+
+