create-better-nest 0.0.1

package/README.md

@@ -0,0 +1,59 @@
+# create-better-nest
+
+The ultimate CLI tool for scaffolding modern, production-ready NestJS applications. Whether you need a simple backend or a full-stack monorepo with end-to-end type safety, `create-better-nest` has you covered.
+
+## ✨ Features
+
+- 🏗️ **Three Powerful Templates:**
+    - **Monorepo (oRPC):** The cutting edge. NestJS + Next.js with complete type safety from backend to frontend using oRPC.
+    - **Monorepo (Basic):** A solid foundation using Turbo, NestJS, and Next.js.
+    - **Standalone Backend:** A clean, pre-configured NestJS setup with Prisma, Swagger, and Docker.
+- 🚀 **Modern Tooling:** Pre-configured with `pnpm`, `Turborepo`, `Prisma`, `Zod`, and `Better Auth`.
+- 🛡️ **Best Practices:** Strict TypeScript configs, ESLint, and organized project structures out of the box.
+
+## 🚀 Quick Start
+
+Run the magic command:
+
+```bash
+npm create better-nest@latest
+```
+
+Follow the interactive prompts to choose your preferred architecture and project name.
+
+## 📦 What you get
+
+### 1. Monorepo (oRPC)
+Perfect for teams wanting tight integration between backend and frontend.
+- **Stack:** NestJS, Next.js, Turborepo, oRPC.
+- **Highlights:** Define your API contract once, and get fully typed clients on the frontend automatically.
+
+### 2. Monorepo (Basic)
+The industry standard for full-stack TypeScript.
+- **Stack:** NestJS, Next.js, Turborepo.
+- **Highlights:** Shared UI libraries, shared types, and shared ESLint configs.
+
+### 3. Standalone Backend
+For when you just need a powerful API.
+- **Stack:** NestJS, Prisma, Swagger.
+- **Highlights:** Clean architecture, Docker-ready, and set up for scale.
+
+## 🔧 Requirements
+
+- Node.js >= 18
+- pnpm (The generated projects rely on pnpm workspaces)
+
+## 🤝 Contributing
+
+We welcome contributions! This repository is a monorepo containing the CLI tool and the templates.
+
+1.  Clone the repo
+2.  Run `pnpm install`
+3.  Test the CLI locally:
+    ```bash
+    pnpm --filter create-better-nest cli
+    ```
+
+## 📄 License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import{intro as u,outro as h,text as v,select as g,isCancel as m,cancel as n,spinner as y}from"@clack/prompts";import{program as d}from"commander";import o from"picocolors";import w from"tiged";import f from"fs-extra";import b from"path";import{execSync as S}from"child_process";async function j(){d.name("better-nest").description("CLI to scaffold better NestJS applications").version("0.0.1"),d.parse(),u(o.bgCyan(o.black(" better-nest ")));let a=await v({message:"What is the name of your project?",placeholder:"my-nest-app",defaultValue:"my-nest-app"});m(a)&&(n("Operation cancelled."),process.exit(0));let s=await g({message:"Select the architecture:",options:[{value:"monorepo",label:"Monorepo"},{value:"standalone",label:"Standalone Backend"}]});m(s)&&(n("Operation cancelled."),process.exit(0));let i="basic";s==="monorepo"&&(i=await g({message:"Select the monorepo variant:",options:[{value:"basic",label:"Basic (Standard)"},{value:"orpc",label:"With oRPC"}]}),m(i)&&(n("Operation cancelled."),process.exit(0)));let e=y();e.start("Scaffolding your project...");let r="github:AnasX7/better-nest/templates";s==="monorepo"?i==="orpc"?r+="/monorepo-orpc":r+="/monorepo-basic":r+="/single-backend";try{let t=w(r,{disableCache:!0,force:!0,verbose:!1}),c=b.resolve(process.cwd(),a);await t.clone(c),e.message("Configuring project...");let p=b.join(c,"package.json");if(await f.pathExists(p)){let l=await f.readJson(p);l.name=a,await f.writeJson(p,l,{spaces:2})}e.message("Initializing git repository...");try{S("git init",{cwd:c,stdio:"ignore"})}catch{}e.stop("Scaffolding complete!"),h(`You're all set! To get started, run:
+
+  ${o.green(`cd ${a}`)}
+  ${o.green("pnpm install")}
+  ${o.green("pnpm dev")}
+`)}catch(t){e.stop("Scaffolding failed."),n(`Error: ${t instanceof Error?t.message:String(t)}`),process.exit(1)}}j().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport {\n  intro,\n  outro,\n  text,\n  select,\n  isCancel,\n  cancel,\n  spinner,\n} from '@clack/prompts'\nimport { program } from 'commander'\nimport pc from 'picocolors'\nimport tiged from 'tiged'\nimport fs from 'fs-extra'\nimport path from 'path'\nimport { execSync } from 'child_process'\n\nasync function main() {\n  program\n    .name('better-nest')\n    .description('CLI to scaffold better NestJS applications')\n    .version('0.0.1')\n\n  program.parse()\n\n  intro(pc.bgCyan(pc.black(' better-nest ')))\n\n  const projectName = await text({\n    message: 'What is the name of your project?',\n    placeholder: 'my-nest-app',\n    defaultValue: 'my-nest-app',\n  })\n\n  if (isCancel(projectName)) {\n    cancel('Operation cancelled.')\n    process.exit(0)\n  }\n\n  const architecture = await select({\n    message: 'Select the architecture:',\n    options: [\n      { value: 'monorepo', label: 'Monorepo' },\n      { value: 'standalone', label: 'Standalone Backend' },\n    ],\n  })\n\n  if (isCancel(architecture)) {\n    cancel('Operation cancelled.')\n    process.exit(0)\n  }\n\n  let variant: string | symbol = 'basic'\n\n  if (architecture === 'monorepo') {\n    variant = await select({\n      message: 'Select the monorepo variant:',\n      options: [\n        { value: 'basic', label: 'Basic (Standard)' },\n        { value: 'orpc', label: 'With oRPC' },\n      ],\n    })\n\n    if (isCancel(variant)) {\n      cancel('Operation cancelled.')\n      process.exit(0)\n    }\n  }\n\n  const s = spinner()\n  s.start('Scaffolding your project...')\n\n  let templatePath = 'github:AnasX7/better-nest/templates'\n\n  if (architecture === 'monorepo') {\n    if (variant === 'orpc') {\n      templatePath += '/monorepo-orpc'\n    } else {\n      templatePath += '/monorepo-basic'\n    }\n  } else {\n    templatePath += '/single-backend'\n  }\n\n  try {\n    const emitter = tiged(templatePath, {\n      disableCache: true,\n      force: true,\n      verbose: false,\n    })\n\n    const projectDir = path.resolve(process.cwd(), projectName as string)\n    await emitter.clone(projectDir)\n\n    s.message('Configuring project...')\n\n    const packageJsonPath = path.join(projectDir, 'package.json')\n    if (await fs.pathExists(packageJsonPath)) {\n      const pkg = await fs.readJson(packageJsonPath)\n      pkg.name = projectName\n      await fs.writeJson(packageJsonPath, pkg, { spaces: 2 })\n    }\n\n    s.message('Initializing git repository...')\n    try {\n      execSync('git init', { cwd: projectDir, stdio: 'ignore' })\n    } catch (e) {\n      // Ignore git init errors if git is not installed or configured\n    }\n\n    s.stop('Scaffolding complete!')\n\n    outro(`You're all set! To get started, run:\n\n  ${pc.green(`cd ${projectName}`)}\n  ${pc.green('pnpm install')}\n  ${pc.green('pnpm dev')}\n`)\n  } catch (error) {\n    s.stop('Scaffolding failed.')\n    cancel(`Error: ${error instanceof Error ? error.message : String(error)}`)\n    process.exit(1)\n  }\n}\n\nmain().catch(console.error)\n"],"mappings":";AACA,OACE,SAAAA,EACA,SAAAC,EACA,QAAAC,EACA,UAAAC,EACA,YAAAC,EACA,UAAAC,EACA,WAAAC,MACK,iBACP,OAAS,WAAAC,MAAe,YACxB,OAAOC,MAAQ,aACf,OAAOC,MAAW,QAClB,OAAOC,MAAQ,WACf,OAAOC,MAAU,OACjB,OAAS,YAAAC,MAAgB,gBAEzB,eAAeC,GAAO,CACpBN,EACG,KAAK,aAAa,EAClB,YAAY,4CAA4C,EACxD,QAAQ,OAAO,EAElBA,EAAQ,MAAM,EAEdP,EAAMQ,EAAG,OAAOA,EAAG,MAAM,eAAe,CAAC,CAAC,EAE1C,IAAMM,EAAc,MAAMZ,EAAK,CAC7B,QAAS,oCACT,YAAa,cACb,aAAc,aAChB,CAAC,EAEGE,EAASU,CAAW,IACtBT,EAAO,sBAAsB,EAC7B,QAAQ,KAAK,CAAC,GAGhB,IAAMU,EAAe,MAAMZ,EAAO,CAChC,QAAS,2BACT,QAAS,CACP,CAAE,MAAO,WAAY,MAAO,UAAW,EACvC,CAAE,MAAO,aAAc,MAAO,oBAAqB,CACrD,CACF,CAAC,EAEGC,EAASW,CAAY,IACvBV,EAAO,sBAAsB,EAC7B,QAAQ,KAAK,CAAC,GAGhB,IAAIW,EAA2B,QAE3BD,IAAiB,aACnBC,EAAU,MAAMb,EAAO,CACrB,QAAS,+BACT,QAAS,CACP,CAAE,MAAO,QAAS,MAAO,kBAAmB,EAC5C,CAAE,MAAO,OAAQ,MAAO,WAAY,CACtC,CACF,CAAC,EAEGC,EAASY,CAAO,IAClBX,EAAO,sBAAsB,EAC7B,QAAQ,KAAK,CAAC,IAIlB,IAAMY,EAAIX,EAAQ,EAClBW,EAAE,MAAM,6BAA6B,EAErC,IAAIC,EAAe,sCAEfH,IAAiB,WACfC,IAAY,OACdE,GAAgB,iBAEhBA,GAAgB,kBAGlBA,GAAgB,kBAGlB,GAAI,CACF,IAAMC,EAAUV,EAAMS,EAAc,CAClC,aAAc,GACd,MAAO,GACP,QAAS,EACX,CAAC,EAEKE,EAAaT,EAAK,QAAQ,QAAQ,IAAI,EAAGG,CAAqB,EACpE,MAAMK,EAAQ,MAAMC,CAAU,EAE9BH,EAAE,QAAQ,wBAAwB,EAElC,IAAMI,EAAkBV,EAAK,KAAKS,EAAY,cAAc,EAC5D,GAAI,MAAMV,EAAG,WAAWW,CAAe,EAAG,CACxC,IAAMC,EAAM,MAAMZ,EAAG,SAASW,CAAe,EAC7CC,EAAI,KAAOR,EACX,MAAMJ,EAAG,UAAUW,EAAiBC,EAAK,CAAE,OAAQ,CAAE,CAAC,CACxD,CAEAL,EAAE,QAAQ,gCAAgC,EAC1C,GAAI,CACFL,EAAS,WAAY,CAAE,IAAKQ,EAAY,MAAO,QAAS,CAAC,CAC3D,MAAY,CAEZ,CAEAH,EAAE,KAAK,uBAAuB,EAE9BhB,EAAM;AAAA;AAAA,IAENO,EAAG,MAAM,MAAMM,CAAW,EAAE,CAAC;AAAA,IAC7BN,EAAG,MAAM,cAAc,CAAC;AAAA,IACxBA,EAAG,MAAM,UAAU,CAAC;AAAA,CACvB,CACC,OAASe,EAAO,CACdN,EAAE,KAAK,qBAAqB,EAC5BZ,EAAO,UAAUkB,aAAiB,MAAQA,EAAM,QAAU,OAAOA,CAAK,CAAC,EAAE,EACzE,QAAQ,KAAK,CAAC,CAChB,CACF,CAEAV,EAAK,EAAE,MAAM,QAAQ,KAAK","names":["intro","outro","text","select","isCancel","cancel","spinner","program","pc","tiged","fs","path","execSync","main","projectName","architecture","variant","s","templatePath","emitter","projectDir","packageJsonPath","pkg","error"]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "create-better-nest",
+  "version": "0.0.1",
+  "description": "A CLI tool for creating better NestJS applications",
+  "main": "./dist/index.js",
+  "bin": {
+    "better-nest": "./dist/index.js",
+    "create-better-nest": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
+    "dev": "tsx watch src/index.ts",
+    "cli": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint .",
+    "dev:build": "tsup --watch --onSuccess \"node dist/index.js\""
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.2.0",
+    "picocolors": "^1.0.0",
+    "tiged": "^2.12.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.0",
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.19.3",
+    "typescript": "^5.0.0"
+  }
+}