constellation

Constellation

Interactive project generator with a visual web UI and Claude Code integration. Select your tech stack from 88+ technologies across 6 categories, and generate a fully functional project — powered by AI.

How It Works

1. Run /constellation in Claude Code (or npx constellation from the terminal)
2. A web UI opens in your browser at http://localhost:3210
3. Pick your technologies, configure your project, select GitHub options
4. Click "Send to Claude Code"
5. Claude Code reads your blueprint and generates the entire project with AI — backend, frontend, database, infrastructure, tests, monitoring — all wired together

No templates. No stubs. Real, working code generated by AI based on your exact stack choices.

Install as Claude Code Plugin

# 1. Add the marketplace
/plugin marketplace add avarajar/constellation

# 2. Install the plugin
/plugin install constellation@constellation

That's it. Now run /constellation:generate in any Claude Code session.

Alternative: Install from Local Clone

git clone [email protected]:avarajar/constellation.git
cd constellation
npm install
/plugin marketplace add ./
/plugin install constellation@constellation

Development

git clone [email protected]:avarajar/constellation.git
cd constellation
npm install

# Run the web UI
npm run dev -- web

# Run with --wait mode (blocks until blueprint is saved)
npm run dev -- web --wait

Features

• Visual web UI — dark-themed wizard with tech card selection, search, and live validation
• 88+ technologies across Frontend, Backend, Database, Infrastructure, Testing, and Monitoring
• Claude Code plugin — /constellation opens the UI, waits for your choices, and generates everything automatically
• Online tech search — search npm, PyPI, and crates.io for technologies not in the registry
• GitHub integration — create new repos, search existing ones, select orgs — all from the UI
• Compatibility validation — catches conflicts (React + Angular) and missing requirements (Nuxt without Vue)
• Blueprint system — your selections are saved as a YAML blueprint that drives AI generation
• Extensible YAML registry — add technologies by editing YAML files, no recompile needed
• Monorepo support — optional Turborepo or Nx configuration

Supported Technologies

Category	Technologies
Frontend	React, Vue, Svelte, Angular, Next.js, Nuxt, Astro, SolidJS, Qwik
CSS	Tailwind, Styled Components, CSS Modules, Sass, Emotion, Vanilla Extract
State	Zustand, Redux, Pinia, Jotai, MobX, Recoil, XState, Nanostores
Backend	Express, Fastify, Hono, NestJS, Elysia, Django, Flask, FastAPI, Gin, Echo, Chi, Actix, Axum, Rocket, Spring Boot, Quarkus, ASP.NET Core
Database	PostgreSQL, MySQL, MongoDB, SQLite, Redis, DynamoDB, Firestore
ORM	Prisma, TypeORM, Drizzle, Sequelize, Mongoose, SQLAlchemy, Entity Framework
Infrastructure	Docker, Podman, Docker Compose, Kubernetes, AWS, GCP, Vercel, Netlify, Railway, Render
CI/CD	GitHub Actions, GitLab CI, CircleCI, Jenkins, Azure Pipelines
Testing	Vitest, Jest, Pytest, Playwright, Cypress, Selenium, Postman, REST Client
Monitoring	Prometheus, Grafana, Sentry, Datadog, New Relic, ELK Stack, Loki, CloudWatch

Architecture

constellation/
├── .claude-plugin/             # Marketplace catalog
│   └── marketplace.json
├── plugin/                     # Claude Code plugin (what gets installed)
│   ├── .claude-plugin/
│   │   └── plugin.json         # Plugin manifest
│   ├── skills/generate/        # Main /constellation:generate skill
│   └── bin/                    # CLI wrapper added to PATH
├── src/
│   ├── core/              # Types, engine, pipeline, blueprint system
│   ├── cli/               # Commander setup, prompts, web --wait mode
│   ├── registry/          # YAML-based technology registry + online search
│   ├── validators/        # Compatibility rules engine (30+ rules)
│   ├── generators/        # Per-category file generators
│   ├── templates/         # Handlebars template engine
│   └── web/               # HTTP server + vanilla HTML/CSS/JS web UI
└── tests/                 # Vitest test suite

Pipeline: Selection (Web UI) → Blueprint (YAML) → Validation → AI Generation (Claude Code sub-agents) → Output

CLI Commands

Command	Description
constellation	Open web UI, wait for blueprint, output path (default)
constellation web	Start web UI server (stays running)
constellation web --wait	Start web UI, block until blueprint saved, exit
constellation new	Interactive CLI project generator (terminal prompts)
constellation list	List all registered technologies
constellation validate <file>	Validate a project configuration

Claude Code Plugin