Skip to main content

Spec-Driven Micro-SaaS Development Toolkit

Reason this release was yanked:

resolving errors move on to newer versions

Project description

SaaSForge Logo

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.

โšก 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.10.0
$ sp --version
saasforge v0.10.0

PyPI Downloads Tests Python License GitHub stars


๐Ÿ“– Table of Contents


๐Ÿค” 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

For Developers (Free / Licensed)

# 1. Install
pip install saasforge

# 2. Verify version
saasforge --version    # โ†’ v0.10.0

# 3. Register license (paid users) OR start trial
saasforge register LIC-XXXXX     # Paid โ€” all 25 adapters, lifetime
# OR
saasforge trial                  # Free โ€” 24h trial, 8 adapters

# 4. Check environment
saasforge check

# 5. Initialize project with your AI CLI
saasforge init my-micro-saas --ai opencode

# 6. Enter project folder
cd my-micro-saas

# 7. Your AI CLI commands are ready!
#    Open your AI CLI (e.g. opencode) and type:
#    /sp.   โ†’ See all 6 workflow commands
#    /sp.specify Build a WhatsApp bot with Twilio
#    /sp.plan
#    /sp.tasks
#    /sp.implement
#    /sp.analyze

# 8. View command history anytime
saasforge history

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.jsonl 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

Windows users: v0.10.0+ fixes Unicode crashes on cp1252 terminals. Run saasforge check to verify your installation.

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.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 โ€” 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.jsonl ๐Ÿ† 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
Windows cp1252 Support โŒ Crashes on legacy terminals โœ… v0.10.0+ โ€” ASCII-safe output ๐Ÿ† 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.jsonl         โ† 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

saasforge-0.10.0.tar.gz (60.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

saasforge-0.10.0-py3-none-any.whl (57.3 kB view details)

Uploaded Python 3

File details

Details for the file saasforge-0.10.0.tar.gz.

File metadata

  • Download URL: saasforge-0.10.0.tar.gz
  • Upload date:
  • Size: 60.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for saasforge-0.10.0.tar.gz
Algorithm Hash digest
SHA256 20e2e05b48cdf132aad06d3dd699246335f2ac216125d6252a346bdec0e575d8
MD5 80c301868396c6524d9aa3cfccca10bb
BLAKE2b-256 7a18dd7a68a816a3b608026ee32f59eb30ddca58358e2315d2679e5d5b96a044

See more details on using hashes here.

File details

Details for the file saasforge-0.10.0-py3-none-any.whl.

File metadata

  • Download URL: saasforge-0.10.0-py3-none-any.whl
  • Upload date:
  • Size: 57.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for saasforge-0.10.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6b81d91d9621f79e935c3903ee6b144002f7336b4f798190ebb9600a99cca945
MD5 be248336441f630ae63433b7121f99b5
BLAKE2b-256 7d6a35fe3b23ee622137ba943142adef788626e8ef44c3c25053caaace80fe61

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page