MakerKit Template Guide

Commercial License Required

MakerKit requires a commercial license. While Orchestre can help you build with it, you must obtain a valid license from MakerKit for commercial use.

A comprehensive guide to using the MakerKit Next.js template with Orchestre.

Overview

The makerkit-nextjs template is a production-ready SaaS starter kit that includes:

• Multi-tenant architecture with teams
• Subscription billing with Stripe
• Authentication and authorization
• Admin dashboard
• Email system
• Analytics integration

Getting Started

Initialize a New Project

# Using the official MakerKit template
/orchestre:create (MCP) "my-saas" using makerkit-nextjs

# Using a custom MakerKit repository
/orchestre:create (MCP) https://github.com/makerkit/next-supabase-saas-kit-turbo my-saas

What You Get

When you initialize a MakerKit project, Orchestre provides:

• Pre-configured project structure
• .orchestre/prompts.json with SaaS-specific commands
• CLAUDE.md files for distributed memory
• Template-aware prompts that understand MakerKit conventions

Building Your SaaS

1. Team Collaboration Features

Transform your SaaS into a collaborative platform:

# Add real-time capabilities
/orchestre:execute-task (MCP) "Add real-time messaging with WebSockets"

# Build team features
/orchestre:execute-task (MCP) "Implement channel management with permissions"
/orchestre:execute-task (MCP) "Add file sharing with team access controls"

2. Project Management Features

Build comprehensive project management:

# Core project features
/orchestre:execute-task (MCP) "Create Kanban board with drag-and-drop"
/orchestre:execute-task (MCP) "Add Gantt chart visualization"
/orchestre:execute-task (MCP) "Implement time tracking module"

# Billing integration
/orchestre:execute-task (MCP) "Set up usage-based billing for projects"

3. Customer Support System

Create a help desk platform:

# Support infrastructure
/orchestre:execute-task (MCP) "Build ticket management system"
/orchestre:execute-task (MCP) "Create knowledge base with search"
/orchestre:execute-task (MCP) "Add agent roles and permissions"

Common Patterns

Authentication Setup

# Configure OAuth providers
/setup-oauth "Add Google and GitHub authentication"

# Add MFA
/setup-mfa "Enable two-factor authentication"

Billing Integration

# Set up Stripe
/setup-stripe "Configure subscription plans"

# Add usage tracking
/add-feature "Usage metering for API calls"

Team Features

# Multi-tenancy
/add-team-feature "Team member invitations"
/orchestre:migrate-to-teams (MCP) "Convert single-tenant to multi-tenant"

Working with MakerKit

Using Orchestre Commands

With Orchestre v5, commands are provided as MCP prompts, not files. When you initialize a MakerKit project, you get:

1. Core Orchestre Commands - Available for all projects:

   • /orchestre:create - Initialize new projects
   • /orchestre:orchestrate - Analyze and plan features
   • /orchestre:execute-task - Execute development tasks
   • /orchestre:review - Multi-LLM code review

2. Template Context - MakerKit-specific understanding:

   • Orchestre prompts understand MakerKit's structure
   • Commands adapt to MakerKit conventions
   • Intelligent suggestions based on SaaS patterns

Development Workflow

# 1. Plan your feature
/orchestre:orchestrate (MCP) "Add customer onboarding flow"

# 2. Execute the implementation
/orchestre:execute-task (MCP) "Implement the onboarding steps"

# 3. Review the code
/orchestre:review (MCP) "Review onboarding implementation"

Best Practices

1. Start with Core Features

# Begin with authentication
/setup-oauth "Configure authentication"

# Then add billing
/setup-stripe "Set up subscription billing"

# Finally, build features
/add-feature "User dashboard"

2. Understanding MakerKit Structure

MakerKit follows a specific structure that Orchestre understands:

• src/features/ - Feature-based organization
• src/lib/ - Shared utilities
• src/server/ - Server-side code
• src/components/ - Reusable UI components
• supabase/ - Database migrations and functions

Orchestre adds:

• CLAUDE.md files - Distributed memory system
• .orchestre/ - Orchestration configuration and state

3. Leverage Built-in Components

• Form components with validation
• Data tables with sorting/filtering
• Modal and drawer systems
• Toast notifications

Template Features

Built-in Capabilities

The MakerKit template provides:

• Authentication: Supabase Auth with magic links, OAuth
• Billing: Stripe integration with subscription management
• Teams: Multi-tenant architecture with invitations
• Admin: Admin panel for user and subscription management
• UI Components: Shadcn/ui components pre-configured
• Email: React Email templates with Resend
• Analytics: PostHog integration
• SEO: Next.js SEO optimizations

Technology Stack

• Framework: Next.js 14 with App Router
• Database: Supabase (PostgreSQL)
• Styling: Tailwind CSS
• Type Safety: TypeScript
• Testing: Playwright
• Deployment: Vercel-optimized

Resources

• MakerKit Documentation
• Official MakerKit Repository
• Orchestre Documentation

See Also

• Orchestre Templates Overview
• Quick Start Guide
• All Templates