Readme and branding

README.md

@@ -1,2 +1,38 @@
-# mist
-The mist compiler
+# Mist Language: <br/> A C++ inspired langauge in the Rust ecosystem
+
+<!--
+Originally this readme was part of the Carbon Language project, licensed with Apache-2.0
+-->
+
+<!-- <p align="center">
+  <a href="#why-build-carbon">Why?</a> |
+  <a href="#language-goals">Goals</a> |
+  <a href="#project-status">Status</a> |
+  <a href="#getting-started">Getting started</a> |
+  <a href="#join-us">Join us</a>
+</p> -->
+
+
+<img src="code.png" align="right" width="575" alt="">
+
+<!--
+Don't let the text wrap too narrowly to the left of the above image.
+The `div` reduces the vertical height. The `picture` prevents autolinking.
+-->
+<div><picture><img src="docs/images/bumper.png" alt=""></picture></div>
+
+**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