Dawson Does Framework

Ship production-ready apps faster with AI-native templates and one-command deployments.

Transform ideas into deployed applications in minutes, not days. The Dawson Does Framework combines production-ready templates, powerful integrations, and intelligent automation to accelerate your development workflow.

Quick Start

# Install globally
npm install -g @jrdaws/framework

# Create a new SaaS app
framework export saas ./my-app --auth supabase --payments stripe

# Start developing
cd my-app && npm install && npm run dev

# Deploy to production
framework deploy --prod

That's it. You now have a production-ready SaaS application with authentication, payments, and database - deployed and live.

Key Features

🎯 Production Templates

Choose from battle-tested templates built for real applications:

• SaaS Starter - Full-stack with auth, billing, database, and AI
• Dashboard - Admin panel with data tables, charts, and user management
• Landing Page - High-converting marketing pages with analytics
• Blog - Content-focused sites with SEO and RSS
• SEO Directory - Optimized directory sites with search and filtering

framework templates list           # Browse all templates
framework templates search "blog"  # Find templates
framework export saas ./my-app     # Create from template

View all templates →

🔌 Powerful Integrations

Compose your stack with 7 integration categories and 15+ providers:

| Category | Providers | Purpose | |----------|-----------|---------| | Auth | Supabase, Clerk | User authentication & sessions | | Payments | Stripe, Paddle | Subscriptions & billing | | Database | Supabase, PlanetScale | Data storage & queries | | Email | Resend, SendGrid | Transactional emails | | AI | OpenAI, Anthropic | GPT-4, Claude integration | | Analytics | PostHog, Plausible | User tracking & insights | | Storage | Supabase, S3, Cloudinary | File & asset storage |

# Add integrations during export
framework export saas ./my-app \
  --auth supabase \
  --payments stripe \
  --email resend \
  --ai anthropic

# Or pull from web configurator
framework pull <token> --cursor

Integration guides →

🚀 One-Command Deploy

Deploy to Vercel, Netlify, or Railway with automatic detection:

framework deploy          # Auto-detect and deploy
framework deploy --prod   # Deploy to production

The framework automatically:

• Detects your deployment provider
• Validates credentials securely
• Streams real-time build logs
• Returns your live URL

Deployment guide →

🧩 Extensible Plugin System

Hook into any lifecycle event to customize behavior:

// my-plugin.mjs
export default {
  name: "my-plugin",
  version: "1.0.0",
  hooks: {
    "post:export": async (context) => {
      console.log(`✅ Created ${context.projectName}`);
      return { success: true };
    }
  }
};

framework plugin add ./my-plugin.mjs
framework export saas ./my-app  # Plugin runs automatically

Plugin API →

🤖 AI-Native Development

Built for AI-assisted development with Cursor, Claude, and other AI coding tools:

# Generate .cursorrules and context files
framework pull <token> --cursor

# AI agent safety with checkpoints
framework checkpoint create "before major refactor"
framework checkpoint restore <id>  # Rollback if needed

# Drift detection
framework drift  # See changes from template

AI features →

Installation

Global Install (Recommended)

npm install -g @jrdaws/framework
framework version

One-Time Use

npx @jrdaws/framework export saas ./my-app

Requirements

• Node.js 18+
• npm or yarn
• Git (for repository initialization)

Documentation

Getting Started

• Installation
• Your First Project
• Project Structure

CLI Reference

• Commands Overview
• framework export - Create projects from templates
• framework pull - Pull from web configurator
• framework deploy - Deploy to production
• framework templates - Browse templates
• framework plugin - Manage plugins

Guides

• Templates - Explore all templates
• Integrations - Setup guides for all providers
• Deployment - Deploy to Vercel, Netlify, Railway
• Plugins - Extend the framework
• Template Registry - Create & publish templates

Advanced

• Core Concepts
• Architecture
• AI Governance
• Framework Map

Examples

Create a SaaS App

# Full-stack SaaS with all features
framework export saas ./my-saas \
  --auth supabase \
  --payments stripe \
  --email resend \
  --ai anthropic \
  --analytics posthog

cd my-saas
npm install
npm run dev

Create a Blog

# Content-focused blog
framework export blog ./my-blog

cd my-blog
npm install
npm run dev

Pull from Web Configurator

# Configure at https://dawson.dev, get token
framework pull abc123xyz --cursor --open

Deploy to Production

# Setup credentials (one-time)
framework deploy:auth save vercel YOUR_TOKEN

# Deploy
cd my-app
framework deploy --prod

Why Dawson Does Framework?

1. Speed

Go from idea to deployed app in minutes, not days. Pre-configured templates eliminate boilerplate setup.

2. Quality

Battle-tested templates with best practices baked in: TypeScript, ESLint, proper error handling, security patterns.

3. Flexibility

Mix and match integrations. Swap Supabase for Clerk. Use Stripe or Paddle. OpenAI or Anthropic. Your stack, your choice.

4. AI-First

Built for AI-assisted development. Cursor integration, agent safety, drift detection, and recovery guidance.

5. Production-Ready

Not toy examples. Real templates with auth, billing, databases, email, AI - everything you need to launch.

Ecosystem

• CLI - Command-line tool (this repository)
• Web Configurator - Visual project builder at dawson.dev
• Template Registry - Discover and publish templates
• Plugin Marketplace - Coming soon

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development

# Clone repository
git clone https://github.com/jrdaws/framework.git
cd framework

# Install dependencies
npm install

# Run tests
npm test

# Test CLI locally
npm link
framework version

Creating Templates

Templates are stored in /templates. See Template Registry for the creation guide.

Support

• Documentation: docs/
• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Updates: Follow @jrdaws on Twitter

Roadmap

• [ ] Additional templates (e-commerce, mobile app, Chrome extension)
• [ ] More integration providers
• [ ] Plugin marketplace
• [ ] Visual project configurator enhancements
• [ ] Team collaboration features
• [ ] Custom domain management
• [ ] Deployment analytics

See ROADMAP.md for details.

License

MIT © Joseph Dawson

See LICENSE for details.

Acknowledgments

Built with:

• Next.js - React framework
• Supabase - Backend as a service
• Stripe - Payment processing
• Vercel - Deployment platform
• Anthropic - AI models

Special thanks to the open source community.

Ready to ship?

npm install -g @jrdaws/framework
framework export saas ./my-app
cd my-app && npm install && npm run dev

Get Started → | View Templates → | Deploy Guide →