Frontend spec-driven development for Flutter, Next.js, and React Native.
SpecDrive is an open-source, AI-agnostic framework that generates Kiro-style specifications — requirements.md → gap-analysis.md → design.md → tasks.md — focused on UI/UX implementation, not backend APIs.
Backend SDD already has OpenAPI, GitHub Spec Kit, and similar tools. Frontend developers lack an equivalent — a structured way to go from feature idea → UI design spec → implementation tasks, with AI assistance and persistent project knowledge.
Feature idea → requirements.md → gap-analysis.md → design.md → tasks.md → Implement → Review
(EARS) (codebase gaps) (UI/UX) (frontend tasks)
approve ✓ approve ✓ approve ✓ approve ✓
design.md drives UI/UX — screens, components, navigation, state, accessibility, platform behavior.
| Stack | Status |
|---|---|
| Flutter | First-class |
| Next.js | First-class |
| React Native | First-class |
Works with Cursor, Claude Code, Codex CLI, Gemini, Windsurf, Cline, Roo, Continue — via MCP or CLI.
.specdrive/
├── product.md # Product steering
├── tech-stack.md # Stack steering
├── structure.md # Architecture steering
├── coding-style.md # Conventions steering
└── specs/
└── product-review/
├── requirements.md # User stories + EARS acceptance criteria
├── gap-analysis.md # Requirements vs existing codebase gaps
├── design.md # UI/UX blueprint (screens, components, flows)
└── tasks.md # Sequenced implementation tasks
git clone https://github.com/Anu-Code07/spec-copilot.git
cd spec-copilot
pnpm install && pnpm build
# In your frontend project
spec init --stack flutter
spec create "Product Review Screen" --quick # all docs at once
# Or gated Kiro-style workflow
spec create "Product Review Screen"
spec approve requirements --spec product-review-screen
spec gap-analysis --spec product-review-screen
spec approve gap-analysis --spec product-review-screen
spec design --spec product-review-screen
spec approve design --spec product-review-screen
spec tasks --spec product-review-screen
spec implement --spec product-review-screen --next| Mode | Who generates docs | API keys |
|---|---|---|
| CLI / npm | SpecDrive calls a free LLM chain | GEMINI_API_KEY, GROQ_API_KEY, or local Ollama |
| MCP (Cursor/Claude) | Host AI generates docs | Your Cursor/Claude API key — SpecDrive never calls LLM |
CLI free LLM priority: Gemini → Groq → Ollama → template fallback.
export GEMINI_API_KEY=your-key # free tier at https://aistudio.google.com
spec create "Checkout flow"
spec gap-analysis --spec checkout-flow# MCP server (for Cursor / Claude) — uses host AI, not SpecDrive LLM
node packages/mcp/bin/mcp.js
# Review against design.md
spec review --spec product-review-screen --ciSee packages/mcp/README.md for Cursor MCP setup.
Docs site: https://anu-code07.github.io/spec-copilot/
404? Enable Pages once: docs/GITHUB-PAGES-SETUP.md → Settings → Pages → branch
main, folder/docs
| Document | Description |
|---|---|
| Frontend SDD | Core philosophy — frontend-first, Kiro-style |
| Spec Format | requirements.md, design.md, tasks.md templates |
| CLI Spec | Command reference |
| Vision | Project vision |
| Architecture | System design |
| Design Decisions | ADRs |
| Phase | Scope | Status |
|---|---|---|
| 1 | Vision, architecture, frontend SDD direction | ✅ Complete |
| 2 | Spec format, CLI design, domain model | ✅ Complete |
| 3 | Core implementation (CLI + spec engine) | ✅ Complete |
| 4 | MCP server, AI generation, review engine | ✅ Complete |
| 5 | VS Code extension | ✅ Complete |
| 6 | Documentation site | ✅ Complete |
| 7 | Example projects (Flutter, Next.js, RN) | ✅ Flutter spec sample |
SpecDrive is ready for real project use when built from source. npm publish is the remaining step for npx install.
| Check | Status |
|---|---|
| CI (typecheck, lint, test, smoke) | ✅ |
| End-to-end CLI smoke test | ✅ pnpm smoke |
| Release checklist | ✅ pnpm release-check |
| MCP + CLI + review engine | ✅ |
| Known limitations documented | ✅ KNOWN-LIMITATIONS.md |
| npm publish | ⏳ Requires NPM_TOKEN |
# Verify before release
pnpm install && pnpm build
pnpm test
pnpm smoke
pnpm release-checkSee CHANGELOG.md for version history.