Stop running 50+ setup commands and stitching incompatible configs manually.
ForgeStack generates production-grade, zero-bloat Monorepos, Docker Compose, Terraform IaC, Kubernetes manifests, OpenTelemetry, and CI/CD pipelines in seconds.
npx @sanskar22/create-forgestack my-appStarting a modern production system requires making dozens of critical architectural choices:
- Monorepo tooling (
pnpm+Turborepo) - Database ORMs (
Prisma,Drizzle,Mongoose) - Distributed caching & job queues (
Redis,BullMQ) - Cloud infrastructure (
AWS ECS,RDS,S3,Terraform,Kubernetes) - Production observability (
OpenTelemetry,Prometheus,Pino,Sentry) - CI/CD automation (
GitHub Actions)
Traditional template repositories are bloated with unneeded dependencies that break when customized. Naive AI generators hallucinate invalid package versions and broken manifests.
ForgeStack introduces a Deterministic Architecture Engine powered by a canonical single source of truth (forge.config.yaml). It statically validates structural anti-patterns, resolves the exact dependency Directed Acyclic Graph (DAG), and emits clean, zero-drift code.
| Package | Version | Purpose |
|---|---|---|
@sanskar22/create-forgestack |
 |
Global Scaffolding CLI (npx @sanskar22/create-forgestack) |
@sanskar22/forge-cli |
 |
In-Project Architecture Manager CLI (forge / npx forge) |
@sanskar22/core |
 |
Deterministic Architecture Engine, Zod Schemas & DAG Resolver |
@sanskar22/templates |
 |
Modular code skeletons, Dockerfiles & Terraform modules |
@sanskar22/generators |
 |
Deterministic File Emitters & Orchestrator |
Run the interactive CLI wizard with zero installation:
npx @sanskar22/create-forgestack my-production-app┌ 🚀 ForgeStack: Architecture-Aware Generator
│
◆ Select project template:
│ ● Full-Stack Application (Monorepo with Frontend + Backend + Shared Packages)
│ ○ Backend API Only
│ ○ Cloud Infrastructure Only (Terraform / Kubernetes)
│
◆ Select backend architecture pattern:
│ ● Modular Monolith (Clean domain boundaries)
│ ○ Clean Architecture (Domain, UseCases, Repositories)
│ ○ Microservices Architecture
│
◆ Select cloud deployment target:
│ ● AWS ECS Fargate + RDS + Terraform
│ ○ Kubernetes (EKS / GKE)
│ ○ Docker Swarm / Standalone Container
└ ✨ Scaffolding production architecture in 5.2s...
Scaffold complete, production-tested architectures with flags:
# Fullstack SaaS (Next.js + Express + Prisma + Redis + BullMQ + AWS ECS Terraform + OTel)
npx @sanskar22/create-forgestack my-saas --preset saas
# Minimal High-Performance REST API with Health Checks, Pino, Docker
npx @sanskar22/create-forgestack my-api --preset minimal-api
# Enterprise AWS Cloud Infrastructure with Terraform (ECS + RDS + ElastiCache + S3)
npx @sanskar22/create-forgestack my-aws-infra --preset infra-aws
# Enterprise Kubernetes Infrastructure (Deployments, Ingress, HPA, Probes, ConfigMaps)
npx @sanskar22/create-forgestack my-k8s --preset infra-k8sInside any ForgeStack-generated project, use the local forge CLI to manage architectural evolution without drift:
# 1. Run environment, runtime, container, and database health diagnostics
npx forge doctor
# 2. Validate architecture rules, compatibility gates, and dependency constraints
npx forge validate
# 3. Render terminal ASCII topology & refresh ARCHITECTURE.md + Mermaid diagrams
npx forge visualize
# 4. Dynamically inject architectural capabilities without manual boilerplate
npx forge add redis
npx forge add bullmq
npx forge add auth
npx forge add s3
npx forge add terraform
npx forge add kubernetes
# 5. Safely prune unneeded services and re-synchronize manifests
npx forge remove bullmq
# 6. Re-synchronize code and infrastructure files from forge.config.yaml
npx forge generate
# 7. Detect architectural drift between filesystem and config
npx forge diff+--------------------------------------------------------------------+
| ForgeStack Generated Topology |
+--------------------------------------------------------------------+
[ Client / Browser ]
|
v
[ Frontend: Next.js 14 App Router (Tailwind CSS) ]
|
v (HTTP / REST API)
[ AWS Application Load Balancer ]
|
v
[ Backend API: Express Modular Monolith on AWS ECS ]
| | |
v v v
[ PostgreSQL ] [ Redis Cache ] [ Telemetry: Prometheus + Pino ]
(via Prisma) |
v
[ BullMQ Worker Process ]
+--------------------------------------------------------------------+
ForgeStack monorepos use pnpm workspaces and Turborepo for optimized caching and fast parallel builds:
my-production-app/
├── apps/
│ ├── web/ # Next.js 14 App Router / React Vite frontend
│ ├── api/ # Express / Fastify modular backend
│ └── worker/ # BullMQ background worker service
│
├── packages/
│ ├── types/ # Shared TypeScript types & DTOs
│ └── config/ # Shared ESLint, Prettier, & tsconfig
│
├── infrastructure/
│ ├── terraform/ # Modular Terraform (VPC, ECS, RDS, S3, Redis)
│ └── k8s/ # Kubernetes (Deployment, Service, Ingress, HPA)
│
├── docker-compose.yml # Local multi-container development environment
├── forge.config.yaml # Canonical architecture declaration (Single Source of Truth)
├── ARCHITECTURE.md # Auto-generated living architecture documentation
├── architecture.mmd # Native Mermaid.js architecture diagram
└── turbo.json # Turborepo task pipeline configuration
ForgeStack prevents common production misconfigurations before they happen:
- 🚫 Ephemeral Queue Mismatches: Warns against running persistent BullMQ worker queues on ephemeral serverless platforms (AWS Lambda).
- 🚫 Storage Disconnects: Ensures database ORMs (
Prisma,Mongoose) match appropriate database engines (PostgreSQL,MongoDB). - 🚫 Container Decoupling: Automatically wires health checks (
/health/ready,/health/live), Prometheus metrics (/metrics), and environment variables when services are added. - 🚫 IaC Synchronization: Auto-generates Terraform variables and Kubernetes secrets matching active backend modules.
# Clone the repository
git clone https://github.com/Sanskar225/forgestack.git
cd forgestack
# Install workspace dependencies
pnpm install
# Build all packages with Turborepo
pnpm run build
# Run comprehensive Vitest unit and integration test suites
pnpm run testDistributed under the MIT License. See LICENSE for more information.