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

| Command | Description | |---------|-------------| | /constellation:generate | Full flow: open web UI, select stack, generate project | | /plugin marketplace add avarajar/constellation | Add the marketplace | | /plugin install constellation@constellation | Install the plugin |

Adding Technologies

Technologies are defined in YAML files under src/registry/technologies/:

technologies:
  - id: my-framework
    name: My Framework
    category: backend
    description: A fast web framework
    language: typescript
    version: "1.0.0"
    tags: [web, api]
    homepage: https://example.com

Compatibility rules live in src/validators/rules.yml:

rules:
  - id: "my-rule"
    type: "conflict"       # conflict | requires | warns
    techs: ["tech-a", "tech-b"]
    message: "Tech A and Tech B cannot be used together"

Development

npm install          # Install dependencies
npm run dev          # Run CLI in development mode
npm run dev -- web   # Start web UI at localhost:3210
npm test             # Run tests with Vitest
npm run build        # Build with tsup
npm run lint         # Lint with ESLint
npm run typecheck    # Type check with tsc

Tech Stack

Built with TypeScript, Node.js, Commander.js, @inquirer/prompts, Handlebars, js-yaml, chalk, ora, Vitest, tsup, ESLint, Prettier.

License

MIT