⛵ Ship

A production-ready SaaS starter kit designed for AI coding agents. 15 features wired up, one command to scaffold, full architecture guide included.

For Agents

Tell your coding agent:

Run npx create-ship --agent to get started, then build [your idea].

The agent runs the command, reads the docs and available features, then scaffolds the project with exactly what it needs. Two steps, zero hand-holding.

How it works

# Step 1: Agent reads the docs
npx create-ship --agent
# → outputs: what Ship is, available features, stack, env vars, key files
# → ends with: "run this command to scaffold your project"

# Step 2: Agent scaffolds the project
npx create-ship my-app --agent --features auth,billing,teams,email
# → clones, configures, installs deps, outputs AGENTS.md
# → agent has code + full architecture context, starts building

Interactive Mode

For humans who want to pick features manually:

npx create-ship my-app

What's Included

• 🔐 Auth · Email/password, Google OAuth, GitHub OAuth, password reset
• 💳 Billing · Stripe checkout, customer portal, webhooks, subscriptions
• 👥 Teams · Create teams, invite by email, roles (owner/admin/member)
• 🛡️ Admin · User management, stats, feature flags
• 🚀 Onboarding · Multi-step wizard after first login
• 📧 Email · Resend + React Email (welcome, invite, reset, subscription)
• 👤 Profiles · Avatar upload, display name, settings
• 🔍 SEO · Sitemap, robots.txt, OG images, JSON-LD
• 📁 Uploads · Supabase Storage with validation and RLS
• ⚡ Workers · Inngest step functions with retries
• ⏰ Cron · Inngest scheduled + Vercel cron fallback
• 🚦 Rate Limiting · Upstash Redis sliding window
• 📊 Analytics · Vercel Analytics, Plausible, or PostHog
• ✅ Env Validation · Zod schemas for all variables
• 🏁 Feature Flags · Supabase-backed with in-memory cache

Features you don't select are fully removed during scaffolding. Within a project, toggle features on/off in src/lib/config.ts.

Stack

Next.js 16 (App Router) · Supabase · Stripe · Tailwind v4 · shadcn/ui · TypeScript · pnpm

Requirements

• Node.js 20+ or 22+
• pnpm (recommended), yarn, or npm
• GitHub access to the Ship template repo

Links

• ship.stratuslabs.io
• Built by Stratus Labs