Wireframes as Code. Declarative wireframing with AI-friendly syntax.
WireDSL is a code-first wireframing tool that lets you:
- ✍️ Write wireframes as declarative code (like Mermaid, but for UI)
- 🤖 Generate from plain English ("Create a login form..." → automatic wireframe)
- 📦 Export to SVG, PNG, PDF
- 🔓 100% open-source and free forever
- ⚙️ AI-friendly syntax for LLM-powered generation
Try online (no installation needed):
Visit live.wire-dsl.org to use the web editor in your browser.
Start the web editor locally (connected to your files):
pnpm install && cd apps/web && pnpm dev→ Open http://localhost:3000
Try the CLI (one-liner):
npm install -g @wire-dsl/cli && wire render examples/simple-dashboard.wire -o output.svgUse as a library:
npm install @wire-dsl/engine
import { parseWireDSL, generateIR } from '@wire-dsl/engine';Live editor showing:
- Left:
.wirecode in Monaco editor- Right: Real-time SVG preview (hot reload)
- Changes appear instantly as you type
Note: screenshot from Wire Live on live.wire-dsl.org.
- QUICKSTART.md - Setup guide (5 minutes)
- MONOREPO.md - How the project is organized (10 minutes)
- docs/DOCUMENTATION-INDEX.md - Complete documentation index
Getting Started
- QUICKSTART.md - Get up and running
- MONOREPO.md - Project structure
- docs/DOCUMENTATION-INDEX.md - Complete documentation index
- .github/CONTRIBUTING.md - Contributing guide
Technical & Design
- docs/ARCHITECTURE.md - System design
- docs/DSL-SYNTAX.md - Language syntax guide
- docs/STYLE-GUIDE.md - Style system documentation
- docs/LLM-PROMPTING.md - Guide for AI generation from natural language
- docs/ICONS-GUIDE.md - Icons library and usage
- docs/ICON-AND-BUTTON-SIZING.md - Icon and button sizing guide
Component & Container References
- specs/IR-CONTRACT.md - Intermediate representation format
- specs/LAYOUT-ENGINE.md - Layout algorithms
- specs/VALIDATION-RULES.md - Validation rules
Planning & Roadmap
- docs/ROADMAP.md - Future features and milestones
Examples
- examples/ - Complete working examples
WireDSL is a platform for creating declarative wireframes where:
- ✍️ You declare, you don't draw
- 🤖 AI-friendly: predictable syntax for automatic generation
- 📐 Deterministic: same input → same output
- 🔄 Versionable: wireframes are code
project "Dashboard" {
style {
density: "normal"
spacing: "md"
radius: "md"
stroke: "normal"
font: "base"
}
screen Home {
layout stack(direction: vertical, gap: md, padding: lg) {
component Heading text: "Welcome"
component Button text: "Get Started"
}
}
}
| Package/App | Purpose | Status |
|---|---|---|
| @wire-dsl/engine | Parser, IR, layout, renderer | ✅ Published |
| @wire-dsl/exporters | SVG, PNG, PDF export (Node.js) | ✅ Published |
| @wire-dsl/cli | Command-line tool | ✅ Published |
| @wire-dsl/language-support | VS Code syntax & type support | ✅ Published |
| wire-dsl/web | Live web editor | ✅ Published |
| wire-dsl/docs | Documentation site | ✅ Published |
project "Login Form" {
style {
density: "normal"
spacing: "md"
radius: "md"
stroke: "normal"
font: "base"
}
screen LoginScreen {
layout panel(padding: lg, background: "white") {
layout stack(direction: vertical, gap: md) {
component Heading text: "Sign In"
component Input label: "Email" placeholder: "your@email.com"
component Input label: "Password" placeholder: "••••••••"
component Checkbox label: "Remember me"
component Button text: "Sign In" variant: primary
}
}
}
}
- Monaco editor on the left
- SVG preview on the right
- Hot reload as you type
User: "Create a login form with email, password, and remember me"
→ LLM generates .wire code
→ Preview appears instantly
→ Edit if needed
- SVG (scale to any size)
- PNG (with optional resizing)
- PDF (multipage support)
Core
- TypeScript 5.3 (strict mode)
- Chevrotain 11.x (parser)
- Zod 4.x (validation)
Web Editor
- React
- Vite
- Monaco Editor
- Tailwind CSS
DevOps
- pnpm + Turborepo
- Vitest (testing)
- GitHub Actions (CI/CD)
- Changesets (versioning)
Deployment
- Cloudflare Pages (web editor)
- NPM (CLI tool)
.wire (text)
↓
Parser (Chevrotain)
↓
AST (tokens)
↓
IR Generator
↓
IR Contract (JSON)
↓
Layout Engine
↓
Positioned Elements
↓
SVG Renderer
↓
SVG / PNG / PDF
- Web Editor: Automatic via Cloudflare Pages (git push → live)
- CLI Tool: Automatic via GitHub Actions + NPM (changesets → publish)
Free & Open Source
- ✅ Engine library (@wire-dsl/engine) - Pure TypeScript parser + layout
- ✅ Exporters library (@wire-dsl/exporters) - SVG, PNG, PDF output
- ✅ CLI tool (@wire-dsl/cli) - Command-line rendering
- ✅ Language support (@wire-dsl/language-support) - VS Code integration
- ✅ Web editor - Live editing and preview with AI integration
- ✅ Full source code on GitHub
We welcome contributions! See CONTRIBUTING.md.
Quick start:
git checkout -b feature/your-feature
cd packages/engine
pnpm test:watch
# Make changes
git commit -m "feat(engine): your feature"
git push origin feature/your-feature
# Create PR- Website: https://wire-dsl.org - Official documentation site
- Live Editor: https://live.wire-dsl.org - Try WireDSL in your browser
- GitHub: https://github.com/wire-dsl/wire-dsl
- NPM Org: https://www.npmjs.com/org/wire-dsl
- Issues: GitHub Issues
- Discussions: GitHub Discussions
MIT License - Free for personal and commercial use
This project includes icons from Feather Icons, created by Cole Bemis and contributors.
- License: MIT License
- Version: 4.29.0
- Available icons: 287
- Repository: https://github.com/feathericons/feather
- Location in project:
packages/engine/src/renderer/icons/ - Complete list:
docs/ICONS-GUIDE.md - Full details: See
packages/engine/src/renderer/icons/ICONS-LICENSE.md
Feather Icons are used under the terms of the MIT License, which is fully compatible with this project's MIT License.
| Aspect | WireDSL | Mermaid | Excalidraw | Figma | v0 by Vercel |
|---|---|---|---|---|---|
| Purpose | ✅ Wireframe ideas | ❌ Diagrams | ✅ Sketches | 🎨 Design system | ❌ Production code |
| UI/UX focused | ✅ 30+ UI components | ❌ Diagrams only | ✅ Visual sketches | ✅ Full design | ✅ React apps |
| Code-first | ✅ Full DSL | ✅ Limited syntax | ❌ GUI-only | ❌ GUI-only | ❌ GUI/prompt |
| Layout model | ✅ Declarative containers (Stack, Grid, Panel) | ❌ N/A | ❌ Pixel-based | ❌ Absolute positioning | ✅ HTML-like |
| AI-generation ready | ✅ Predictable syntax | ❌ Not designed for AI | ✅ LLM-powered | ||
| Version control friendly | ✅ Text diffs work great | ✅ Text-based | ❌ Binary format | ❌ Binary format | ❌ Code files |
| Export formats | ✅ SVG, PNG, PDF | ❌ Limited | ✅ SVG, PNG | ✅ Multiple | ❌ React code |
| License & Pricing | ✅ Open Source (MIT) | ✅ Open Source (MIT) | ✅ Open Source (MIT) | ❌ Paid plans |
TL;DR:
- WireDSL: Wireframe ideas in code (fast ideation + brainstorming)
- v0: Production React apps from AI (fully coded, ready to deploy)
- Figma: Design system & collaboration (professional design tool)
- Mermaid: Diagrams as code
- Excalidraw: Hand-drawn sketches
Inspired by:
- Mermaid - Diagrams as code
- Figma - Design systems
- React - Component-based UIs
- DSL design patterns - Language engineering
Phase 1 ✅ (Completed)
- ✅ Parser implementation
- ✅ IR generator
- ✅ Layout engine
- ✅ SVG renderer
- ✅ Web editor MVP
- ✅ CLI tool
- ✅ PNG/PDF export
Phase 2 ✅ (Completed)
- ✅ Style system with design tokens
- ✅ 23+ built-in components
- ✅ Component composition & validation
- ✅ Complete documentation
Phase 3 ✅ (Completed)
- ✅ VS Code extension with syntax highlighting
- ✅ Real-time error detection
- ✅ Component intellisense
- ✅ Document formatting
- ✅ Live preview pane
- 🔗 GitHub Repository | VS Code Marketplace
Phase 4 🚀 (Current)
- Source maps - Map
.wiresource to rendered components - LSP (Language Server Protocol) support
- Enhanced debugging capabilities
Future Features
- Code generation (React/Vue templates)
- Figma import/export
- Real-time collaboration
- ...and more exciting features in the pipeline! 🎉
✅ Phase 1: Core MVP (completed)
✅ Phase 2: System & Design Tokens (completed)
✅ Phase 3: VS Code Extension (completed)
🚀 Phase 4: Source Maps (in progress)
├─ Source map generation
├─ Debugging support
└─ Error reporting with precise locations
📅 LSP support (planned)
📅 Code generation (planned)
📅 More features in the pipeline 🎉
Last Updated: February 6, 2026
Status: ✅ Production-Ready, Open Source
Next: Visit live.wire-dsl.org to try it now!