Docs: rewrite quickstart as a step-by-step tutorial

docs/docs.json

@@ -4,14 +4,27 @@
   "theme": "mint",
   "colors": {
     "primary": "#8a8c00",
-    "light": "#f3f724",
-    "dark": "#fcff5d"
+    "light": "#c8ca00",
+    "dark": "#6b6d00"
   },
   "logo": {
     "light": "/images/icons/iii-black.svg",
     "dark": "/images/icons/iii-white.svg"
   },
   "favicon": "/images/favicon/favicon.svg",
+  "navbar": {
+    "links": [
+      {
+        "type": "github",
+        "href": "https://github.com/iii-hq/iii"
+      }
+    ],
+    "primary": {
+      "type": "button",
+      "label": "Install",
+      "href": "/install"
+    }
+  },
   "navigation": {
     "versions": [
       {
@@ -134,7 +147,7 @@
             "groups": [
               {
                 "group": "Getting Started",
-                "pages": ["index", "quickstart"]
+                "pages": ["index", "install", "quickstart"]
               },
               {
                 "group": "Primitives & Concepts",

docs/index.mdx

@@ -56,33 +56,7 @@ This results in the ability to:
 
 ## Getting Started
 
-The best way to understand iii is to try it:
-
-### 1. Install iii
-
-Install the iii engine:
-
-```bash
-curl -fsSL https://install.iii.dev/iii/main/install.sh | sh
-```
-
-### 2. Verify installation
-
-Check that iii has installed correctly with the following command. It should return a version number.
-
-```bash
-iii --version
-```
-
-### 3. Add Agent Skills
-
-Give your AI coding agent full context on iii:
-
-```bash
-npx skillkit add iii-hq/iii/skills
-```
-
-Skills covering every iii primitive — works with Claude Code, Cursor, Gemini CLI, Codex, and [30+ other agents](https://agentskills.io).
+The best way to understand iii is to try it. [Install iii](/install) and then follow the [Quickstart](/quickstart) to create your first iii powered project.
 
 ## Next Steps
 

docs/install.mdx

@@ -0,0 +1,39 @@
+---
+title: 'Install'
+description: 'Install the iii engine and set up your development environment.'
+---
+
+## 1. Install iii
+
+Install the iii engine:
+
+```bash
+curl -fsSL https://install.iii.dev/iii/main/install.sh | sh
+```
+
+## 2. Verify installation
+
+Check that iii has installed correctly with the following command. It should return a version number.
+
+```bash
+iii --version
+```
+
+## 3. Add Agent Skills (Optional)
+
+Give your IDEs and AI coding agents full context on iii:
+
+```bash
+npx skillkit add iii-hq/iii/skills
+```
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Quickstart" href="/quickstart" icon="terminal">
+    Follow the Quickstart and explore a live iii application.
+  </Card>
+  <Card title="Concepts" href="/primitives-and-concepts" icon="table-layout">
+    Understand Functions and Triggers from a conceptual point of view.
+  </Card>
+</CardGroup>