{"_id":"@adhikareeprayush/stacksmith","name":"@adhikareeprayush/stacksmith","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@adhikareeprayush/stacksmith","version":"0.1.0","description":"The full-stack scaffolding tool that doesn't lock you in.","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"stacksmith":"dist/cli.js"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/adhikareeprayush/stacksmith.git"},"homepage":"https://github.com/adhikareeprayush/stacksmith#readme","bugs":{"url":"https://github.com/adhikareeprayush/stacksmith/issues"},"scripts":{"build":"tsup","dev":"tsup --watch","start":"node dist/cli.js","lint":"eslint .","lint:fix":"eslint . --fix","format":"prettier --write .","format:check":"prettier --check .","typecheck":"tsc --noEmit","test":"vitest run","test:watch":"vitest","prepare":"husky","prepublishOnly":"npm run build"},"keywords":["scaffold","scaffolding","boilerplate","starter","cli","full-stack","fullstack","generator","create-app","project-generator","mern","express","react","mongodb","stacksmith"],"author":{"name":"Stacksmith Contributors"},"license":"MIT","engines":{"node":">=20"},"dependencies":{"@inquirer/prompts":"^7.5.3","chalk":"^5.4.1","commander":"^13.1.0","fs-extra":"^11.3.0","handlebars":"^4.7.8","ora":"^8.2.0","zod":"^3.25.28"},"devDependencies":{"@commitlint/cli":"^19.8.1","@commitlint/config-conventional":"^19.8.1","@eslint/js":"^9.28.0","@types/fs-extra":"^11.0.4","@types/node":"^22.15.29","eslint":"^9.28.0","eslint-config-prettier":"^10.1.5","husky":"^9.1.7","lint-staged":"^16.1.0","prettier":"^3.5.3","tsup":"^8.5.0","typescript":"^5.8.3","typescript-eslint":"^8.33.1","vitest":"^3.2.1"},"lint-staged":{"*.{ts,js,mjs,cjs,json,md}":["prettier --write"],"*.{ts,js,mjs,cjs}":["eslint --fix"]},"gitHead":"0e3f81a7ddd4d82dd87790ebcb88838890582434","_id":"@adhikareeprayush/stacksmith@0.1.0","_nodeVersion":"26.2.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-VcaGBP6DmdM/xXpwy9cCyuGz769aMnJTyFhkSiQ2U27IX1kamgLMFg1+q7CPi6Hh8sVSnMse6lEUuDcJC0ytKQ==","shasum":"ac497010cc34f4ac0efab69beb515be47fc7da25","tarball":"https://registry.npmjs.org/@adhikareeprayush/stacksmith/-/stacksmith-0.1.0.tgz","fileCount":17,"unpackedSize":460411,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC70mj3wLBWSPZxFHJCgmnr0v5FZ85YUZSGMGTye9EzLgIhAM21kEhmKMcoqrpMZC3jFinTqCe/bSwL4yD+Es1FBtdy"}]},"_npmUser":{"name":"adhikareeprayush","email":"adhikareeprayush@gmail.com"},"directories":{},"maintainers":[{"name":"adhikareeprayush","email":"adhikareeprayush@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/stacksmith_0.1.0_1782484283182_0.20009175461778428"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-26T14:31:22.929Z","0.1.0":"2026-06-26T14:31:23.319Z","modified":"2026-06-26T14:31:23.605Z"},"maintainers":[{"name":"adhikareeprayush","email":"adhikareeprayush@gmail.com"}],"description":"The full-stack scaffolding tool that doesn't lock you in.","homepage":"https://github.com/adhikareeprayush/stacksmith#readme","keywords":["scaffold","scaffolding","boilerplate","starter","cli","full-stack","fullstack","generator","create-app","project-generator","mern","express","react","mongodb","stacksmith"],"repository":{"type":"git","url":"git+https://github.com/adhikareeprayush/stacksmith.git"},"author":{"name":"Stacksmith Contributors"},"bugs":{"url":"https://github.com/adhikareeprayush/stacksmith/issues"},"license":"MIT","readme":"# Stacksmith\n\n> The full-stack scaffolding tool that doesn't lock you in.\n\nStacksmith is an interactive CLI that generates production-grade, full-stack boilerplates — personalized to your stack, your database, your auth provider, and your deployment target. No more starting every project by copy-pasting your last one and deleting half of it.\n\n[![npm version](https://img.shields.io/npm/v/@adhikareeprayush/stacksmith.svg)](https://www.npmjs.com/package/@adhikareeprayush/stacksmith)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n[![Status: early access](https://img.shields.io/badge/status-early%20access-orange.svg)](#project-status)\n\n---\n\n## Project status\n\n**Stacksmith is in early access (`v0.1.x`).** The plugin architecture and the long-term\nvision below are real, but only one stack ships end-to-end today:\n\n- ✅ **Shipping now:** the **MERN** preset (Express + React + MongoDB + Mongoose + JWT + Docker)\n  generates a complete, production-shaped project — full server, client, auth, Docker, and config.\n- 🚧 **In progress / planned:** every other frontend, backend, database, ORM, auth provider,\n  preset, and the `add` / `ai` / `update` commands. See the [Roadmap](#roadmap).\n\nIf you run Stacksmith with a stack that isn't implemented yet, you'll get a minimal base project\n(not a full scaffold). We'd rather be upfront about that than surprise you. Contributions that fill\nin the matrix are very welcome — that's exactly what the plugin system is for.\n\n---\n\n## Why Stacksmith?\n\nMost generators give you one opinionated stack and call it a day. Stacksmith is being built so your\nstack is a set of composable choices. The target matrix (✅ = available today, 🚧 = planned):\n\n- **Frontend**: React ✅ · Next.js 🚧 · Vue/Nuxt 🚧 · SvelteKit 🚧 · Astro 🚧\n- **Backend**: Express ✅ · Fastify 🚧 · NestJS 🚧 · Hono 🚧 · tRPC 🚧\n- **Database**: MongoDB ✅ · PostgreSQL 🚧 · MySQL 🚧 · SQLite 🚧 · Supabase 🚧 · PlanetScale 🚧\n- **ORM/ODM**: Mongoose ✅ · Prisma 🚧 · Drizzle 🚧\n- **Auth**: JWT (custom) ✅ · Auth.js 🚧 · Better Auth 🚧 · Lucia 🚧 · Clerk 🚧 · Supabase Auth 🚧\n- **Deployment target**: Docker ✅ · Vercel 🚧 · Railway 🚧 · Render 🚧 · Fly.io 🚧 · AWS 🚧\n\nMERN is the friendly default that works today; the rest is the roadmap we're building toward.\n\n---\n\n## Quick Start\n\nThe MERN stack works end-to-end right now:\n\n```bash\nnpx @adhikareeprayush/stacksmith create my-app --preset mern\n```\n\nOr skip the prompts entirely:\n\n```bash\nnpx @adhikareeprayush/stacksmith create my-app --preset mern -y\n```\n\n> Prefer a shorter command? Install it globally once — `npm i -g @adhikareeprayush/stacksmith` —\n> and then use the `stacksmith` command directly (e.g. `stacksmith create my-app --preset mern`).\n\nThis generates a complete project: an Express server (controllers, services, models, JWT auth,\nvalidation, error handling, logging), a React + Vite client (auth context, pages, UI components,\nAPI layer), `docker-compose.yml`, a pre-filled `.env`, and a `stacksmith.config.json`.\n\n### Presets\n\n| Preset      | Status | Description                                       |\n|-------------|--------|---------------------------------------------------|\n| `mern`      | ✅ available | Express + React + MongoDB (Mongoose) + JWT + Docker |\n| `next-full` | 🚧 planned   | Next.js App Router + Server Actions + Prisma      |\n| `saas`      | 🚧 planned   | Next.js + Postgres + Drizzle + auth + billing     |\n| `api`       | 🚧 planned   | Minimal backend-only API                          |\n| `portfolio` | 🚧 planned   | Static/SSG frontend, no backend                   |\n| `education` | 🚧 planned   | Simplified structure for learning, with docs      |\n\nSelecting a planned preset today produces a minimal base project, not the full stack described above.\n\n---\n\n## What the MERN scaffold gives you\n\n### 🎛️ Interactive wizard\nA guided CLI experience (@inquirer/prompts + Chalk + Ora) walks you through project name, package\nchoices, and environment variables, then pre-fills your `.env`.\n\n### 🗄️ Real database integration\nChoosing MongoDB does more than drop in a config file. Stacksmith generates connection setup, a User\nmodel, auth controllers/services, and validation.\n\n### 🚀 Docker-ready\n`docker-compose.yml` plus per-service Dockerfiles for the client and server.\n\n### ✅ Production-quality defaults\n- TypeScript across client and server\n- Structured logging, centralized error handling, async handlers\n- JWT auth with middleware and validators\n- `.env.example` with documented variables\n\n---\n\n## Planned features\n\nThese are part of the vision but **not implemented yet** — tracked on the [Roadmap](#roadmap):\n\n- 🧩 Plugin-based templates for every category (the loader exists; most plugins don't)\n- 🤖 `stacksmith ai \"<description>\"` — AI-assisted module generation\n- 🔄 `stacksmith add <feature>` — add auth/payments/file-upload after the fact\n- 🧪 `stacksmith update` — update generated boilerplate to latest patterns\n\n---\n\n## Commands\n\n```bash\nstacksmith create <name> --preset mern   # ✅ full MERN scaffold (interactive)\nstacksmith create <name> [flags]         # ✅ non-interactive with --preset mern -y\nstacksmith setup                         # ✅ post-generation: install deps, git init, env setup\nstacksmith doctor                        # ✅ diagnose config/env issues\nstacksmith add <feature>                 # 🚧 not yet implemented\nstacksmith update                        # 🚧 not yet implemented\nstacksmith ai <description>              # 🚧 not yet implemented\n```\n\n---\n\n## Project Structure (generated MERN app)\n\n```\nmy-app/\n├── client/              # React + Vite frontend\n├── server/              # Express + Mongoose backend\n├── docker-compose.yml\n├── stacksmith.config.json\n├── .env / .env.example\n└── README.md\n```\n\n---\n\n## Roadmap\n\n- [ ] Additional presets (`next-full`, `saas`, `api`, `portfolio`, `education`)\n- [ ] More frontends (Next.js, Vue/Nuxt, SvelteKit, Astro)\n- [ ] More backends (Fastify, NestJS, Hono, tRPC)\n- [ ] More databases & ORMs (Postgres, MySQL, SQLite + Prisma, Drizzle)\n- [ ] More auth providers (Auth.js, Better Auth, Lucia, Clerk, Supabase)\n- [ ] More deployment targets (Vercel, Railway, Render, Fly.io, AWS)\n- [ ] `add`, `ai`, and `update` commands\n- [ ] Monorepo (Turborepo) output\n- [ ] Plugin marketplace / community template registry\n\n---\n\n## Contributing\n\nStacksmith is built to be extended, and the most valuable contributions right now are new plugins that\nfill in the stack matrix above. See [CONTRIBUTING.md](CONTRIBUTING.md) for the plugin API and\nsubmission guidelines.\n\n---\n\n## License\n\nMIT © Stacksmith Contributors\n","readmeFilename":"README.md","_rev":"1-faf6fa4b0040d8ec3fdaa031aa077830"}