Spec-as-Code Platform

Welcome to SpecDown

SpecDown is the modern way to write and manage software specifications. Replace fragile Word docs and stale Confluence pages with version-controlled Markdown — live in your Git repository, always in sync with your code.

What is SpecDown?

SpecDown is a Spec-as-Code platform that brings software engineering discipline to your requirements and design documents. It gives you:

A VS Code-grade Markdown editor with live preview
Automatic two-way sync with GitHub or GitLab
Mermaid diagram rendering for architecture, flows, and ER diagrams
Team collaboration with role-based access control
An MCP server so AI assistants can read your specs directly
A CLI tool for scripting and CI/CD integration

Why SpecDown?

Traditional spec tools create a disconnect between documentation and code. Word documents drift out of date. Confluence pages get abandoned. SpecDown closes that gap by treating your specs exactly like source code.

VS Code-Grade Editor

Monaco editor with Markdown syntax highlighting, autocomplete, keyboard shortcuts, and a side-by-side live preview panel.

Git Sync

Connect to GitHub or GitLab with a Personal Access Token. Every save pushes a commit. Pull changes from your repo on demand.

Share & Collaborate

Create public share links or password-protected links. Invite teammates with granular roles: Owner, Admin, Editor, or Viewer.

MCP Server for AI

Expose your specs to Claude, Cursor, or any MCP-compatible AI assistant. Let AI read your requirements before writing code.

CLI Tool

Automate spec management from the terminal or CI/CD pipeline. Push, pull, search, and manage documents with simple commands.

Secure by Default

Row-level security on all data. Git tokens encrypted with pgcrypto. Supabase Auth with OAuth and email/password support.

SpecDown vs. Alternatives

Feature	SpecDown	Confluence	Word / Google Docs
Version control (Git)	✅ Native	❌ Page history only	❌ Manual
Plain-text format	✅ Markdown	❌ Proprietary	❌ Binary
Diagram rendering	✅ Mermaid built-in	⚠️ Plugin required	❌
AI-readable specs (MCP)	✅ MCP Server	❌	❌
CLI / automation	✅ Full CLI	⚠️ REST API only	❌
Offline capable	✅ Git clone	❌	⚠️ Limited

Core Concepts

SpecDown is organised around a few simple concepts. Everything lives inside a Project, which maps to a Git repository. Projects contain Documents (Markdown files) organised in Folders. Each project has Members with assigned roles.

ℹ

New to SpecDown?

Head to the Quick Start guide to get your first project running in under 5 minutes.

How It Works

Create a project — Give it a name and optional Git repository URL. SpecDown scaffolds the workspace.
Write specs — Use the Monaco editor with live preview. Drop in Mermaid diagrams. Upload images directly (stored on Cloudflare R2).
Sync with Git — Connect a GitHub or GitLab Personal Access Token. Every save becomes a commit. Collaborate via pull requests.
Share — Generate share links for stakeholders who don't need to log in. Set passwords or expiry dates (Pro).
Use with AI — Configure the MCP server in Claude Desktop or Cursor. Let your AI assistant read the spec before writing code.