constellation
nteractive project generator with a visual web UI. Select your tech stack from 88+ technologies across 6 categories (frontend, backend, data
Open source Open in the app JSON README (API)
About
nteractive project generator with a visual web UI. Select your tech stack from 88+ technologies across 6 categories (frontend, backend, database, infrastructure, testing, monitoring), then AI-generates a fully functional project with working CRUD endpoints, database schemas, Docker configs, CI/CD pipelines, and more. Includes GitHub integration for repo creation and online tech search via npm, PyPI, and crates.io.
Details
- Kind
- Plugins
- Topic
- Cloud & DevOps
- Publisher
- avarajar
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-04-13T20:22:50Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
avarajar/constellation/constellation
README
# 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
```bash
# 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
```bash
git clone git@github.com:avarajar/constellation.git
cd constellation
npm install
/plugin marketplace add ./
/plugin install constellation@constellation
```
### Development
```bash
git clone git@github.com: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/`:
```yaml
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`:
```yaml
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
```bash
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