From ad209b8d0abfcb569f8f4d7422d0c9e5c8d73447 Mon Sep 17 00:00:00 2001
From: Klesti Selimaj <klesti.selimay@icloud.com>
Date: Mon, 11 May 2026 02:40:48 +0200
Subject: [PATCH] Get started

---
 content/docs/get-started.mdx | 66 ++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 content/docs/get-started.mdx

diff --git a/content/docs/get-started.mdx b/content/docs/get-started.mdx
new file mode 100644
index 0000000..d244c1d
--- /dev/null
+++ b/content/docs/get-started.mdx
@@ -0,0 +1,66 @@
+---
+title: Get Started
+description: Install Mist and run your first program.
+icon: Download
+---
+
+# Get Started
+
+This guide will help you install the Mist CLI, understand its basic commands, and compile your first program.
+
+## Installation
+
+Mist is distributed through Cargo.
+
+Install the Mist compiler using:
+
+```bash title="Terminal"
+cargo install mist-lang@0.0.1-alpha2
+```
+
+Verify using
+
+```bash title="Terminal"
+mist version
+```
+
+## Usage
+
+```bash title="Compiles the project in the current directory"
+mist build
+```
+
+```bash title="Prints the compiler version"
+mist version
+```
+
+```bash title="Shows the help message and available commands"
+mist help
+```
+
+## Hello World
+
+On your existing cargo project project (`cargo init` or `cargo new <name>`).
+
+```json title="mist.json"
+{
+  "src": "src",
+  "output": "build"
+}
+```
+
+```toml title="Cargo.toml"
+[[bin]]
+name = "main"
+path = "build/main.rs"
+```
+
+```bash title=".gitignore"
+/build
+```
+
+```cpp title="src/main.mist"
+void main() {
+    println!("Hello World!");
+}
+```