Fr3k MAD - Master AI Development Suite

Complete ecosystem for autonomous AI-powered development

🚀 Quick Start

npx fr3k-mad

That's it! Interactive installer will guide you through everything.

📦 What's Included

🎯 Project Templates

1. Next.js App - Modern Next.js 14+ with TypeScript, Tailwind CSS, Prisma
2. SaaS Platform - Complete SaaS with Authentication, Billing, Multi-tenancy
3. RAG System - Retrieval-Augmented Generation with ChromaDB + FastAPI
4. Desktop App - Cross-platform Tauri application (Rust + React)
5. Chrome Extension - Manifest V3 extension with React + TypeScript

🛠️ MCP Tools (14 total)

• Database Operations - SQL queries, migrations, seeding
• File System Tools - Create, read, update, delete files
• Project Scaffolding - Generate components, APIs, routes
• Code Validation - Lint, type-check, test
• Build Optimization - Bundle analysis, performance
• Deployment Checks - Pre-deployment validation

🤖 AI Agent System

• Custom agents for different development tasks
• Slash commands for CLI interactions
• Pre-configured hooks and workflows
• Validation gates for code quality

💻 Installation Modes

Full Install (Recommended)

npx fr3k-mad
# Choose: "Quick Start - Install Everything"
# Enter your project name
# All templates + MCP tools installed

Custom Install

npx fr3k-mad
# Choose: "Choose Templates to Install"
# Select specific templates you need
# Install only what you want

MCP Only

npx fr3k-mad
# Choose: "Install MCP Tools Only"
# Get just the MCP server and tools

📚 Documentation

View Docs

npx fr3k-mad --help
# or
npx fr3k-mad
# Choose: "View Documentation & Walkthrough"

Configuration Guide

npx fr3k-mad
# Choose: "Configuration Guide"

🎯 Use Cases

1. Build a SaaS Product

npx fr3k-mad
# Select: SaaS Platform template
# Get: Auth + Billing + Multi-tenancy + Deployment

Includes:

• NextAuth.js authentication
• Stripe billing integration
• Multi-tenant database schema
• Email system
• Admin dashboard
• API routes
• Webhook handling

2. Create AI-Powered App

npx fr3k-mad
# Select: RAG System template
# Get: ChromaDB + FastAPI + Chat UI

Includes:

• Vector database (ChromaDB)
• Document processing
• Embedding generation
• Chat interface
• Query system

3. Build Desktop Software

npx fr3k-mad
# Select: Desktop App template
# Get: Tauri + React + Rust backend

Includes:

• Cross-platform support (Mac, Linux, Windows)
• Native performance
• IPC communication
• System integration

4. Develop Chrome Extension

npx fr3k-mad
# Select: Chrome Extension template
# Get: Manifest V3 + React + TypeScript

Includes:

• Modern Manifest V3
• Background service worker
• Content scripts
• Popup UI
• Chrome APIs

🔧 Technology Stack

| Template | Frontend | Backend | Database | Tools | |----------|----------|---------|----------|-------| | Next.js | React, Next.js 14+ | Next.js API Routes | Prisma + PostgreSQL | TypeScript, Tailwind | | SaaS | React, Next.js 14+ | Next.js API Routes | Prisma + PostgreSQL | NextAuth, Stripe | | RAG | React, Next.js | FastAPI (Python) | ChromaDB (Vector) | OpenAI, LangChain | | Tauri | React | Rust | - | Vite, Cargo | | Chrome | React | - | Chrome Storage | Vite, Manifest V3 |

📁 Project Structure

After installation:

my-fr3k-project/
├── fr3k-nextjs/          # Next.js template
│   ├── src/
│   ├── prisma/
│   ├── CLAUDE.md         # AI agent instructions
│   └── package.json
├── fr3k-saas/            # SaaS template
│   ├── app/
│   ├── auth.ts
│   ├── prisma/
│   └── package.json
├── fr3k-rag/             # RAG template
│   ├── backend/          # FastAPI
│   └── frontend/         # Next.js
├── fr3k-tauri/           # Desktop template
│   ├── src-tauri/        # Rust
│   └── src/              # React
└── fr3k-chrome/          # Extension template
    ├── manifest.json
    ├── src/
    └── popup.html

🚀 Getting Started

1. Install

npx fr3k-mad

2. Choose Template

Select from interactive menu or install all

3. Navigate to Project

cd my-fr3k-project

4. Install Dependencies

# For Next.js/SaaS
cd fr3k-nextjs
npm install

