diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..6f9ccc2
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,18 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npm run build
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..f1ad30e
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,25 @@
+# CLAUDE.md — MIST.cash Docs
+
+## Commands
+
+- `npm run dev` — Start local dev server with HMR
+- `npm run build` — Build static site to `dist/`
+- `npm run preview` — Preview the production build locally
+
+## Directory Layout
+
+```
+├── astro.config.mjs        # Astro + Starlight configuration
+├── src/
+│   ├── content.config.ts    # Content collection schema
+│   ├── content/docs/        # Markdown/MDX documentation pages
+│   │   ├── index.mdx
+│   │   ├── getting-started.mdx
+│   │   ├── guides/          # Deposit, withdraw, ZK proofs, Merkle trees
+│   │   ├── packages/        # SDK, config, React packages
+│   │   └── reference/       # API, types, contract ABI
+│   └── styles/
+│       └── custom.css       # Custom Starlight theme overrides
+├── tsconfig.json
+└── package.json
+```