diff --git a/README.md b/README.md
index b7e6d8b679..6ce6b8b101 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,9 @@
 
 ### From rough idea to production code — automatically.
 
-**Multi-node agent orchestrator** — tasks, agents, missions, git, files, and worktrees, with any model, local or cloud.
+### 🏭 A software factory, run by a multi-agent orchestrator.
+
+Describe what you want — a team of AI agents **plans, builds, reviews, and ships** it for you. Fusion is your software factory: an assembly line for code that runs across tasks, agents, missions, git, files, and worktrees, with any model, local or cloud.
 
 [**runfusion.ai →**](https://runfusion.ai) · [Docs](./docs/README.md) · [GitHub](https://github.com/Runfusion/Fusion) · [npm](https://www.npmjs.com/package/@runfusion/fusion) · [Discord](https://discord.gg/ksrfuy7WYR)
 
@@ -43,6 +45,72 @@ One board. Controlled from anywhere. Laptop, Mac mini, Linux server, cloud VM, p
 
 ---
 
+## Quick start
+
+**Zero install, straight from npm:**
+
+```bash
+npx runfusion.ai
+```
+
+That launches the dashboard. Subcommands forward through: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (Or verbosely: `npx @runfusion/fusion dashboard`.)
+
+**One-line installer** (macOS & Linux — auto-picks Homebrew, falls back to npm):
+
+```bash
+curl -fsSL https://runfusion.ai/install.sh | sh
+fusion dashboard
+```
+
+**Homebrew** (macOS & Linux):
+
+```bash
+brew tap runfusion/fusion
+brew install fusion
+fusion dashboard            # or: fn dashboard
+```
+
+Or as a one-liner (auto-taps): `brew install runfusion/fusion/fusion`.
+
+**npm global**:
+
+```bash
+npm install -g @runfusion/fusion
+fn dashboard                # or: fusion dashboard
+```
+
+**From a clone** (for development):
+
+```bash
+pnpm dev dashboard
+```
+
+Then click the `Open:` URL printed in the terminal. It embeds a bearer token
+(`http://localhost:4040/?token=fn_...`) that the browser captures to
+`localStorage` on first visit and reuses automatically thereafter. On the
+server side, Fusion now persists the dashboard/daemon token in
+`~/.fusion/settings.json` on first authenticated run and reuses it on later
+starts unless you override it (`--token`, `FUSION_DASHBOARD_TOKEN`,
+`FUSION_DAEMON_TOKEN`) or disable auth with `--no-auth`. See
+[CLI reference → fn dashboard → Authentication](./docs/cli-reference.md#fn-dashboard)
+for full precedence and reset/revocation options.
+
+### First-run setup
+
+On first launch, Fusion opens the **onboarding wizard** with three guided steps:
+
+1. **AI Setup** — Use a simplified quick-start provider list (recommended providers plus any already-connected providers), then expand **Advanced provider settings** only if you need additional providers or setup details. You only need one provider to get started. Deprecated Google Gemini CLI / Antigravity provider entries are intentionally hidden; Google/Gemini API key, Google Generative AI, Vertex, and Cloud Code paths remain supported.
+2. **GitHub (Optional)** — Connect GitHub for issue import and PR management
+3. **First Task** — Create your first task or import from GitHub (if no project is active, onboarding first prompts you to register/select a project directory)
+
+The wizard is **dismissible and non-blocking** — click **Skip for now** to use the dashboard immediately. Re-trigger it later from **Settings → Authentication → Reopen onboarding guide**.
+
+### Mobile
+
+For Capacitor + PWA workflow, see [MOBILE.md](./MOBILE.md).
+
+---
+
 ## The flow
 
 ```
@@ -347,72 +415,6 @@ npx companies.sh add paperclipai/companies/gstack
 
 ---
 
-## Quick start
-
-**Zero install, straight from npm:**
-
-```bash
-npx runfusion.ai
-```
-
-That launches the dashboard. Subcommands forward through: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (Or verbosely: `npx @runfusion/fusion dashboard`.)
-
-**One-line installer** (macOS & Linux — auto-picks Homebrew, falls back to npm):
-
-```bash
-curl -fsSL https://runfusion.ai/install.sh | sh
-fusion dashboard
-```
-
-**Homebrew** (macOS & Linux):
-
-```bash
-brew tap runfusion/fusion
-brew install fusion
-fusion dashboard            # or: fn dashboard
-```
-
-Or as a one-liner (auto-taps): `brew install runfusion/fusion/fusion`.
-
-**npm global**:
-
-```bash
-npm install -g @runfusion/fusion
-fn dashboard                # or: fusion dashboard
-```
-
-**From a clone** (for development):
-
-```bash
-pnpm dev dashboard
-```
-
-Then click the `Open:` URL printed in the terminal. It embeds a bearer token
-(`http://localhost:4040/?token=fn_...`) that the browser captures to
-`localStorage` on first visit and reuses automatically thereafter. On the
-server side, Fusion now persists the dashboard/daemon token in
-`~/.fusion/settings.json` on first authenticated run and reuses it on later
-starts unless you override it (`--token`, `FUSION_DASHBOARD_TOKEN`,
-`FUSION_DAEMON_TOKEN`) or disable auth with `--no-auth`. See
-[CLI reference → fn dashboard → Authentication](./docs/cli-reference.md#fn-dashboard)
-for full precedence and reset/revocation options.
-
-### First-run setup
-
-On first launch, Fusion opens the **onboarding wizard** with three guided steps:
-
-1. **AI Setup** — Use a simplified quick-start provider list (recommended providers plus any already-connected providers), then expand **Advanced provider settings** only if you need additional providers or setup details. You only need one provider to get started. Deprecated Google Gemini CLI / Antigravity provider entries are intentionally hidden; Google/Gemini API key, Google Generative AI, Vertex, and Cloud Code paths remain supported.
-2. **GitHub (Optional)** — Connect GitHub for issue import and PR management
-3. **First Task** — Create your first task or import from GitHub (if no project is active, onboarding first prompts you to register/select a project directory)
-
-The wizard is **dismissible and non-blocking** — click **Skip for now** to use the dashboard immediately. Re-trigger it later from **Settings → Authentication → Reopen onboarding guide**.
-
-### Mobile
-
-For Capacitor + PWA workflow, see [MOBILE.md](./MOBILE.md).
-
----
-
 ## Documentation
 
 | Guide | What it covers |
diff --git a/demo/assets/agent-chat.gif b/demo/assets/agent-chat.gif
index 8566494771..96274d3a79 100644
Binary files a/demo/assets/agent-chat.gif and b/demo/assets/agent-chat.gif differ
diff --git a/demo/assets/workflows-gray.gif b/demo/assets/workflows-gray.gif
index b3de66063f..a1f08916af 100644
Binary files a/demo/assets/workflows-gray.gif and b/demo/assets/workflows-gray.gif differ
diff --git a/demo/assets/workflows-light.gif b/demo/assets/workflows-light.gif
index 3b79b67fa6..7283151cdb 100644
Binary files a/demo/assets/workflows-light.gif and b/demo/assets/workflows-light.gif differ
diff --git a/demo/assets/workflows.gif b/demo/assets/workflows.gif
index 9f231b153d..09b2865637 100644
Binary files a/demo/assets/workflows.gif and b/demo/assets/workflows.gif differ