# For RAG
cd fr3k-rag
pip install -r backend/requirements.txt
cd frontend && npm install

# For Tauri
cd fr3k-tauri
npm install

# For Chrome Extension
cd fr3k-chrome
npm install

5. Start Development

# Next.js/SaaS
npm run dev

# RAG backend
cd backend && uvicorn main:app --reload

# RAG frontend
cd frontend && npm run dev

# Tauri
npm run tauri dev

# Chrome Extension
npm run dev

⚙️ Configuration

Environment Variables

Create .env file in your project:

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/dbname"

# Authentication (SaaS)
NEXTAUTH_URL="http://localhost:3000"
NEXTAUTH_SECRET="your-secret-here"
GOOGLE_CLIENT_ID="your-google-client-id"
GOOGLE_CLIENT_SECRET="your-google-client-secret"

# Stripe (SaaS)
STRIPE_SECRET_KEY="sk_test_..."
STRIPE_WEBHOOK_SECRET="whsec_..."
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY="pk_test_..."

# OpenAI (RAG)
OPENAI_API_KEY="sk-..."

# Email
SMTP_HOST="smtp.gmail.com"
SMTP_PORT="587"
SMTP_USER="[email protected]"
SMTP_PASSWORD="your-app-password"

Claude Code MCP

Fr3k MAD automatically configures Claude Code MCP.

Manual configuration in ~/.config/claude-code/settings.json:

{
  "mcpServers": {
    "fr3k-mcp": {
      "command": "fr3k-mcp"
    }
  }
}

🎨 Features

✨ Next.js Template

• App Router architecture
• Server Components
• API Routes
• Prisma ORM
• TypeScript
• Tailwind CSS
• ESLint + Prettier
• Testing setup (Vitest)

💼 SaaS Template

Everything in Next.js template, plus:

• NextAuth.js authentication
• Stripe subscription billing
• Multi-tenant database
• User roles & permissions
• Email notifications
• Admin dashboard
• Webhook handlers
• Deployment configs

🧠 RAG Template

• FastAPI backend
• ChromaDB vector database
• Document processing
• Embedding generation
• Similarity search
• Chat interface
• Next.js frontend
• OpenAI integration

🖥️ Tauri Template

• Rust backend
• React frontend
• IPC communication
• Native file system access
• Cross-platform builds
• Auto-updates
• System tray

🔌 Chrome Extension Template

• Manifest V3
• Service worker background
• Content scripts
• Popup UI
• Chrome Storage API
• TypeScript support
• Hot reload dev mode

🛠️ MCP Tools Reference

Database Tools

• database-query - Execute SQL queries
• database-migrate - Run migrations
• database-seed - Seed test data

File Tools

• file-create - Create new files
• file-read - Read file contents
• file-update - Update existing files
• file-delete - Delete files

Project Tools

• project-scaffold - Create project structure
• component-create - Generate React components
• api-create - Generate API routes

Utility Tools

• validate-code - Run linting and type checking
• test-run - Execute tests
• build-optimize - Optimize production builds
• deploy-check - Pre-deployment validation

📖 Examples

Create Next.js Blog

npx fr3k-mad
# Select: Next.js App
cd my-project/fr3k-nextjs
npm install
# Use MCP tools to generate blog components
# Use AI agents to build features
npm run dev

Launch a SaaS

npx fr3k-mad
# Select: SaaS Platform
cd my-saas/fr3k-saas
npm install
# Configure Stripe keys
# Setup database
npm run dev

Build RAG Chatbot

npx fr3k-mad
# Select: RAG System
cd my-rag/fr3k-rag
pip install -r backend/requirements.txt
cd frontend && npm install
# Add documents to ChromaDB
# Start both servers

🤝 Contributing

Fr3k MAD is built on top of excellent work by the open-source community.

Original inspiration from:

• Queen Claude ecosystem by Ken Kai
• MCP protocol by Anthropic
• Next.js by Vercel
• Tauri by Tauri Apps

📄 License

MIT License

🔗 Links

• npm package
• GitHub
• Documentation
• Issues

💬 Support

• GitHub Issues: Report bugs
• GitHub Discussions: Ask questions

🎯 Roadmap

• [ ] Python templates (Django, FastAPI standalone)
• [ ] Vue.js templates
• [ ] Mobile app templates (React Native)
• [ ] Microservices templates
• [ ] E-commerce templates
• [ ] More MCP tools
• [ ] VS Code extension
• [ ] Web-based configurator

Built with ❤️ by the Fr3k community

Master AI Development - Made Simple