Status

🚀 Available on npm - Install with npx r9stack@dev

| Feature | Status | |---------|--------| | TanStack Start + React 19 | ✅ Working | | Starter-based architecture | ✅ Working | | shadcn/ui + Tailwind CSS | ✅ Working | | Convex backend | ✅ Working | | WorkOS auth | ✅ Working | | Flight Rules docs | ✅ Working | | GitHub repo creation | ✅ Working | | Vercel deployment | 📋 Planned | | Stripe payments | 📋 Post-V1 |

Why r9stack?

Agentic coding has dramatically accelerated feature development, but initial project setup—configuring the frontend framework, wiring up the backend and database, integrating auth providers—remains tedious and error-prone.

r9stack eliminates this friction. Run a single command and have a scaffolded full-stack project in minutes.

Architecture

r9stack uses TanStack Start's starter system to create projects:

1. CLI invokes TanStack Start with a --starter flag pointing to a hosted starter.json
2. TanStack Start creates the project and applies r9stack customizations
3. CLI guides post-creation setup for Convex, WorkOS, and optional GitHub/Vercel integration

Tech Stack

| Layer | Technology | Description | |-------|------------|-------------| | Framework | TanStack Start | Full-stack React framework with SSR and server functions | | UI Library | React 19 | Declarative UI with the latest React features | | Language | TypeScript | Type-safe JavaScript for reliable code | | Styling | Tailwind CSS 4 | Utility-first CSS framework | | Build | Vite | Lightning-fast build tool and dev server | | Backend | Convex | Real-time backend with automatic sync | | Auth | WorkOS AuthKit | Enterprise-ready SSO and MFA | | Sessions | iron-session | Encrypted cookie-based sessions | | Components | shadcn/ui | Beautiful, accessible Radix-based components |

Getting Started

# Create a new project
npx r9stack@dev init my-project

Local Development

# Clone the repository
git clone https://github.com/ryanpacker/r9stack.git
cd r9stack

# Install dependencies and build
npm install
npm run build

# Link globally for testing
npm link

# Create a new project
r9stack init my-project

Usage

# Interactive mode - prompts for project name and options
npx r9stack@dev init

# Provide project name directly
npx r9stack@dev init my-awesome-app

# Non-interactive with defaults (installs Flight Rules, skips GitHub)
npx r9stack@dev init my-awesome-app --yes

# Create with GitHub repo
npx r9stack@dev init my-awesome-app --yes --github

# Create public GitHub repo
npx r9stack@dev init my-awesome-app --github --public

# Skip Flight Rules installation
npx r9stack@dev init my-awesome-app --no-flight-rules

# Use a specific starter
npx r9stack@dev init my-awesome-app --starter standard

# List available starters
npx r9stack@dev --starter-list

# View help
npx r9stack@dev init --help

CLI Options

| Flag | Description | |------|-------------| | -y, --yes | Skip confirmation prompts | | -s, --starter <id> | Use a specific starter (e.g., 'standard') | | --no-flight-rules | Skip Flight Rules installation | | --github | Create GitHub repository | | --no-github | Skip GitHub repository creation | | --private | Make GitHub repository private (default) | | --public | Make GitHub repository public |

The CLI will:

1. Fetch the latest starter template from GitHub
2. Create your project using TanStack Start
3. Replace project name placeholders in generated files
4. Install Flight Rules documentation framework
5. Optionally create a GitHub repository and push initial commit
6. Guide you through post-creation setup (Convex, WorkOS)

What Gets Generated (V1 Target)

Running npx r9stack@dev init will create a project with:

my-project/
├── .flight-rules/          # Flight Rules documentation framework
│   ├── AGENTS.md           # Agent guidelines
│   ├── commands/           # Coding session workflows
│   └── doc-templates/      # Documentation templates
├── convex/
│   ├── _generated/         # Auto-generated by Convex
│   ├── schema.ts           # Database schema
│   └── messages.ts         # Demo Convex functions
├── public/
│   └── images/             # App logos and assets
├── src/
│   ├── components/
│   │   ├── ui/             # shadcn components
│   │   ├── AppShell.tsx    # Application shell
│   │   ├── Sidebar.tsx     # Collapsible sidebar
│   │   ├── NavGroup.tsx    # Navigation group
│   │   ├── NavItem.tsx     # Navigation item
│   │   └── UserMenu.tsx    # Auth-aware user menu
│   ├── lib/
│   │   ├── auth.ts         # Auth types
│   │   ├── auth-client.ts  # Client-side auth context
│   │   ├── auth-server.ts  # Server-side auth (iron-session)
│   │   └── utils.ts        # Utilities (cn helper)
│   ├── routes/
│   │   ├── __root.tsx      # Root layout with providers
│   │   ├── index.tsx       # Public landing page
│   │   ├── auth/           # Auth flow routes
│   │   │   ├── sign-in.tsx
│   │   │   ├── callback.tsx
│   │   │   └── sign-out.tsx
│   │   └── app/            # Protected routes
│   │       ├── route.tsx   # Auth guard + AppShell
│   │       ├── index.tsx   # Authenticated home
│   │       └── demo/       # Demo pages
│   └── styles.css          # Tailwind + shadcn styles
├── .env.example
├── components.json         # shadcn configuration
├── package.json
├── tsconfig.json
└── vite.config.ts

Route Structure

• / — Public landing page
• /auth/* — Authentication flow (sign-in, callback, sign-out)
• /app/* — Protected routes (requires authentication)

Manual Setup Required

After scaffolding, you'll need to:

1. Set up WorkOS — Create account at https://workos.com, configure redirect URI
2. Set up Convex — Run npx convex dev to create project and authenticate
3. Add environment variables — Copy .env.example to .env.local and fill in credentials

Project Structure

r9stack/
├── src/                    # CLI source code
├── starters/
│   └── standard/           # r9-starter-standard source
├── tests/
│   ├── e2e/               # End-to-end tests
│   └── output/            # Test output (gitignored)
├── docs/
│   ├── prd.md             # Product requirements
│   ├── implementation/    # Implementation specs
│   └── ...
└── dist/                  # Compiled CLI

Documentation

• Product Requirements
• TanStack Starter System
• Starter Development Guide
• Tech Stack

License

Apache 2.0 - See LICENSE for details.