{
  "markdown": "# Constellation\n\nInteractive 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.\n\n## How It Works\n\n1. Run `/constellation` in Claude Code (or `npx constellation` from the terminal)\n2. A web UI opens in your browser at `http://localhost:3210`\n3. Pick your technologies, configure your project, select GitHub options\n4. Click **\"Send to Claude Code\"**\n5. Claude Code reads your blueprint and generates the entire project with AI — backend, frontend, database, infrastructure, tests, monitoring — all wired together\n\nNo templates. No stubs. Real, working code generated by AI based on your exact stack choices.\n\n## Install as Claude Code Plugin\n\n```bash\n# 1. Add the marketplace\n/plugin marketplace add avarajar/constellation\n\n# 2. Install the plugin\n/plugin install constellation@constellation\n```\n\nThat's it. Now run `/constellation:generate` in any Claude Code session.\n\n### Alternative: Install from Local Clone\n\n```bash\ngit clone git@github.com:avarajar/constellation.git\ncd constellation\nnpm install\n/plugin marketplace add ./\n/plugin install constellation@constellation\n```\n\n### Development\n\n```bash\ngit clone git@github.com:avarajar/constellation.git\ncd constellation\nnpm install\n\n# Run the web UI\nnpm run dev -- web\n\n# Run with --wait mode (blocks until blueprint is saved)\nnpm run dev -- web --wait\n```\n\n## Features\n\n- **Visual web UI** — dark-themed wizard with tech card selection, search, and live validation\n- **88+ technologies** across Frontend, Backend, Database, Infrastructure, Testing, and Monitoring\n- **Claude Code plugin** — `/constellation` opens the UI, waits for your choices, and generates everything automatically\n- **Online tech search** — search npm, PyPI, and crates.io for technologies not in the registry\n- **GitHub integration** — create new repos, search existing ones, select orgs — all from the UI\n- **Compatibility validation** — catches conflicts (React + Angular) and missing requirements (Nuxt without Vue)\n- **Blueprint system** — your selections are saved as a YAML blueprint that drives AI generation\n- **Extensible YAML registry** — add technologies by editing YAML files, no recompile needed\n- **Monorepo support** — optional Turborepo or Nx configuration\n\n## Supported Technologies\n\n| Category | Technologies |\n|----------|-------------|\n| **Frontend** | React, Vue, Svelte, Angular, Next.js, Nuxt, Astro, SolidJS, Qwik |\n| **CSS** | Tailwind, Styled Components, CSS Modules, Sass, Emotion, Vanilla Extract |\n| **State** | Zustand, Redux, Pinia, Jotai, MobX, Recoil, XState, Nanostores |\n| **Backend** | Express, Fastify, Hono, NestJS, Elysia, Django, Flask, FastAPI, Gin, Echo, Chi, Actix, Axum, Rocket, Spring Boot, Quarkus, ASP.NET Core |\n| **Database** | PostgreSQL, MySQL, MongoDB, SQLite, Redis, DynamoDB, Firestore |\n| **ORM** | Prisma, TypeORM, Drizzle, Sequelize, Mongoose, SQLAlchemy, Entity Framework |\n| **Infrastructure** | Docker, Podman, Docker Compose, Kubernetes, AWS, GCP, Vercel, Netlify, Railway, Render |\n| **CI/CD** | GitHub Actions, GitLab CI, CircleCI, Jenkins, Azure Pipelines |\n| **Testing** | Vitest, Jest, Pytest, Playwright, Cypress, Selenium, Postman, REST Client |\n| **Monitoring** | Prometheus, Grafana, Sentry, Datadog, New Relic, ELK Stack, Loki, CloudWatch |\n\n## Architecture\n\n```\nconstellation/\n├── .claude-plugin/             # Marketplace catalog\n│   └── marketplace.json\n├── plugin/                     # Claude Code plugin (what gets installed)\n│   ├── .claude-plugin/\n│   │   └── plugin.json         # Plugin manifest\n│   ├── skills/generate/        # Main /constellation:generate skill\n│   └── bin/                    # CLI wrapper added to PATH\n├── src/\n│   ├── core/              # Types, engine, pipeline, blueprint system\n│   ├── cli/               # Commander setup, prompts, web --wait mode\n│   ├── registry/          # YAML-based technology registry + online search\n│   ├── validators/        # Compatibility rules engine (30+ rules)\n│   ├── generators/        # Per-category file generators\n│   ├── templates/         # Handlebars template engine\n│   └── web/               # HTTP server + vanilla HTML/CSS/JS web UI\n└── tests/                 # Vitest test suite\n```\n\n**Pipeline**: Selection (Web UI) → Blueprint (YAML) → Validation → AI Generation (Claude Code sub-agents) → Output\n\n## CLI Commands\n\n| Command | Description |\n|---------|-------------|\n| `constellation` | Open web UI, wait for blueprint, output path (default) |\n| `constellation web` | Start web UI server (stays running) |\n| `constellation web --wait` | Start web UI, block until blueprint saved, exit |\n| `constellation new` | Interactive CLI project generator (terminal prompts) |\n| `constellation list` | List all registered technologies |\n| `constellation validate <file>` | Validate a project configuration |\n\n### Claude Code Plugin\n\n| Command | Description |\n|---------|-------------|\n| `/constellation:generate` | Full flow: open web UI, select stack, generate project |\n| `/plugin marketplace add avarajar/constellation` | Add the marketplace |\n| `/plugin install constellation@constellation` | Install the plugin |\n\n## Adding Technologies\n\nTechnologies are defined in YAML files under `src/registry/technologies/`:\n\n```yaml\ntechnologies:\n  - id: my-framework\n    name: My Framework\n    category: backend\n    description: A fast web framework\n    language: typescript\n    version: \"1.0.0\"\n    tags: [web, api]\n    homepage: https://example.com\n```\n\nCompatibility rules live in `src/validators/rules.yml`:\n\n```yaml\nrules:\n  - id: \"my-rule\"\n    type: \"conflict\"       # conflict | requires | warns\n    techs: [\"tech-a\", \"tech-b\"]\n    message: \"Tech A and Tech B cannot be used together\"\n```\n\n## Development\n\n```bash\nnpm install          # Install dependencies\nnpm run dev          # Run CLI in development mode\nnpm run dev -- web   # Start web UI at localhost:3210\nnpm test             # Run tests with Vitest\nnpm run build        # Build with tsup\nnpm run lint         # Lint with ESLint\nnpm run typecheck    # Type check with tsc\n```\n\n## Tech Stack\n\nBuilt with TypeScript, Node.js, Commander.js, @inquirer/prompts, Handlebars, js-yaml, chalk, ora, Vitest, tsup, ESLint, Prettier.\n\n## License\n\nMIT\n",
  "bytes": 6308,
  "sha": "d36ef0b93f4e876d6b5045263ec23ac04229f99fa39079b4fa7203fddcedac0d",
  "repo_slug": "avarajar/constellation",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_avarajar_constellation_constellation_612d8afc/readme"
}