Spec-Driven Micro-SaaS Development Toolkit
Reason this release was yanked:
resolving errors move on to newer versions
Project description
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 trialBuy a license โ for all 25 adapters and lifetime access.
๐ See GUIDE.md for a complete walkthrough of all commands, adapters, and products.
โก Default package manager: pnpm โ all scaffolded tools use
pnpm install/pnpm run build. Works with npm/yarn too but pnpm recommended (shared store = less disk space).
Both saasforge and sp aliases work โ same CLI, shorter name.
$ saasforge --version
saasforge v0.9.1
$ sp --version
saasforge v0.9.1
๐ Table of Contents
- ๐ค What is SaaSForge?
- ๐ณ Licensing Model
- ๐ฐ 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 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
# 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
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 (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).
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:
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 tokens |
sp tokens |
Estimate project token usage (live counter) |
saasforge dev-activate |
(hidden) | Developer activation (authorized users only) |
saasforge dev-activateโ hidden command for developer (Fahad only). Reads token from~/.saasforge/dev.tokenor 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 โ Full Comparison
| Capability | SpecifyPlus | SaaSForge | Winner |
|---|---|---|---|
| AI CLI Adapters | 18 | 25 (+7) | ๐ SaaSForge |
| 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 |
โ (requires license) | โ Free for everyone โ no license needed | ๐ SaaSForge |
--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 |
| 24-Hour Free Trial | โ None | โ 24h, 8 adapters, 4 products, 3-layer backup | ๐ SaaSForge |
| Trial Tamper Protection | โ | โ HMAC-signed + JSON + hidden backup + OS-native (Registry/plist/XDG) | ๐ SaaSForge |
| Machine Fingerprint Binding | โ | โ License + trial bound to hostname + UUID hash | ๐ SaaSForge |
| Offline License Grace | โ | โ 48-hour HMAC fallback (no internet needed) | ๐ SaaSForge |
| Lemon Squeezy Online Validation | โ | โ License activate + validate via LMSQ API | ๐ SaaSForge |
| Developer Activation | โ | โ
Hidden dev-activate command โ email-locked HMAC |
๐ SaaSForge |
| Trial Expiry Warnings | โ | โ Yellow <6h, Red <15min on every command | ๐ SaaSForge |
| Slash Command Set | 5 (specify, plan, tasks, implement, review) | 6 (specify, plan, tasks, implement, analyze, review) | ๐ SaaSForge |
| Token Savings | โ Constitution only (~20%) | โ Constitution + DNA + Slash Commands = ~95% | ๐ SaaSForge |
| 450-Tool Architecture | โ General spec-driven dev | โ Isolated Micro-SaaS Factory (per-tool Vercel + HF + DB + Storage) | ๐ SaaSForge |
| Pricing Model | MIT (free) | Commercial + MIT credit โ code owned by you | ๐ SaaSForge |
| Payment Integration | โ None | โ Lemon Squeezy ready (checkout + license key delivery) | ๐ SaaSForge |
| Multi-Stack Support | โ Single stack only | โ (Coming Soon) 10+ frontends, 10+ backends, 10+ databases, ORMs, ERP, AI providers | ๐ SaaSForge |
| ORM Support | โ None | โ (Coming Soon) Prisma, Drizzle, SQLAlchemy, TypeORM, Mongoose, Kysely | ๐ SaaSForge |
| ERP Systems | โ None | โ (Coming Soon) Oracle Cloud ERP, Odoo, ERPNext | ๐ SaaSForge |
| Serverless Postgres | โ Turso only | โ (Coming Soon) NeonDB, Supabase, PostgreSQL | ๐ SaaSForge |
| AI Provider Abstraction | โ Gemini fixed | โ (Coming Soon) OpenAI, Claude API, Together AI, Groq, Ollama | ๐ SaaSForge |
| Oracle Cloud DB | โ None | โ (Coming Soon) Enterprise Oracle database support | ๐ SaaSForge |
| Priority Support | โ None | โ Email / Discord | ๐ SaaSForge |
Score: SaaSForge 28 โ SpecifyPlus 0 โ Draw 3
โ ๏ธ Haad (Caveat): SaaSForge initially forked from SpecifyPlus and shares its DNA (spec-driven development philosophy). SpecifyPlus ka core concept โ DNA.md se spec generate karna โ wohi foundation hai jis par SaaSForge bana hai. Lekin SaaSForge ne us concept ko Micro-SaaS Factory tak le ja kar ek alag direction di hai: full-stack scaffolding, 25 adapters, commercial licensing, trial system, payment integration, aur multi-stack support. SpecifyPlus ek excellent open-source tool hai apne domain mein, aur hum unki contribution ko NOTICE.md mein credit karte hain.
๐๏ธ 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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file saasforge-0.9.1.tar.gz.
File metadata
- Download URL: saasforge-0.9.1.tar.gz
- Upload date:
- Size: 57.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
da46c01f428b554620c92365793d1511e1d64c29530cdba36161288b9ade7870
|
|
| MD5 |
f0264a8f8845f29fcaed547048c96f95
|
|
| BLAKE2b-256 |
d1f18a57fd6059fc860911f6905b704c3718efbba3d04e63343374e2217668da
|
File details
Details for the file saasforge-0.9.1-py3-none-any.whl.
File metadata
- Download URL: saasforge-0.9.1-py3-none-any.whl
- Upload date:
- Size: 53.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7676a002bef0cc295483bd869a696b632af6cd4d54ec56b85d787f4f9f6dd352
|
|
| MD5 |
0bd269e989f980bbdebb47c3d24d72d4
|
|
| BLAKE2b-256 |
71ed0d578c7c3ef3a24b148fd2757fc7cc7bbd27e57ad50ea515ff307958c256
|