Getting Started

From zero to running Stackwright site in 5 minutes. No prior experience required.

① Install

One command scaffolds a complete project with the Otter Raft configured.

bash

npx launch-stackwright my-site

② Start the Dev Server

Install dependencies and start developing. Hot reload watches your YAML files.

bash

cd my-site
pnpm install
pnpm dev

③ Edit Your First Page

Open pages/content.yml and change the heading. The dev server reloads automatically.

yaml

1content:
2  content_items:
3    - type: main
4      label: hero
5      heading:
6        text: "My Custom Heading"
7        textSize: h1
8      textBlocks:
9        - text: "This is my first Stackwright page."
10          textSize: body1

④ Add a Page

Use the CLI to create a new page. It generates the directory and YAML file.

bash

pnpm stackwright page add about --heading "About Us"

⑤ Customize the Theme

Edit stackwright.yml to change colors, typography, and navigation across every page.

yaml

1customTheme:
2  colors:
3    primary: "#your-brand-color"
4    background: "#your-bg-color"
5    accent: "#your-accent-color"

What's Next

📦 Content Types

18 content types from hero sections to interactive maps. See them all.

⌨️ CLI Reference

Scaffold, validate, preview, and deploy from the terminal.

🤖 Otter Raft

Let AI agents build your site through conversation.

🔌 MCP Server

Integrate with AI tools via Model Context Protocol.

Hackathon Teams

Running Stackwright at a hackathon? You can go from API spec to working demo in hours. The Otter Raft agents handle brand, theme, and content — just describe what you need.