YAML is the syntax. The schema is the safety net. AI writes the code.

From API spec to working Next.js app in hours. Stackwright is a typed DSL where AI agents write YAML, the schema enforces safety, and the output is a production-ready React app you own.

YAML is the syntax. The schema is the safety net. AI writes the code. graphic

Why Stackwright

AI-Native Authoring

Specialized AI agents write schema-validated YAML. The Otter Raft handles brand, theme, and pages through conversation.

Safe by Construction

Zod schemas enforce correctness at build time and runtime. Invalid states are rejected before reaching the browser.

Hours, Not Days

Go from API spec to working demo in a hackathon sprint. npx launch-stackwright and you're building.

Theme System

Dark mode, custom palettes, typography, spacing — all in YAML. One file controls the entire visual identity.

Standard React Output

The output is a Next.js app in a git repo you own. No lock-in, no runtime magic. Fork it, extend it, deploy it.

MCP Integration

20+ tools via Model Context Protocol. AI agents create pages, validate schemas, render previews, and open PRs.

Pages Are YAML

Write structured content, not code. The schema validates every field before rendering.

yaml
1content:
2  content_items:
3    - type: main
4      label: hero
5      heading:
6        text: "Hello World"
7        textSize: h1
8      textBlocks:
9        - text: "My first Stackwright page."
10          textSize: body1
11      buttons:
12        - text: "Learn More"
13          variant: contained
14          href: /about

The Otter Raft 🦦

Four AI agents that build Stackwright sites through conversation. Brand → Theme → Pages — each otter handles one step. The Foreman coordinates the pipeline.

🦦🏗️ Foreman Otter

Coordinates the build pipeline. Tell the Foreman what you want and it delegates to the right otter. Orchestrates Brand → Theme → Page workflow.

🦦🎨 Brand Otter

Discovers your brand through conversation. Asks about voice, tone, color preferences, and emotional targets. Produces a brand brief.

🦦🌈 Theme Otter

Translates brand briefs into Stackwright themes. Colors, typography, spacing, dark mode. Writes stackwright.yml configuration.

🦦📄 Page Otter

Builds pages in your brand voice. Writes schema-valid YAML. Verifies pages visually with render screenshots.

Stackwright Pro 🔐

Pro packages extend Stackwright into paid territory — third-party integrations, OpenAPI tooling, and enterprise features. The OSS monorepo defines interfaces; Pro ships implementations.

OpenAPI Integration

Turn any OpenAPI spec into typed Zod schemas, CollectionProviders, and API clients. 'Here is an API spec' → 'Here is a working app' in hours.

Enterprise Ready

RBAC, secrets management, CSP headers, audit logging. Built for government and defense requirements.

Map Integrations

Cesium 3D globe for enterprise logistics. deck.gl for massive data volumes. MapLibre GL included in OSS.

Common Questions

Is Stackwright production-ready?
See for yourself. Stackwright powers this site and built its own documentation site, https://trystackwright.dev
Do I need to know React?
Not for content management. Stackwright provides a library of pre-built components that your YAML content maps to. You only need React knowledge if you want to create custom components.
How does AI integration work?
Stackwright includes the Otter Raft — four AI agents that coordinate through conversation. Brand Otter discovers your voice, Theme Otter generates the theme, Page Otter writes YAML. The MCP server enables 20+ tools for AI authoring.
Can I use my existing design system?
Yes. Stackwright is theme-agnostic. Define your design tokens in stackwright.yml, and all components automatically use them. Bring your own components for fine-grained control.
What's the difference between OSS and Pro?
Stackwright OSS defines interfaces, the rendering engine, and file-backed implementations. Pro ships implementations too specialized, too maintenance-intensive, or too commercially sensitive for open source. Your app never takes a hard dependency on Pro.

Ready to Build?

Stackwright turns structured YAML into production-ready Next.js apps. Start with the CLI, bring your team, and ship something real.