ForgeKit

What it generates

Pick your stack — ForgeKit assembles everything and hands you a project that runs on day one.

Quickstart

$ npm i -g @iconsulting-dev/forgekit

$ forgekit new

? Project name: my-app
? Backend: Spring Boot (Java 21)
? Include Angular frontend? Yes
? Group ID: com.example
? Backend features: Flyway ✓  OpenAPI ✓  MapStruct ✓
? UI framework: PrimeNG (Aura)
? Infrastructure: Docker ✓  CI/CD ✓  Claude Code ✓  Git ✓

✔ Project my-app created successfully!

$ cd my-app

# Start database
$ docker compose up -d

# Start backend
$ cd backend && ./mvnw spring-boot:run

# Start frontend (new terminal)
$ cd frontend && npm install && npm start

Prerequisites

Install what you need for your chosen stack. ForgeKit auto-detects installed tools and adjusts wizard options accordingly.

Required for all stacks

Spring Boot backend

FastAPI backend

Laravel backend

NestJS backend

Docker Compose

Claude Code (optional)

Auto-checked in the wizard if claude is in your $PATH.

Speckit (optional)

Auto-checked in the wizard if specify is in your $PATH.

Examples

# Spring Boot + Angular + Docker + Claude Code
$ forgekit new my-app \
    --spring-boot \
    --group com.example \
    --angular \
    --docker \
    --claude-code

# FastAPI + React (Vite + Tailwind) + auth + Docker
$ forgekit new my-app \
    --fastapi \
    --react \
    --auth \
    --docker \
    --claude-code

# NestJS + JWT auth + Prisma + OpenAPI
$ forgekit new my-api \
    --nestjs \
    --auth \
    --prisma \
    --openapi \
    --claude-code

# Laravel + React + auth
$ forgekit new my-app \
    --laravel \
    --react \
    --auth \
    --docker \
    --claude-code

# FastAPI backend only — no frontend, no Docker
$ forgekit new my-api \
    --fastapi \
    --no-frontend \
    --no-docker

# Spring Boot + Angular + Auth + NgRx + all features
$ forgekit new my-app \
    --spring-boot \
    --group com.example \
    --auth \
    --flyway \
    --openapi \
    --mapstruct \
    --angular \
    --ngrx \
    --ui primeng \
    --preset Aura \
    --docker \
    --ci \
    --claude-code

Add a layer to an existing project

Already have a backend? Add a frontend. Already have a project? Add Docker, CI, or Claude Code config — without touching what's already there. ForgeKit reads forgekit.json to detect the existing setup and asks only the relevant questions.

$ forgekit add react            # Add React frontend
$ forgekit add vue              # Add Vue.js frontend
$ forgekit add angular          # Add Angular frontend
$ forgekit add nestjs --prisma  # Add NestJS backend with Prisma
$ forgekit add nextjs           # Add Next.js fullstack
$ forgekit add docker           # Add Docker Compose
$ forgekit add ci               # Add GitHub Actions CI
$ forgekit add claude-code      # Add Claude Code config
$ forgekit add prettier         # Add Prettier + Husky + lint-staged

Dependent layers are auto-regenerated when needed — adding a frontend to an existing backend also updates Docker Compose and CI configs.

Generated project structure

my-app/
├── backend/                          # Spring Boot 3 / FastAPI
│   └── src/main/java/com/example/myapp/
│       ├── Application.java
│       ├── config/
│       │   ├── SecurityConfig.java       # (--auth)
│       │   └── OpenApiConfig.java
│       └── shared/exception/
│           ├── GlobalExceptionHandler.java
│           └── ApiError.java
│
├── frontend/src/                      # Angular 19 · React 19 · Vue 3
│   ├── # Angular: app.component.ts, app.routes.ts, layout/, features/
│   ├── # React:   main.tsx, App.tsx, router/, hooks/, components/
│   └── # Vue:     main.ts, App.vue, router/, stores/, components/
│
├── docker-compose.yml                    # PostgreSQL 17 + pgAdmin
├── .github/workflows/ci.yml             # GitHub Actions
│
├── CLAUDE.md                             # AI workflow conventions
├── .claude/
│   ├── settings.json
│   ├── hooks/                          # pre-bash.sh, session-start.sh
│   ├── hookify.block-dangerous-rm.local.md
│   ├── hookify.block-force-push.local.md
│   └── skills/                         # Stack-specific AI skills
│
├── .specify/memory/constitution.md      # Architectural constitution
└── forgekit.json                         # Layer manifest (used by forgekit add)

Claude Code integration

ForgeKit generates a complete Claude Code configuration — the only scaffolding tool that does this. Every developer who clones the project gets the same AI conventions without any manual setup.

What's included

Skills copied per stack

Dynamic version resolution

ForgeKit resolves the latest stable versions from npm and Maven Central at generation time — your project is never outdated on day one.

Fallback versions are used if the registry is unreachable.