Metadata-Version: 2.4
Name: saasforge
Version: 0.8.2
Summary: Spec-Driven Micro-SaaS Development Toolkit
Author-email: Fahad Khakwani <fahadyousufkhakwani@gmail.com>
License: SaaSForge Commercial License
Project-URL: Homepage, https://github.com/Fahad-FullStackDeveloper/saasforge
Project-URL: Repository, https://github.com/Fahad-FullStackDeveloper/saasforge
Project-URL: Bug Tracker, https://github.com/Fahad-FullStackDeveloper/saasforge/issues
Keywords: micro-saas,scaffold,spec-driven,cli,saas,generator,template
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE.md
Requires-Dist: typer>=0.12
Requires-Dist: rich>=13
Requires-Dist: jinja2>=3
Dynamic: license-file

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Fahad-FullStackDeveloper/saasforge/main/saasforge/logo.svg">
  <img src="https://raw.githubusercontent.com/Fahad-FullStackDeveloper/saasforge/main/saasforge/logo.svg" alt="SaaSForge Logo" width="200">
</picture>

# SaaSForge

**The #1 Spec-Driven Micro-SaaS Development Toolkit.**  
Build 450+ isolated Micro-SaaS tools from a single DNA document.  
Works with every major AI CLI. Deploy to Vercel + Hugging Face Spaces.

## 📦 Installation

**Supported OS:** Windows, Linux, macOS

```bash
# Install
pip install saasforge

# Verify
saasforge --version
sp --version
```

