Skip to content

SubhanshuMG/ForgeKit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

 ForgeKit

The engineering acceleration platform for AI, DevOps, and full-stack teams.

License PRs Welcome DCO npm Docs OpenSSF Best Practices

Coverage Node.js TypeScript Jest CLI

npm downloads GitHub stars GitHub forks Last commit

Docs | Templates | CLI Reference | Blog | Contributing

Interactive Coverage Dashboard

ForgeKit eliminates the setup friction that costs engineering teams days of work before they write a single line of product code. One command scaffolds a fully wired, production-ready project, with the right stack, infrastructure, and tooling already connected.

ForgeKit: scaffold a production-ready project in seconds

Open in GitHub Codespaces   Open in Gitpod


Why ForgeKit?

Modern engineering teams waste too much time before they can ship:

  • Fragmented toolchains, CI/CD, infrastructure, AI workflows, and frontend frameworks all need separate configuration
  • Slow Day-1 onboarding, new projects and new teammates take hours to set up before they're productive
  • Reinventing the wheel, the same scaffolding, Dockerfiles, and pipeline configs are written again and again
  • Burnout from maintenance, keeping tooling up to date takes ~80% of platform team time
  • Poor documentation, knowledge lives in people's heads, not the repo

ForgeKit solves all of this from a single CLI.


Core Features

Feature Command Description
Project Scaffolding forgekit new Beautiful interactive wizard to scaffold any stack in seconds
AI Scaffolding forgekit new --ai "describe your project" AI picks the best template for your description
Template Marketplace forgekit search Search official and community templates
One-Command Deploy forgekit deploy Auto-detect stack and deploy to Vercel/Railway/Fly
Project Health Score forgekit health Gamified 0-100 score across security, quality, testing, docs, DevOps
Dependency Audit forgekit audit Security vulnerabilities + outdated packages report
Stack Doctor forgekit doctor --project Diagnose system prerequisites + project health issues
Environment Sync forgekit env push/pull Encrypted .env file management across environments
Docs Generation forgekit docs generate Auto-generate README from your codebase
Plugin System forgekit plugin add/remove Extend ForgeKit with community plugins
Template Publishing forgekit publish Validate and prepare templates for the community registry

Quick Start

# Interactive wizard with beautiful terminal UI
npx forgekit-cli new

# AI-powered: describe your project, AI picks the template
npx forgekit-cli new --ai "REST API with PostgreSQL and JWT auth"

# Direct scaffolding with a specific template
npx forgekit-cli new my-app --template web-app

# Check your project health (gamified score!)
npx forgekit-cli health

# Audit dependencies for security issues
npx forgekit-cli audit

# Deploy with auto-detected provider
npx forgekit-cli deploy

# Generate docs from your codebase
npx forgekit-cli docs generate

Your project will be ready to run in under 60 seconds.


See It In Action

npx forgekit-cli new my-app --template web-app
✔ Project my-app created successfully!
  16 files created in ./my-app

  → cd my-app && npm run dev

Your project will be fully wired and ready to run.


From the Blog

Why I built ForgeKit — The story behind the project, the problem it solves, and where it's going next.


Templates

Template ID Stack Use Case
web-app Node.js + React + TypeScript + Express Full-stack web application
next-app Next.js + TypeScript + Tailwind CSS Modern React with SSR
api-service Python + FastAPI + PostgreSQL + Docker REST API backend
go-api Go + Gin + PostgreSQL + Docker High-performance API
ml-pipeline Python + Jupyter + MLflow + scikit-learn ML experiment workflow
serverless TypeScript + AWS Lambda Event-driven serverless

More templates are coming. Contribute a template →


GitHub Action

Use ForgeKit directly inside your CI workflows:

- uses: SubhanshuMG/ForgeKit/action@v1
  with:
    template: web-app
    name: my-app

See action/README.md for full usage, inputs, outputs, and matrix build examples.


Architecture

ForgeKit is built as a modular 5-layer system:

Interface Layer  →  CLI / Web Dashboard / API Client
Application Layer  →  Workflow Engine / Task Orchestration
Service Layer  →  Scaffolding / AI / DevOps / Observability modules
Data Layer  →  Config storage / Execution logs / State
Infrastructure Layer  →  CI/CD / Deployment / Monitoring

See architecture.md for the full design.


Roadmap

ForgeKit is being built in focused milestones:

  • Milestone 1 (current), CLI scaffolding engine + 3 starter templates
  • Milestone 2, Web dashboard + AI-assisted workflows
  • Milestone 3, Ephemeral dev environments (preview URLs per PR)
  • Milestone 4, AI Knowledge Hub (codebase Q&A + plugin marketplace)

See ROADMAP.md for full details.


Contributing

ForgeKit is built by engineers, for engineers. Contributions are welcome and encouraged.

The fastest path in:

  1. Pick a good first issue
  2. Fork, branch, and build: npm install && npm run build --workspace=packages/cli
  3. Commit with sign-off: git commit -s -m "your message" (DCO required)
  4. Open a PR

All templates, docs improvements, and bug fixes are welcome. See CONTRIBUTING.md for full details.


Community

  • X/Twitter, follow @forgekit_os for updates
  • LinkedIn, follow ForgeKit on LinkedIn
  • GitHub Discussions, questions, ideas, show-and-tell
  • Discord, real-time collaboration (link coming at launch)
  • Changelog, monthly updates on what shipped

Star History

View star growth chart
Star History Chart

License & Trademark

ForgeKit is open-source software licensed under the Apache License 2.0.

"ForgeKit" and the ForgeKit logo are trademarks of the ForgeKit project maintainers. The Apache 2.0 license grants you rights to use, modify, and distribute the code. It does not grant rights to use the ForgeKit name or logo in ways that imply official endorsement or affiliation. See TRADEMARK.md for permitted uses.

Copyright 2026 ForgeKit Contributors.


Contributors