saasforge 0.7.2

Spec-Driven Micro-SaaS Development Toolkit

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

# Install
pip install saasforge

# Verify
saasforge --version
sp --version

🆕 24-hour free trial available — try SaaSForge with 8 top adapters. No credit card required.

saasforge trial

Buy a license → for all 25 adapters and lifetime access.

📖 See GUIDE.md for a complete walkthrough of all commands, adapters, and products.

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

$ saasforge --version
saasforge v0.7.0
$ sp --version
saasforge v0.7.0

---

📖 Table of Contents

• 🤔 What is SaaSForge?
• 💰 Token Savings
• 🏆 Top 10 Reasons to Use SaaSForge
• 🛠️ What Can You Build With SaaSForge?
• ⚡ Quick Start
• 📋 Full Workflow
• 🤖 Supported AI CLIs (25)
• 📟 Commands Reference
• 🔬 SaaSForge vs SpecifyPlus
• 🏗️ Architecture
• 🎯 Use Cases
• 📄 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 shurat mein constitution read karta hai — is liye continuity kabhi nahi tooti.

---

💰 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 bik 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

# 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:

saasforge register LIC-XXXXX     # All 25 adapters, lifetime

7 commands, 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:

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:

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

# 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

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:

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

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

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

# 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	--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

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

saasforge init my-tool --ai cursor
saasforge init my-tool --ai continue
saasforge init my-tool --ai cody
saasforge init my-tool --ai amazonq
# ... 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

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.

# 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:

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 for attribution
• All new code, adapters, CLI, templates, and SaaSForge-specific work: SaaSForge Commercial License — see 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 project.