โ† Back to home

Getting Started with Craft

Learn how to set up your Craft template in less than 10 minutes. Full-stack boilerplate with Next.js 15, tRPC, Prisma, TanStack Query, Zustand, and more.

Prerequisites

Before you begin, make sure you have:

  • Node.js 20+ installed
  • pnpm package manager (npm install -g pnpm)
  • Git for version control
  • A code editor (VS Code recommended)

1. Purchase & Download Template

Choose your template from the pricing page:

Available Templates:

Complete Bundle ($175) - All 6 templates

โ€ข ๐Ÿš€ Rapid Web ($99) - Ship in 2 days, 1-2 devs

โ€ข โš–๏ธ Balanced Web ($109) - Production-ready, 3-10 devs

โ€ข ๐Ÿ† Crafted Web ($119) - Enterprise-grade, 10+ devs

โ€ข ๐Ÿš€ Rapid Web + Mobile ($124) - Fast MVP with mobile app

โ€ข โš–๏ธ Balanced Web + Mobile ($139) - Production with mobile

โ€ข ๐Ÿ† Crafted Web + Mobile ($149) - Enterprise with mobile

After purchase, you'll receive:

  • โœ… Instant download link via email
  • โœ… ZIP file with complete template
  • โœ… Installation guide (README.md)
  • โœ… Environment variable examples

2. Extract Template

# Unzip the downloaded template
unzip rapid-web.zip -d my-saas
# Navigate to your project
cd my-saas

3. Install Dependencies

# Install all dependencies
pnpm install

๐Ÿ’ก Pro Tip: This will install all packages for the entire monorepo. Takes ~2-3 minutes.

๐Ÿค–

MCP Servers Auto-Configuration

During pnpm install, 13 MCP servers are automatically configured for Claude Code integration. This happens via a postinstall script that runs claude mcp add commands.

โœ… Auto-configured (11 servers):

crafted-context, crafted-cli, rules-validator, architecture-guard, typescript, vitest, filesystem, github, sequential-thinking, shadcn, chrome-devtools

โš™๏ธ Requires manual setup (2 servers):

  • git - Needs git init + first commit
  • supabase - Needs credentials in .env.local

๐Ÿ“– See the included MCP-SETUP.md file in your template for detailed setup instructions.

4. Environment Setup

Copy the example environment file and configure your variables:

cp apps/web/.env.example apps/web/.env.local

Key environment variables you need to set:

  • DATABASE_URL - Your PostgreSQL connection string (Supabase)
  • NEXT_PUBLIC_SUPABASE_URL - Supabase project URL
  • NEXT_PUBLIC_SUPABASE_ANON_KEY - Supabase anonymous key
  • STRIPE_SECRET_KEY - Stripe secret key (for payments)
  • NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY - Stripe publishable key
  • RESEND_API_KEY - Resend API key (for emails)

5. Database Setup

# Generate Prisma client
pnpm db:generate
# Push schema to database
pnpm db:push
# (Optional) Seed database with sample data
pnpm db:seed

6. Start Development Server

# Start all apps in development mode
pnpm dev
# Or start specific app
pnpm dev --filter=web

Your app will be running at http://localhost:3000

Project Structure

Your Craft project has the following structure:

my-saas/
โ”œโ”€โ”€ apps/
โ”‚   โ””โ”€โ”€ web/              # Next.js application
โ”‚       โ”œโ”€โ”€ src/
โ”‚       โ”‚   โ”œโ”€โ”€ app/      # App Router pages
โ”‚       โ”‚   โ””โ”€โ”€ trpc/     # tRPC client setup
โ”‚       โ””โ”€โ”€ package.json
โ”œโ”€โ”€ packages/
โ”‚   โ”œโ”€โ”€ api/              # tRPC routers
โ”‚   โ”œโ”€โ”€ database/         # Prisma schema & client
โ”‚   โ”œโ”€โ”€ ui/               # Shared UI components
โ”‚   โ””โ”€โ”€ validators/       # Zod schemas
โ”œโ”€โ”€ .claude/
โ”‚   โ”œโ”€โ”€ agents/           # 8 AI agents
โ”‚   โ”œโ”€โ”€ skills/           # 10 Official Skills
โ”‚   โ””โ”€โ”€ mcp-servers/      # 14 MCP servers
โ”œโ”€โ”€ package.json
โ””โ”€โ”€ turbo.json            # Turborepo config

7. Start Building with Claude Code ๐Ÿค–

This is where the magic happens! Open Claude Code and start shipping features instantly.

โœจ Your AI-Powered Development Workflow

Open Claude Code in your project directory:

$ claude-code .

Then type /features to see all available AI Skills!

๐Ÿ’ก

Pro Tip: Just Describe What You Want!

Instead of coding manually, describe your feature in plain English. Claude will generate production-ready code that matches your quality level, with tests and validation.

Example prompts to try:

"Add user profile management with avatar upload"

"Create a blog with categories, tags, and comments"

"Build a subscription plan selector with Stripe checkout"

โœจ Included AI Skills (16 Total):

Level Skills (3)
  • โ€ข
    /rapidShip fast mode (MVP validation)
  • โ€ข
    /balancedPragmatic quality (startups)
  • โ€ข
    /craftedEnterprise-grade (scale)
Workflow Skills (4)
  • โ€ข
    /featureAdd new feature
  • โ€ข
    /bugfixFix bugs
  • โ€ข
    /refactorImprove code
  • โ€ข
    /securitySecurity audit
Agent Skills (6)
  • โ€ข
    /architectDesign architecture
  • โ€ข
    /developerGenerate code
  • โ€ข
    /testerWrite tests
  • โ€ข
    + 3 more agents...
Utility Skills (3)
  • โ€ข
    /validateQuality check
  • โ€ข
    /guardArchitecture guard
  • โ€ข
    /coverageTest coverage

๐Ÿ’ก How to use: Type /features "your feature description" in Claude Code. The orchestrator will automatically call the agent skills in the right order (architect โ†’ developer โ†’ tester โ†’ reviewer).

๐Ÿš€ Example: Build a Feature in 2 Minutes

Command:

/features "Add subscription management with upgrade/downgrade flows"

๐ŸŽฏ Detected: Balanced level (auto)

๐Ÿ—๏ธ architect: Designing 3-layer architecture...

๐Ÿ‘จโ€๐Ÿ’ป developer: Router + Service + Repository...

๐Ÿงช tester: Unit + integration tests (73%)...

โœ… validator: SOLID โœ… | guard: Architecture โœ…

โœ… Production-ready in 2m 14s!

5 files created, 18 tests passing, architecture validated. Ready to deploy!

Learn more in the AI Skills documentation โ†’

Next Steps

๐Ÿ’ก Pro Tip

Start with the Rapid quality level to validate your idea quickly. You can seamlessly upgrade to Balanced or Crafted as your product grows.

๐Ÿ“ง Need Help?

Email us at contact@getcraft.dev and we'll help you get set up.