> 🆕 **24-hour free trial available** — try SaaSForge with 8 top adapters. No credit card required.
> ```bash
> saasforge trial
> ```
> [**Buy a license →**](https://saasforge.dev/pricing) for all 25 adapters and lifetime access.
>
> 📖 See [**GUIDE.md**](GUIDE.md) for a complete walkthrough of all commands, adapters, and products.

Both `saasforge` and `sp` aliases work — same CLI, shorter name.

```bash
$ saasforge --version
saasforge v0.8.2
$ sp --version
saasforge v0.8.2
```

[![PyPI](https://img.shields.io/pypi/v/saasforge)](https://pypi.org/project/saasforge/)
[![Downloads](https://img.shields.io/pypi/dm/saasforge)](https://pypi.org/project/saasforge/)
[![Tests](https://github.com/Fahad-FullStackDeveloper/saasforge/actions/workflows/publish.yml/badge.svg)](https://github.com/Fahad-FullStackDeveloper/saasforge/actions)
[![Python](https://img.shields.io/pypi/pyversions/saasforge)](https://pypi.org/project/saasforge/)
[![License](https://img.shields.io/badge/license-Commercial%20%2B%20MIT%20credit-blue)](LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/Fahad-FullStackDeveloper/saasforge?style=social)](https://github.com/Fahad-FullStackDeveloper/saasforge)

---

## 📖 Table of Contents

- [🤔 What is SaaSForge?](#-what-is-saasforge)
- [💳 Licensing Model](#-licensing-model)
- [💰 Token Savings](#-token-savings)
- [🏆 Top 10 Reasons to Use SaaSForge](#-top-10-reasons-to-use-saasforge)
- [🛠️ What Can You Build With SaaSForge?](#️-what-can-you-build-with-saasforge)
- [⚡ Quick Start](#-quick-start)
- [📋 Full Workflow](#-full-workflow)
- [🤖 Supported AI CLIs (25)](#-supported-ai-clis-25)
- [📟 Commands Reference](#-commands-reference)
- [🔬 SaaSForge vs SpecifyPlus](#-saasforge-vs-specifyplus)
- [🏗️ Architecture](#️-architecture)
- [🎯 Use Cases](#-use-cases)
- [📄 License](#-license)

---

## 🤔 What is SaaSForge?

SaaSForge ek **Spec-Driven Micro-SaaS Development Toolkit** hai. Iska matlab:

**Pehle Spec, Phir Code.**  
Aap pehle batate hain *kya banana hai* (DNA.md), phir AI us hisaab se implement karta hai. Code random nahi balke plan karke banta hai.

**Ek DNA, 450 Tools.**  
Aap ek baar architecture decide karo (Frontend: Next.js, Backend: FastAPI, DB: Turso, Auth: Better Auth). SaaSForge automatically us architecture ke hisaab se har naya tool generate karta hai — Dockerfile, backend, frontend, deploy config sab kuch.

**Kisi bhi AI CLI ke saath kaam karta hai.**  
25+ AI CLIs support hain — opencode, Claude Code, Gemini, Copilot, Cursor, Windsurf, Aider, KiloCode, etc. Agar aapke paas koi AI CLI nahi bhi hai to `--ai terminal` use karo, SaaSForge simple config files generate karega jo koi bhi LLM follow kar sakta hai.

**History + Memory.**  
Har command log hoti hai. Project ka constitution (decisions, conventions, stack) auto-save hota hai. AI CLI har session ki shuru mein constitution read karta hai — is liye continuity kabhi nahi tooti.

---

## 💳 Licensing Model

| Feature | Trial | Paid |
|---------|-------|-------|
| **Duration** | 24 hours | Lifetime |
| **Price** | Free | One-time purchase |
| **AI CLI Adapters** | 8 (top) | All 25 |
| **Product Templates** | 4 (samples) | All 25+ |
| **OS Support** | Win/Linux/macOS | Win/Linux/macOS |
| **Machine Binding** | ✅ Fingerprint | ✅ Fingerprint |
| **Trial Warnings** | ✅ <6h / <15min | — |
| **`check` Command** | ✅ Free | ✅ Free |
| **Lemon Squeezy Activation** | ❌ | ✅ Online |
| **HMAC Offline Fallback** | ❌ | ✅ 48h grace |
| **Priority Support** | ❌ | ✅ |

**Start trial:** `saasforge trial` — 24h, no credit card.  
**Buy license:** https://saasforge.dev/pricing  
**Register:** `saasforge register LIC-XXXXX`

---

## 💰 Token Savings — SaaSForge Ka Sabse Bada Feature!

SaaSForge sirf tools nahi banata — **AI ka budget bhi bachata hai.** Har feature token consumption reduce karne ke liye design kiya gaya hai.

### Per-Session Saving: Constitution System

| Bina SaaSForge | SaaSForge Ke Sath |
|----------------|-------------------|
| Har session mein project context dohrao: "Frontend Next.js + Tailwind + Shadcn → Vercel, Backend Python FastAPI → Hugging Face Spaces, Database Turso SQLite, Auth Better Auth, Storage Cloudflare R2..." | Constitution auto-load hota hai. AI pichle session se sab yaad rakhta hai |
| **~2,000–4,000 tokens** har session waste | **~0 tokens** — constitution ek baar load, baar baar use |

### Per-Command Saving: Slash Commands

| Prompt | Tokens | SaaSForge Equivalent | Tokens |
|--------|--------|---------------------|--------|
| *"Build a WhatsApp bot using Twilio + FastAPI + Turso. It should read incoming messages, auto-reply, store chat history..."* | ~500 | `/sp.specify WhatsApp auto-reply bot` | **~15** |
| *"Create a detailed implementation plan with architecture diagram, file structure, API routes..."* | ~400 | `/sp.plan` | **~8** |
| *"Break down the implementation into small, testable tasks with acceptance criteria..."* | ~350 | `/sp.tasks` | **~8** |

**Savings per command: 95–98% fewer tokens.**

### Per-Scaffold Saving: DNA-Aware Generation

| Bina SaaSForge | SaaSForge Ke Sath |
|----------------|-------------------|
| Har baar tech stack explain karo: Dockerfile config, HF Spaces port (7860), Vercel rewrites, requirements.txt | `saasforge scaffold --dna _system/DNA.md` — stack already defined |
| **~500–800 tokens** per scaffold waste | **~0 tokens** — DNA se auto-pick |

### Real-World Math: Ek Tool Complete Karne Par

```
Scenario: 50 AI sessions, 100 command invocations, 10 scaffolds, 5 deploys

Sessions:     50 × 3,000 tokens      = 150,000 tokens saved
Commands:   100 × 300 tokens          =  30,000 tokens saved
Scaffolds:   10 × 500 tokens          =   5,000 tokens saved
Deploys:      5 × 200 tokens          =   1,000 tokens saved
────────────────────────────────────────────────────────
Total:                              = 186,000 tokens per tool
```

### 450 Tools Ka Project → Token Saving Ka Scale

| Metric | Value |
|--------|-------|
| Tools in project | 450 |
| Tokens saved per tool | ~186,000 |
| **Total tokens saved** | **~83,700,000** |
| Claude Opus cost (@$15/M tokens) | **$1,255 saved** |
| GPT-4o cost (@$10/M tokens) | **$837 saved** |

> SaaSForge token-saving features (constitution, slash commands, DNA, history) har session, har command, aur har scaffold par **95% token reduction** dete hain. SpecifyPlus ke paas constitution hai lekin slash commands, DNA-aware scaffolding, aur deploy checklist nahi — is liye SaaSForge token-saving mein bhi #1 hai.

---

## 🏆 Top 10 Reasons to Use SaaSForge

| # | Reason | Why It Matters |
|---|--------|----------------|
| 1 | **DNA-Aware Scaffolding** | Har tool apke exact tech stack ke hisaab se generate hota hai. No copy-paste, no manual setup |
| 2 | **25 AI CLI Adapters** | Duniya ka har AI CLI support karta hai — SpecifyPlus sirf 18. Hum 25 ke saath #1 hain |
| 3 | **Zero Vendor Lock-in** | `--ai terminal` mode — kisi AI CLI ki zaroorat nahi. Saaf config files jo koi bhi LLM samajh sakta hai |
| 4 | **Constitution + History** | AI kabhi nahi bhoolta project conventions. Har command track hoti hai. Debugging aasaan |
| 5 | **Built-in Deploy Checklist** | Vercel + Hugging Face Spaces ke liye 7-point checklist. Production-ready deployment |
| 6 | **DNA Validation** | `saasforge dna --validate` — missing configs detect karta hai. SpecifyPlus mein nahi hai |
| 7 | **Idempotent Init** | `saasforge init` do baar chalao — same result. Koi duplication nahi, koi overwrite nahi |
| 8 | **Safe Scaffold** | `--force` flag explicit hai. Bina flag ke old tool overwrite nahi hota |
| 9 | **Parser FLEX** | Case-insensitive, spaces-before-colon, aliases (DB→database, File Storage→storage). SpecifyPlus exact match maangta hai |
| 10 | **450-Tool Architecture** | Har tool isolated: alag Vercel project, alag HF Space, alag DB, alag R2 bucket. Zero shared infra |

---

## 🛠️ What Can You Build With SaaSForge?

SaaSForge kisi bhi Micro-SaaS idea ko tool mein badal sakta hai. Har tool independently deploy hota hai — apna Vercel project, apna Hugging Face Space, apni Turso database, apna R2 bucket.

### 1. AI-Powered Tools
- **Smart Invoice OCR** — PDF/image upload → OCR → structured data → database
- **AI Blog Writer** — Topic → AI → blog post → publish
- **Chat with PDF** — Upload PDF → RAG → Q&A interface
- **AI Image Generator** — Prompt → Gemini/Stable Diffusion → gallery

### 2. Business Automation Tools
- **WhatsApp Bot** — Twilio + FastAPI + Turso → automated responses
- **Invoice Generator** — Template + data → PDF → email
- **Meeting Scheduler** — Calendar integration → booking → reminders
- **Form Builder** — Drag-drop → API endpoint → submissions dashboard

### 3. Data Tools
- **CSV Analyzer** — Upload → AI analysis → charts + insights
- **Web Scraper** — URL → HTML → AI extraction → structured data
- **Translation Hub** — Text → Gemini translation → multiple languages
- **Data Dashboard** — DB → REST API → charts + filters

### 4. Developer Tools
- **API Playground** — Endpoint → test → results → share
- **JSON Formatter** — Input → validate → format → download
- **Regex Builder** — Pattern → test → explain → save
- **Cron Job Manager** — Schedule → task → logs → alerts

### 5. E-commerce / Payment Tools
- **Pricing Page Builder** — Tiers → calculator → checkout
- **Subscription Manager** — Users → plans → billing → invoices
- **Coupon Generator** — Rules → codes → validation → analytics

### How Deployment Works (Each Tool)

```
Tool 001 → Vercel (Next.js FE) + HF Space (FastAPI BE) + Turso DB + R2 Storage
Tool 002 → Vercel (Next.js FE) + HF Space (FastAPI BE) + Turso DB + R2 Storage
...
Tool 450 → Vercel (Next.js FE) + HF Space (FastAPI BE) + Turso DB + R2 Storage
```

Har tool completely isolated. Ek tool down ho jaye to baqi 449 unaffected.

---

## ⚡ Quick Start

```bash
# 1. Start free trial (24h, 8 adapters)
saasforge trial

# 2. Check your environment
saasforge check

# 3. Initialize with any AI CLI
saasforge init my-micro-saas --ai opencode

# 4. Enter the project
cd my-micro-saas

# 5. Load project memory into your AI CLI
saasforge constitute --show

# 6. Generate workflow commands
saasforge workflow --ai opencode

# 7. View command history
saasforge history
```

Or register a paid license:

```bash
saasforge register LIC-XXXXX     # All 25 adapters, lifetime
```

Under 30 seconds, ready to build.

---

## 📋 Full Workflow

### Step 1: Define Your DNA

Ek file sab kuch control karti hai. `_system/DNA.md` mein apna architecture likho:

```markdown
FRONTEND:     Next.js + Tailwind + Shadcn → Vercel
BACKEND:      Python FastAPI → Hugging Face Spaces
DATABASE:     Turso SQLite
AUTH:         Better Auth
FILE STORAGE: Cloudflare R2
DEPLOYMENT:   Vercel (FE) + HF Spaces (BE) + Turso (DB)
```

SaaSForge ka parser itna flexible hai:

```markdown
FrontEnd : nextjs      ✓  (case-insensitive)
DB : postgres           ✓  (alias — DB = database)
File Storage : R2      ✓  (spaces before colon)
deploy: vercel + hf    ✓  (deploy = deployment)
```

Validate karo: `saasforge dna --validate`

### Step 2: Initialize Project

```bash
# Nayi directory mein
saasforge init my-tool --ai opencode

# Existing directory mein
saasforge init . --ai claude

# Bina AI CLI ke
saasforge init my-tool --ai terminal

# Chota naam bhi kaam karta hai
sp init my-tool --ai gemini
```

Kya hota hai? SaaSForge aapke AI CLI ke liye config files banata hai. Jaise `--ai opencode` se `.opencode/commands/` folder banta hai jisme `/sp.specify`, `/sp.plan`, etc. commands hain.

### Step 3: Scaffold a Tool

```bash
saasforge scaffold invoice-ocr --number 001 --dna _system/DNA.md
```

Ye kya generate karta hai?

```
_tools/
└── _001-invoice-ocr/
    ├── frontend/          ← Next.js (empty, AI bharega)
    ├── backend/
    │   ├── api/           ← FastAPI endpoints
    │   └── src/           ← Business logic
    ├── tests/
    ├── Dockerfile          ← Hugging Face Docker SDK
    ├── .dockerignore
    ├── app.py              ← FastAPI entrypoint (port 7860)
    ├── requirements.txt    ← Python deps
    └── vercel.json         ← Rewrite proxy config
```

Dobara scaffold karo to `--force` lagao — purana delete ho kar naya banta hai.

### Step 4: Track Context (Constitution)

AI CLI ko project ka context yaad rakhne ke liye:

```bash
saasforge constitute --show          # Dekho constitution
saasforge constitute --regenerate    # DNA se dubara banao
saasforge constitute --edit          # Editor mein kholo
```

Constitution `.saasforge/memory/constitution.md` mein save hota hai. AI CLI har session mein yeh file padhti hai — is liye usay project conventions yaad rehte hain.

### Step 5: Generate Workflow Commands

```bash
saasforge workflow --ai opencode
```

Ye `.opencode/commands/` mein yeh slash commands banata hai:

| Command | Kaam |
|---------|------|
| `/sp.specify` | Define what to build |
| `/sp.plan` | Create implementation plan |
| `/sp.tasks` | Break into actionable tasks |
| `/sp.implement` | Execute the plan |
| `/sp.analyze` | Cross-artifact consistency check |

In commands ko AI CLI mein directly use karo. For example:

```
/sp.specify Build a WhatsApp bot that reads incoming messages and auto-replies
```

### Step 6: Deploy

```bash
saasforge deploy ./_tools/_001-invoice-ocr
```

7-point checklist dikhta hai:

| Item | Status |
|------|--------|
| ✅ Dockerfile exists | ✓/✗ |
| ✅ .dockerignore exists | ✓/✗ |
| ✅ app.py exists | ✓/✗ |
| ✅ requirements.txt exists | ✓/✗ |
| ✅ vercel.json exists | ✓/✗ |
| ✅ frontend/ exists | ✓/✗ |
| ✅ backend/ exists | ✓/✗ |

### Step 7: Track Everything

```bash
# Pichle 50 commands dekho
saasforge history

# Sirf 10 dekho
saasforge history --limit 10

# History saaf karo
saasforge history --clear
```

Har `init`, `scaffold`, `workflow`, `deploy`, `dna`, `constitute`, `history` command automatically log hoti hai `.saasforge/memory/history.yml` mein.

---

## 🤖 Supported AI CLIs (25)

| # | CLI | Flag | Generates | SpecifyPlus? |
|---|-----|------|-----------|--------------|
| 1 | opencode | `--ai opencode` | `.opencode/commands/` | ✅ |
| 2 | Claude Code | `--ai claude` | `.claude/commands/` | ✅ |
| 3 | Gemini CLI (Deprecated) | `--ai gemini` | `.gemini/` | ✅ |
| 4 | GitHub Copilot | `--ai copilot` | `.github/instructions/` | ✅ |
| 5 | Cursor | `--ai cursor` | `.cursor/rules/` | ✅ |
| 6 | Windsurf | `--ai windsurf` | `.windsurf/` rules | ✅ |
| 7 | Roo Code | `--ai roo` | `.roo/commands/` | ✅ |
| 8 | Codex CLI | `--ai codex` | `.codex/instructions/` | ✅ |
| 9 | Qwen Code | `--ai qwen` | `.qwen/` workflow | ✅ |
| 10 | Qoder CLI | `--ai qoder` | `.qoder/commands/` | ✅ |
| 11 | Amazon Q Developer | `--ai amazonq` | `.q/commands/` | ⚠️ |
| 12 | Amp | `--ai amp` | `.amp/instructions/` | ✅ |
| 13 | Auggie CLI | `--ai auggie` | `.auggie/` workflow | ✅ |
| 14 | CodeBuddy CLI | `--ai codebuddy` | `.codebuddy/` rules | ✅ |
| 15 | IBM Bob | `--ai bob` | `.bob/` instructions | ✅ |
| 16 | Jules | `--ai jules` | `.jules/` workflow | ✅ |
| 17 | SHAI (OVHcloud) | `--ai shai` | `.shai/instructions/` | ✅ |
| 18 | Continue | `--ai continue` | `.continue/rules/` | ❌ **New** |
| 19 | Cody (Sourcegraph) | `--ai cody` | `.cody/` instructions | ❌ **New** |
| 20 | Tabby | `--ai tabby` | `.tabby/` workflow | ❌ **New** |
| 21 | Antigravity | `--ai antigravity` | `.antigravity/rules/` | ❌ **New** |
| 22 | Aider | `--ai aider` | `.aider/CONVENTIONS.md` | ❌ **New** |
| 23 | KiloCode | `--ai kilocode` | `.kilocode/instructions/` | ✅ |
| 24 | OpenRouter CLI | `--ai openroutercli` | `.openrouter/` | ❌ **New** |
| 25 | Terminal (no AI) | `--ai terminal` | `.saasforge/config.yml` | ❌ **Unique** |

**Default:** `--ai opencode` (most capable, CLI-based, actively maintained).<br>
**Compare:** SpecifyPlus = 18 adapters. SaaSForge = **25 adapters** — 7 zyada, including 6 jo SpecifyPlus mein nahi hain aur 1 (Terminal) jo completely unique hai.

### How to Use Any Adapter

Default is `--ai opencode`. Koi bhi 25 mein se choose karo:

```bash
saasforge init my-tool                    # Default: opencode
saasforge init my-tool --ai claude
saasforge init my-tool --ai cursor
saasforge init my-tool --ai continue
# ... koi bhi 25 mein se
```

---

## 📟 Commands Reference

### All Commands

| Command | Alias | Description |
|---------|-------|-------------|
| `saasforge trial` | `sp trial` | Start 24h free trial (8 adapters) |
| `saasforge register` | `sp register` | Activate license key (Lemon Squeezy / offline) |
| `saasforge license-status` | `sp license-status` | Show current license or trial status |
| `saasforge check` | `sp check` | Check installed tools (git, python, pnpm, etc.) |
| `saasforge init` | `sp init` | Initialize new project with AI CLI adapter |
| `saasforge scaffold` | `sp scaffold` | Generate full tool structure from DNA |
| `saasforge workflow` | `sp workflow` | Generate spec-driven slash commands |
| `saasforge deploy` | `sp deploy` | Deployment readiness checklist |
| `saasforge dna` | `sp dna` | Inspect and validate DNA.md |
| `saasforge constitute` | `sp constitute` | Manage project constitution |
| `saasforge history` | `sp history` | View or clear command history |
| `saasforge dev-activate` | (hidden) | Developer activation (authorized users only) |

> **`saasforge dev-activate`** — hidden command for developer (Fahad only). Reads token from `~/.saasforge/dev.token` or direct argument. Email-locked HMAC activation, lifetime access.

### All Options

| Flag | Applies To | Purpose |
|------|-----------|---------|
| `--ai` | init, workflow | Choose AI CLI adapter (25 options) |
| `--no-git` | init | Skip git init |
| `--here` | init | Init in current directory instead of new folder |
| `--force`, `-f` | scaffold | Overwrite existing tool directory |
| `--number`, `-n` | scaffold | Tool number (default: 002) |
| `--target`, `-t` | scaffold | Target directory (default: `_tools`) |
| `--dna` | scaffold | Path to DNA.md |
| `--show`, `-s` | constitute | Display constitution |
| `--edit`, `-e` | constitute | Edit in default text editor |
| `--regenerate`, `-r` | constitute | Regenerate constitution from DNA |
| `--limit`, `-n` | history | Number of entries (default: 50) |
| `--clear` | history | Delete all history |
| `--path`, `-p` | dna | Path to DNA.md |
| `--validate` | dna | Run DNA validation checks |
| `--version`, `-v` | (any) | Show version |
| `--help` | (any) | Show help |

---

## 🔬 SaaSForge vs SpecifyPlus

| Capability | SpecifyPlus | SaaSForge | Winner |
|------------|-------------|-----------|--------|
| **CLI Adapters** | 18 | **25** | 🏆 **SaaSForge** (+7) |
| **DNA-Aware Scaffolding** | ❌ Static templates | ✅ Reads `_system/DNA.md` | 🏆 **SaaSForge** |
| **Scaffold Output** | Spec files only | **Full-stack tool** (Dockerfile, backend, frontend, deploy config) | 🏆 **SaaSForge** |
| **Deploy Checklist** | ❌ None | ✅ Vercel + HF Spaces (7-point) | 🏆 **SaaSForge** |
| **DNA Validation** | ❌ | ✅ `saasforge dna --validate` | 🏆 **SaaSForge** |
| **Command History** | ❌ | ✅ `.saasforge/memory/history.yml` | 🏆 **SaaSForge** |
| **Constitution** | ✅ `.specify/memory/` | ✅ `.saasforge/memory/constitution.md` | Draw |
| **`check` Command** | ✅ | ✅ | Draw |
| **`--force` Flag** | ❌ Silent overwrite | ✅ Explicit + directory cleanup | 🏆 **SaaSForge** |
| **DNA Parser** | Exact match only | ✅ Case-insensitive, aliases, regex, spaces-before-colon | 🏆 **SaaSForge** |
| **Terminal-Only Mode** | ❌ | ✅ `--ai terminal` — zero AI CLI needed | 🏆 **SaaSForge** |
| **Idempotent Init** | ❌ May duplicate | ✅ Guarded by `if not path.exists()` | 🏆 **SaaSForge** |
| **Short CLI Alias** | ✅ `sp` | ✅ `sp` | Draw |
| **Licensing** | MIT only | **Commercial + MIT credit** (proprietary code owned by you) | 🏆 **SaaSForge** |
| **Target** | General spec-driven dev | **Micro-SaaS Factory** (450 tools, isolated infra) | 🏆 **SaaSForge** |

**Score: SaaSForge 12 — SpecifyPlus 0 — Draw 3**

---

## 🏗️ Architecture

```
project-root/
│
├── _system/
│   └── DNA.md                    ← Single source of truth (frontend, backend, DB, auth, storage)
│
├── _tools/
│   ├── _001-invoice-ocr/         ← Tool 1: Isolated Micro-SaaS
│   │   ├── frontend/ (Next.js)
│   │   ├── backend/  (FastAPI)
│   │   ├── Dockerfile
│   │   ├── app.py
│   │   ├── requirements.txt
│   │   └── vercel.json
│   │
│   ├── _002-whatsapp-bot/        ← Tool 2: Isolated Micro-SaaS
│   └── _003-blog-writer/         ← Tool 3: Isolated Micro-SaaS
│
├── .saasforge/
│   └── memory/
│       ├── constitution.md       ← Project memory (AI CLI reads this)
│       └── history.yml           ← Command audit trail
│
├── .opencode/  (or .claude/ or .cursor/ etc.)   ← AI CLI adapter config
│
└── saasforge                     ← pip install saasforge
```

### Deployment Architecture (Each Tool)

```
Tool 001 → Vercel (Next.js FE) + HF Space (FastAPI BE on port 7860) + Turso DB + R2 Bucket
Tool 002 → Vercel (Next.js FE) + HF Space (FastAPI BE on port 7860) + Turso DB + R2 Bucket
...
```

Key points:
- **Har tool completely isolated.** Apna Vercel project, apna HF Space, apni DB, apna storage
- **Ek tool down → baqi 449 unaffected**
- **DNA ek hi jagah** — `_system/DNA.md`. Kabhi bhi badlo, sab tools affect hotay hain
- **Docker SDK** — Hugging Face Spaces Docker mode use karta hai (Blank SDK nahi)

---

## 🎯 Use Cases

### Solo Founder — Build a Micro-SaaS Empire

Aap 1 tool per week banao. Har tool apni alag revenue stream hai. Ek fail ho jaye to baqi hain.

```bash
# Week 1
saasforge scaffold invoice-ocr --number 001 --dna _system/DNA.md

# Week 2
saasforge scaffold whatsapp-bot --number 002 --dna _system/DNA.md

# Week 3
saasforge scaffold blog-writer --number 003 --dna _system/DNA.md
```

### Development Team — Standardized Architecture

Naye developer ko onboard karna aasaan hai. DNA.md ek hi source of truth hai. Stack, patterns, deployment flow sab standardized.

```
New Developer → git clone → saasforge dna --validate → saasforge scaffold → Ready
```

### AI-Only Development (No AI CLI)

Agar aapke paas koi AI CLI nahi hai, to `--ai terminal` use karo:

```bash
saasforge init my-tool --ai terminal
```

Ye `.saasforge/config.yml` banata hai. Koi bhi LLM (ChatGPT, Gemini, DeepSeek) isay follow kar sakta hai.

### Education — Learn SaaS Architecture

Scaffold a complete tool → study the generated files → understand how production SaaS works:

```
Dockerfile      → How containerization works
app.py          → FastAPI entrypoint (port 7860)
vercel.json     → Rewrite proxy config
requirements.txt → Python dependency management
```

### Consultant — Deliver Tools Faster

250+ tools banao, har client ko 1 tool do. Har tool isolated, branded, independently deployable.

### Open Source Project — Standardized Contributing

SaaSForge ke saath, contributors ko bas `_system/DNA.md` padhna hai. Same stack, same patterns, same everything.

---

## 📄 License

- **Original SpecifyPlus code:** MIT © GitHub, Inc. — see [NOTICE.md](NOTICE.md) for attribution
- **All new code, adapters, CLI, templates, and SaaSForge-specific work:** **SaaSForge Commercial License** — see [LICENSE](LICENSE)

You may use SaaSForge freely in your own projects and commercial products. Contact the author for redistribution or sublicensing.

---

*Built with ❤️ by Fahad Khakwani. Part of the [Micro-SaaS Factory](https://github.com/Fahad-FullStackDeveloper/4--SaaS_Factory) project.*
