The Catalyst Approach

Catalyst is designed for AI-assisted development. Clear conventions, inline documentation, and proven patterns help you ship faster.

Core Principles

Surfaces, Not Pages

Each surface (web, app, docs) has its own shell and styling. Delete a folder to remove an entire surface.

AI-First Structure

AGENTS.md provides context for AI tools. Clear file headers and conventions make code predictable.

Proof-Led Delivery

Start with POC, iterate to MVP, polish to production. Each stage has clear quality expectations.

Components Over Code

Use Stack, Row, Grid for layout. Use Text, Title for typography. Consistency beats cleverness.

Getting Started
The fastest path from clone to production
1

Read AGENTS.md

The source of truth for conventions. Your AI tools should read this first.

2

Pick your surface

Start with app for dashboards, web for marketing, or docs for documentation.

3

Configure auth

Set AUTH_MODE in .env.local. Demo mode for prototypes, Supabase for production.

4

Build with components

Use existing UI components. Check /app/components for examples.

Ready to dive deeper?

The documentation covers everything from setup to deployment.

Read the Docs