@exanderal/stackcraft 0.1.1 → 0.1.2

package/README.md

@@ -10,21 +10,68 @@ Spin up a production-ready monorepo in one command.
 npx @exanderal/stackcraft
 ```
 
-Follow the prompts. You'll end up with an Nx monorepo with a NestJS API and your choice of Vite + React or Next.js frontend — deps installed, ready to run.
+Follow the prompts — you'll have an Nx monorepo with deps installed and ready to run.
 
 ## What you get
 
-- Nx monorepo with `apps/` and `packages/`
-- NestJS REST API (`apps/api`)
-- Vite + React or Next.js (`apps/web`)
-- Every app has `dev`, `build`, `lint` scripts wired into Nx
+```
+your-project/
+├── apps/
+│   ├── backend/          # NestJS REST API
+│   └── web/              # Vite + React or Next.js
+├── packages/             # shared code
+└── tools/
+    └── generators/       # local Nx code generators
+```
+
+### Backend (`apps/backend`)
+
+- NestJS with TypeORM
+- PostgreSQL or MySQL
+- Repository/Service abstraction layer (`EntityRepository`, `EntityService`)
+- Module-based structure under `src/modules/` — each module owns its model, repository, and service
+- HTTP controllers live separately in `src/api/`
+
+### Frontend (`apps/web`)
+
+- Vite + React or Next.js
+- Tailwind CSS v4
+- TypeScript
+
+## Running the project
+
+Each app has the same scripts:
+
+```sh
+pnpm dev        # start all apps in parallel
+pnpm build      # build all apps
+pnpm test       # run all tests
+pnpm lint       # lint all apps
+```
+
+Or target a specific app:
+
+```sh
+pnpm nx run backend:dev
+pnpm nx run web:dev
+```
+
+## Code generation
+
+Generate a new backend module:
+
+```sh
+pnpm generate:module --name=trainer
+```
+
+This creates `apps/backend/src/modules/trainer/` with a model, repository, service, module, and integration test. Add `--crud` to also generate a CRUD controller in `src/api/trainer/`.
 
 ## Stack
 
 - **Monorepo** — Nx
 - **Package manager** — pnpm or npm
-- **Backend** — NestJS
-- **Frontend** — Vite + React or Next.js
+- **Backend** — NestJS, TypeORM, PostgreSQL/MySQL
+- **Frontend** — Vite + React or Next.js, Tailwind CSS v4
 
 ## Roadmap
 

package/dist/create/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/create/index.ts"],"names":[],"mappings":"AAKA,wBAAsB,MAAM,kBAmD3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/create/index.ts"],"names":[],"mappings":"AAKA,wBAAsB,MAAM,kBAgE3B"}

package/dist/create/index.js

@@ -23,6 +23,17 @@ export async function create() {
         cancel('Cancelled.');
         process.exit(0);
     }
+    const database = await select({
+        message: 'Database',
+        options: [
+            { value: 'postgres', label: 'PostgreSQL', hint: 'recommended' },
+            { value: 'mysql', label: 'MySQL' },
+        ],
+    });
+    if (isCancel(database)) {
+        cancel('Cancelled.');
+        process.exit(0);
+    }
     const packageManager = await select({
         message: 'Package manager',
         options: [
@@ -38,6 +49,7 @@ export async function create() {
         projectName: projectName,
         frontend: frontend,
         backend: 'nestjs-rest',
+        database: database,
         packageManager: packageManager,
         targetDir: resolve(process.cwd(), projectName),
     };

package/dist/create/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/create/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,KAAK,CAAC,kDAAkD,CAAC,CAAA;IAEzD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;QAC7B,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;KAC/C,CAAC,CAAA;IACF,IAAI,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,YAAY,CAAC,CAAA;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;QAC5B,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,iCAAiC,EAAE;YACjF,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,+BAA+B,EAAE;SAC7E;KACF,CAAC,CAAA;IACF,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,YAAY,CAAC,CAAA;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC;QAClC,OAAO,EAAE,iBAAiB;QAC1B,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE;YACrD,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;SAC/B;KACF,CAAC,CAAA;IACF,IAAI,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,YAAY,CAAC,CAAA;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,MAAM,GAAkB;QAC5B,WAAW,EAAE,WAAqB;QAClC,QAAQ,EAAE,QAAoB;QAC9B,OAAO,EAAE,aAAwB;QACjC,cAAc,EAAE,cAAgC;QAChD,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAqB,CAAC;KACzD,CAAA;IAED,MAAM,CAAC,GAAG,OAAO,EAAE,CAAA;IACnB,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAA;IACtC,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;IAC/C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAEf,KAAK,CAAC,MAAM,MAAM,CAAC,WAAW,OAAO,MAAM,CAAC,cAAc,MAAM,CAAC,CAAA;AACnE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/create/index.ts"],"names":[],"mappings":"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"}

package/dist/create/scaffolders/__tests__/web-vite.test.js

@@ -10,6 +10,7 @@ const CONFIG = {
     projectName: 'my-app',
     frontend: 'vite',
     backend: 'nestjs-rest',
+    database: 'postgres',
     packageManager: 'pnpm',
     targetDir: '/tmp/my-app',
 };

package/dist/create/scaffolders/__tests__/web-vite.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-vite.test.js","sourceRoot":"","sources":["../../../../src/create/scaffolders/__tests__/web-vite.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE5D,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;IAC3C,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;IACxC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;IACtC,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;IACvC,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;CAChD,CAAC,CAAC,CAAA;AAEH,MAAM,MAAM,GAAG;IACb,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,MAAe;IACzB,OAAO,EAAE,aAAsB;IAC/B,cAAc,EAAE,MAAe;IAC/B,SAAS,EAAE,aAAa;CACzB,CAAA;AAED,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;IAEnC,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;QAClD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAA;QAEvD,MAAM,YAAY,CAAC,MAAM,CAAC,CAAA;QAE1B,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAChC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,EACnC,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;QAC/C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAA;QAEvD,MAAM,YAAY,CAAC,MAAM,CAAC,CAAA;QAE1B,MAAM,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAC7B,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,EACnC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,EACnC,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"web-vite.test.js","sourceRoot":"","sources":["../../../../src/create/scaffolders/__tests__/web-vite.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE5D,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;IAC3C,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;IACxC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;IACtC,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;IACvC,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;CAChD,CAAC,CAAC,CAAA;AAEH,MAAM,MAAM,GAAG;IACb,WAAW,EAAE,QAAQ;IACrB,QAAQ,EAAE,MAAe;IACzB,OAAO,EAAE,aAAsB;IAC/B,QAAQ,EAAE,UAAmB;IAC7B,cAAc,EAAE,MAAe;IAC/B,SAAS,EAAE,aAAa;CACzB,CAAA;AAED,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;IAEnC,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;QAClD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAA;QAEvD,MAAM,YAAY,CAAC,MAAM,CAAC,CAAA;QAE1B,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAChC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,EACnC,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;QAC/C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAA;QAEvD,MAAM,YAAY,CAAC,MAAM,CAAC,CAAA;QAE1B,MAAM,CAAC,EAAE,CAAC,CAAC,oBAAoB,CAC7B,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,EACnC,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,EACnC,EAAE,SAAS,EAAE,IAAI,EAAE,CACpB,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/create/scaffolders/api-nestjs-rest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-nestjs-rest.d.ts","sourceRoot":"","sources":["../../../src/create/scaffolders/api-nestjs-rest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAMhD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,aAAa,iBAO7D"}
+{"version":3,"file":"api-nestjs-rest.d.ts","sourceRoot":"","sources":["../../../src/create/scaffolders/api-nestjs-rest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAWhD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,aAAa,iBAa7D"}

package/dist/create/scaffolders/api-nestjs-rest.js

@@ -1,14 +1,31 @@
-import { mkdir } from 'node:fs/promises';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { copyTemplate } from './utils/copy.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const TEMPLATES_DIR = join(__dirname, '..', '..', '..', 'templates');
+const DB_CONFIG = {
+    postgres: { type: 'postgres', port: '5432', driver: 'pg', driverVersion: '^8.0.0', typesPackage: '@types/pg', typesVersion: '^8.0.0' },
+    mysql: { type: 'mysql', port: '3306', driver: 'mysql2', driverVersion: '^3.0.0', typesPackage: null, typesVersion: null },
+};
 export async function scaffoldNestjsRest(config) {
-    const appDir = join(config.targetDir, 'apps', 'api');
+    const appDir = join(config.targetDir, 'apps', 'backend');
     await mkdir(appDir, { recursive: true });
+    const db = DB_CONFIG[config.database];
     await copyTemplate(join(TEMPLATES_DIR, 'api-nestjs-rest'), appDir, {
         projectName: config.projectName,
+        dbType: db.type,
+        dbPort: db.port,
     });
+    await injectDbDriver(appDir, db);
+}
+async function injectDbDriver(appDir, db) {
+    const pkgPath = join(appDir, 'package.json');
+    const pkg = JSON.parse(await readFile(pkgPath, 'utf-8'));
+    pkg.dependencies[db.driver] = db.driverVersion;
+    if (db.typesPackage) {
+        pkg.devDependencies[db.typesPackage] = db.typesVersion;
+    }
+    await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
 }
 //# sourceMappingURL=api-nestjs-rest.js.map

package/dist/create/scaffolders/api-nestjs-rest.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-nestjs-rest.js","sourceRoot":"","sources":["../../../src/create/scaffolders/api-nestjs-rest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACzD,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAA;AAEpE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAqB;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;IACpD,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAExC,MAAM,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE;QACjE,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"api-nestjs-rest.js","sourceRoot":"","sources":["../../../src/create/scaffolders/api-nestjs-rest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACzD,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAA;AAEpE,MAAM,SAAS,GAAG;IAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE;IACtI,KAAK,EAAK,EAAE,IAAI,EAAE,OAAO,EAAK,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;CACvH,CAAA;AAEV,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAqB;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;IACxD,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAExC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAErC,MAAM,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE;QACjE,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,EAAE,CAAC,IAAI;QACf,MAAM,EAAE,EAAE,CAAC,IAAI;KAChB,CAAC,CAAA;IAEF,MAAM,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAClC,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,EAA4C;IACxF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;IAExD,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAA;IAE9C,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC;QACpB,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,YAAY,CAAA;IACxD,CAAC;IAED,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;AACxE,CAAC"}

package/dist/create/types.d.ts

@@ -1,10 +1,12 @@
 export type PackageManager = 'pnpm' | 'npm';
 export type Frontend = 'vite' | 'nextjs';
 export type Backend = 'nestjs-rest';
+export type Database = 'postgres' | 'mysql';
 export interface ProjectConfig {
     projectName: string;
     frontend: Frontend;
     backend: Backend;
+    database: Database;
     packageManager: PackageManager;
     targetDir: string;
 }

package/dist/create/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/create/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,CAAA;AAC3C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;AACxC,MAAM,MAAM,OAAO,GAAG,aAAa,CAAA;AAEnC,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,QAAQ,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,cAAc,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/create/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,CAAA;AAC3C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;AACxC,MAAM,MAAM,OAAO,GAAG,aAAa,CAAA;AACnC,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAA;AAE3C,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,QAAQ,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,QAAQ,CAAA;IAClB,cAAc,EAAE,cAAc,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exanderal/stackcraft",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Opinionated full-stack project scaffolding CLI",
   "type": "module",
   "bin": {

package/templates/api-nestjs-rest/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "{{projectName}}-api",
+  "name": "{{projectName}}-backend",
   "version": "0.0.1",
   "description": "",
   "author": "",
@@ -22,10 +22,13 @@
   },
   "dependencies": {
     "@nestjs/common": "^11.0.1",
+    "@nestjs/config": "^3.0.0",
     "@nestjs/core": "^11.0.1",
     "@nestjs/platform-express": "^11.0.1",
+    "@nestjs/typeorm": "^10.0.0",
     "reflect-metadata": "^0.2.2",
-    "rxjs": "^7.8.1"
+    "rxjs": "^7.8.1",
+    "typeorm": "^0.3.0"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",

package/templates/api-nestjs-rest/project.json

@@ -1,5 +1,5 @@
 {
-  "name": "api",
+  "name": "backend",
   "targets": {
     "dev": {
       "executor": "nx:run-commands",

package/templates/api-nestjs-rest/src/app.module.ts

@@ -1,10 +1,13 @@
 import { Module } from '@nestjs/common';
-import { AppController } from './app.controller';
-import { AppService } from './app.service';
+import { ConfigModule } from '@nestjs/config';
+import { DatabaseModule } from './modules/database/database.module';
+import { HealthModule } from './modules/health/health.module';
 
 @Module({
-  imports: [],
-  controllers: [AppController],
-  providers: [AppService],
+  imports: [
+    ConfigModule.forRoot({ isGlobal: true }),
+    DatabaseModule,
+    HealthModule,
+  ],
 })
 export class AppModule {}

package/templates/api-nestjs-rest/src/common/entities/base.entity.ts

@@ -0,0 +1,16 @@
+import {
+  CreateDateColumn,
+  PrimaryGeneratedColumn,
+  UpdateDateColumn,
+} from 'typeorm';
+
+export abstract class BaseEntity {
+  @PrimaryGeneratedColumn('uuid')
+  id: string;
+
+  @CreateDateColumn()
+  createdAt: Date;
+
+  @UpdateDateColumn()
+  updatedAt: Date;
+}

package/templates/api-nestjs-rest/src/common/repositories/entity.repository.ts

@@ -0,0 +1,21 @@
+import { DeepPartial } from 'typeorm';
+import { BaseEntity } from '../entities/base.entity';
+import { ReadonlyEntityRepository } from './readonly-entity.repository';
+
+export abstract class EntityRepository<
+  T extends BaseEntity,
+> extends ReadonlyEntityRepository<T> {
+  async create(data: DeepPartial<T>): Promise<T> {
+    const entity = this.repo.create(data);
+    return this.repo.save(entity);
+  }
+
+  async update(id: string, data: DeepPartial<T>): Promise<T> {
+    await this.repo.update(id, data as any);
+    return this.findById(id) as Promise<T>;
+  }
+
+  async remove(id: string): Promise<void> {
+    await this.repo.delete(id);
+  }
+}

package/templates/api-nestjs-rest/src/common/repositories/readonly-entity.repository.ts

@@ -0,0 +1,22 @@
+import { FindManyOptions, FindOptionsWhere, In, Repository } from 'typeorm';
+import { BaseEntity } from '../entities/base.entity';
+
+export abstract class ReadonlyEntityRepository<T extends BaseEntity> {
+  constructor(protected readonly repo: Repository<T>) {}
+
+  findAll(options?: FindManyOptions<T>): Promise<T[]> {
+    return this.repo.find(options);
+  }
+
+  findByIds(ids: string[]): Promise<T[]> {
+    return this.repo.findBy({ id: In(ids) } as FindOptionsWhere<T>);
+  }
+
+  findById(id: string): Promise<T | null> {
+    return this.repo.findOneBy({ id } as FindOptionsWhere<T>);
+  }
+
+  findOne(where: FindOptionsWhere<T>): Promise<T | null> {
+    return this.repo.findOneBy(where);
+  }
+}

package/templates/api-nestjs-rest/src/common/services/entity.service.ts

@@ -0,0 +1,24 @@
+import { DeepPartial } from 'typeorm';
+import { BaseEntity } from '../entities/base.entity';
+import { EntityRepository } from '../repositories/entity.repository';
+import { ReadonlyEntityService } from './readonly-entity.service';
+
+export abstract class EntityService<
+  T extends BaseEntity,
+> extends ReadonlyEntityService<T> {
+  constructor(protected readonly repository: EntityRepository<T>) {
+    super(repository);
+  }
+
+  create(data: DeepPartial<T>): Promise<T> {
+    return this.repository.create(data);
+  }
+
+  update(id: string, data: DeepPartial<T>): Promise<T> {
+    return this.repository.update(id, data);
+  }
+
+  remove(id: string): Promise<void> {
+    return this.repository.remove(id);
+  }
+}

package/templates/api-nestjs-rest/src/common/services/readonly-entity.service.ts

@@ -0,0 +1,23 @@
+import { FindManyOptions, FindOptionsWhere } from 'typeorm';
+import { BaseEntity } from '../entities/base.entity';
+import { ReadonlyEntityRepository } from '../repositories/readonly-entity.repository';
+
+export abstract class ReadonlyEntityService<T extends BaseEntity> {
+  constructor(protected readonly repository: ReadonlyEntityRepository<T>) {}
+
+  findAll(options?: FindManyOptions<T>): Promise<T[]> {
+    return this.repository.findAll(options);
+  }
+
+  findByIds(ids: string[]): Promise<T[]> {
+    return this.repository.findByIds(ids);
+  }
+
+  findById(id: string): Promise<T | null> {
+    return this.repository.findById(id);
+  }
+
+  findOne(where: FindOptionsWhere<T>): Promise<T | null> {
+    return this.repository.findOne(where);
+  }
+}

package/templates/api-nestjs-rest/src/modules/database/database.module.ts

@@ -0,0 +1,18 @@
+import { Module } from '@nestjs/common';
+import { TypeOrmModule } from '@nestjs/typeorm';
+
+@Module({
+  imports: [
+    TypeOrmModule.forRoot({
+      type: '{{dbType}}' as 'postgres' | 'mysql',
+      host: process.env.DB_HOST ?? 'localhost',
+      port: parseInt(process.env.DB_PORT ?? '{{dbPort}}', 10),
+      username: process.env.DB_USER ?? 'postgres',
+      password: process.env.DB_PASSWORD ?? '',
+      database: process.env.DB_NAME ?? '{{projectName}}',
+      entities: [],
+      synchronize: process.env.NODE_ENV !== 'production',
+    }),
+  ],
+})
+export class DatabaseModule {}

package/templates/api-nestjs-rest/src/modules/health/__tests__/health.controller.spec.ts

@@ -0,0 +1,20 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { HealthController } from './health.controller';
+import { HealthService } from './health.service';
+
+describe('HealthController', () => {
+  let controller: HealthController;
+
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      controllers: [HealthController],
+      providers: [HealthService],
+    }).compile();
+
+    controller = module.get<HealthController>(HealthController);
+  });
+
+  it('returns ok status', () => {
+    expect(controller.check()).toEqual({ status: 'ok' });
+  });
+});

package/templates/api-nestjs-rest/src/modules/health/__tests__/health.service.spec.ts

@@ -0,0 +1,18 @@
+import { Test, TestingModule } from '@nestjs/testing';
+import { HealthService } from './health.service';
+
+describe('HealthService', () => {
+  let service: HealthService;
+
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      providers: [HealthService],
+    }).compile();
+
+    service = module.get<HealthService>(HealthService);
+  });
+
+  it('returns ok status', () => {
+    expect(service.check()).toEqual({ status: 'ok' });
+  });
+});

package/templates/api-nestjs-rest/src/modules/health/health.controller.ts

@@ -0,0 +1,12 @@
+import { Controller, Get } from '@nestjs/common';
+import { HealthService } from './health.service';
+
+@Controller('health')
+export class HealthController {
+  constructor(private readonly healthService: HealthService) {}
+
+  @Get()
+  check() {
+    return this.healthService.check();
+  }
+}

package/templates/api-nestjs-rest/src/modules/health/health.module.ts

@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { HealthController } from './health.controller';
+import { HealthService } from './health.service';
+
+@Module({
+  controllers: [HealthController],
+  providers: [HealthService],
+})
+export class HealthModule {}

package/templates/api-nestjs-rest/src/modules/health/health.service.ts

@@ -0,0 +1,8 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class HealthService {
+  check() {
+    return { status: 'ok' };
+  }
+}

package/templates/api-nestjs-rest/test/app.e2e-spec.ts

@@ -1,10 +1,10 @@
-import { Test, TestingModule } from '@nestjs/testing';
 import { INestApplication } from '@nestjs/common';
+import { Test, TestingModule } from '@nestjs/testing';
 import * as request from 'supertest';
 import { App } from 'supertest/types';
 import { AppModule } from './../src/app.module';
 
-describe('AppController (e2e)', () => {
+describe('App (e2e)', () => {
   let app: INestApplication<App>;
 
   beforeEach(async () => {
@@ -16,10 +16,14 @@ describe('AppController (e2e)', () => {
     await app.init();
   });
 
-  it('/ (GET)', () => {
+  afterEach(async () => {
+    await app.close();
+  });
+
+  it('/health (GET)', () => {
     return request(app.getHttpServer())
-      .get('/')
+      .get('/health')
       .expect(200)
-      .expect('Hello World!');
+      .expect({ status: 'ok' });
   });
 });

package/templates/base/package.json

@@ -6,9 +6,11 @@
     "dev": "nx run-many -t dev",
     "build": "nx run-many -t build",
     "test": "nx run-many -t test",
-    "lint": "nx run-many -t lint"
+    "lint": "nx run-many -t lint",
+    "generate:module": "nx g @local/generators:module"
   },
   "devDependencies": {
+    "@nx/devkit": "^20.0.0",
     "nx": "^20.0.0"
   }
 }

package/templates/base/pnpm-workspace.yaml

@@ -1,3 +1,4 @@
 packages:
   - 'apps/*'
   - 'packages/*' # shared code: graphql types, ui components, etc.
+  - 'tools/generators'

package/templates/base/tools/generators/generators.json

@@ -0,0 +1,9 @@
+{
+  "generators": {
+    "module": {
+      "factory": "./module/index",
+      "schema": "./module/schema.json",
+      "description": "Create a NestJS module"
+    }
+  }
+}

package/templates/base/tools/generators/module/crud-files/__fileName__.controller.ts__tmpl__

@@ -0,0 +1,36 @@
+import {
+  Controller,
+  Delete,
+  Get,
+  Param,
+  ParseUUIDPipe,
+  Query,
+} from '@nestjs/common';
+import { FindManyOptions } from 'typeorm';
+import { <%= className %>Model } from '../../modules/<%= fileName %>/<%= fileName %>.model';
+import { <%= className %>Service } from '../../modules/<%= fileName %>/<%= fileName %>.service';
+
+@Controller('<%= fileName %>s')
+export class <%= className %>Controller {
+  constructor(private readonly service: <%= className %>Service) {}
+
+  @Get()
+  findAll(@Query() query: FindManyOptions<<%= className %>Model>) {
+    return this.service.findAll(query);
+  }
+
+  @Get('by-ids')
+  findByIds(@Query('ids') ids: string) {
+    return this.service.findByIds(ids.split(','));
+  }
+
+  @Get(':id')
+  findById(@Param('id', ParseUUIDPipe) id: string) {
+    return this.service.findById(id);
+  }
+
+  @Delete(':id')
+  remove(@Param('id', ParseUUIDPipe) id: string) {
+    return this.service.remove(id);
+  }
+}

package/templates/base/tools/generators/module/files/__fileName__.model.ts__tmpl__

@@ -0,0 +1,8 @@
+import { Column, Entity } from 'typeorm';
+import { BaseEntity } from '../../common/entities/base.entity';
+
+@Entity('<%= fileName %>s')
+export class <%= className %>Model extends BaseEntity {
+  // @Column()
+  // name: string;
+}

package/templates/base/tools/generators/module/files/__fileName__.module.ts__tmpl__

@@ -0,0 +1,12 @@
+import { Module } from '@nestjs/common';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { <%= className %>Model } from './<%= fileName %>.model';
+import { <%= className %>Repository } from './<%= fileName %>.repository';
+import { <%= className %>Service } from './<%= fileName %>.service';
+
+@Module({
+  imports: [TypeOrmModule.forFeature([<%= className %>Model])],
+  providers: [<%= className %>Service, <%= className %>Repository],
+  exports: [<%= className %>Service, <%= className %>Repository],
+})
+export class <%= className %>Module {}

package/templates/base/tools/generators/module/files/__fileName__.repository.ts__tmpl__

@@ -0,0 +1,15 @@
+import { Injectable } from '@nestjs/common';
+import { InjectRepository } from '@nestjs/typeorm';
+import { Repository } from 'typeorm';
+import { EntityRepository } from '../../common/repositories/entity.repository';
+import { <%= className %>Model } from './<%= fileName %>.model';
+
+@Injectable()
+export class <%= className %>Repository extends EntityRepository<<%= className %>Model> {
+  constructor(
+    @InjectRepository(<%= className %>Model)
+    repo: Repository<<%= className %>Model>,
+  ) {
+    super(repo);
+  }
+}

package/templates/base/tools/generators/module/files/__fileName__.service.ts__tmpl__

@@ -0,0 +1,11 @@
+import { Injectable } from '@nestjs/common';
+import { EntityService } from '../../common/services/entity.service';
+import { <%= className %>Model } from './<%= fileName %>.model';
+import { <%= className %>Repository } from './<%= fileName %>.repository';
+
+@Injectable()
+export class <%= className %>Service extends EntityService<<%= className %>Model> {
+  constructor(repository: <%= className %>Repository) {
+    super(repository);
+  }
+}

package/templates/base/tools/generators/module/files/__tests__/__fileName__.integration.spec.ts__tmpl__

@@ -0,0 +1,31 @@
+import { Test } from '@nestjs/testing';
+import { getRepositoryToken } from '@nestjs/typeorm';
+import { Repository } from 'typeorm';
+import { <%= className %>Model } from '../<%= fileName %>.model';
+import { <%= className %>Module } from '../<%= fileName %>.module';
+import { <%= className %>Service } from '../<%= fileName %>.service';
+
+describe('<%= className %>Service', () => {
+  let service: <%= className %>Service;
+
+  beforeAll(async () => {
+    const module = await Test.createTestingModule({
+      imports: [<%= className %>Module],
+    })
+      .overrideProvider(getRepositoryToken(<%= className %>Model))
+      .useValue({
+        find: jest.fn(),
+        findOne: jest.fn(),
+        findOneBy: jest.fn(),
+        save: jest.fn(),
+        delete: jest.fn(),
+      } satisfies Partial<Repository<<%= className %>Model>>)
+      .compile();
+
+    service = module.get(<%= className %>Service);
+  });
+
+  it('is defined', () => {
+    expect(service).toBeDefined();
+  });
+});

package/templates/base/tools/generators/module/index.js

@@ -0,0 +1,44 @@
+const { formatFiles, generateFiles, names } = require('@nx/devkit');
+const { execSync } = require('node:child_process');
+const { join } = require('node:path');
+
+module.exports = async function (tree, options) {
+  const n = names(options.name);
+  const modulePath = `apps/backend/src/modules/${n.fileName}`;
+
+  generateFiles(
+    tree,
+    join(__dirname, 'files'),
+    modulePath,
+    { ...n, tmpl: '' },
+  );
+
+  if (options.crud) {
+    generateFiles(
+      tree,
+      join(__dirname, 'crud-files'),
+      `apps/backend/src/api/${n.fileName}`,
+      { ...n, tmpl: '' },
+    );
+  }
+
+  await formatFiles(tree);
+
+  console.log(`\n✓ Module created at ${modulePath}/`);
+  console.log(`  → Import ${n.className}Module in app.module.ts\n`);
+
+  if (options.crud) {
+    console.log(`✓ Controller created at apps/backend/src/api/${n.fileName}/`);
+    console.log(`  → Add ${n.className}Controller to a module and import ${n.className}Module there\n`);
+  }
+
+  return () => {
+    const targets = [modulePath];
+    if (options.crud) targets.push(`apps/backend/src/api/${n.fileName}`);
+
+    execSync(`npx prettier --write ${targets.join(' ')}`, {
+      cwd: tree.root,
+      stdio: 'inherit',
+    });
+  };
+};

package/templates/base/tools/generators/module/schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "cli": "nx",
+  "id": "module",
+  "title": "Create a NestJS module",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Module name, singular lowercase (e.g. trainer)",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      }
+    },
+    "crud": {
+      "type": "boolean",
+      "description": "Generate a CRUD controller in src/api/<name>/",
+      "default": false,
+      "x-prompt": "Generate a CRUD controller?"
+    }
+  },
+  "required": ["name"]
+}

package/templates/base/tools/generators/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@local/generators",
+  "version": "0.0.1",
+  "private": true,
+  "generators": "./generators.json"
+}

package/templates/web-nextjs/package.json

@@ -14,10 +14,13 @@
     "react-dom": "19.2.4"
   },
   "devDependencies": {
+    "@tailwindcss/postcss": "^4.0.0",
     "@types/node": "^20",
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "babel-plugin-react-compiler": "1.0.0",
+    "postcss": "^8.0.0",
+    "tailwindcss": "^4.0.0",
     "typescript": "^5"
   }
 }

package/templates/web-nextjs/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+}
+
+export default config

package/templates/web-nextjs/src/app/globals.css

@@ -0,0 +1 @@
+@import "tailwindcss";

package/templates/web-nextjs/src/components/TemplateComponent/TemplateComponent.behaviour.ts

@@ -0,0 +1,39 @@
+import { useState } from "react";
+
+type UseTemplateComponent = {
+  state: {
+    count: number;
+  };
+  handlers: {
+    handleCountIncrement: () => void;
+    handleCountDecrement: () => void;
+    handleCountReset: () => void;
+  };
+};
+
+export const useTemplateComponent = (): UseTemplateComponent => {
+  const [count, setCount] = useState<number>(0);
+
+  const handleCountIncrement = () => {
+    setCount((prev) => prev + 1);
+  };
+
+  const handleCountDecrement = () => {
+    setCount((prev) => prev - 1);
+  };
+
+  const handleCountReset = () => {
+    setCount(0);
+  };
+
+  return {
+    state: {
+      count,
+    },
+    handlers: {
+      handleCountIncrement,
+      handleCountDecrement,
+      handleCountReset,
+    },
+  };
+};

package/templates/web-nextjs/src/components/TemplateComponent/TemplateComponent.tsx

@@ -0,0 +1,14 @@
+import React from "react";
+import { useTemplateComponent } from "./TemplateComponent.behaviour";
+
+export const TemplateComponent = () => {
+  const { state, handlers } = useTemplateComponent();
+  return (
+    <div>
+      <div>Count: {state.count}</div>
+      <button onClick={handlers.handleCountIncrement}>Increment</button>
+      <button onClick={handlers.handleCountDecrement}>Decrement</button>
+      <button onClick={handlers.handleCountReset}>Reset</button>
+    </div>
+  );
+};

package/templates/web-vite/package.json

@@ -25,6 +25,8 @@
     "globals": "^17.4.0",
     "typescript": "~5.9.3",
     "typescript-eslint": "^8.57.0",
+    "@tailwindcss/vite": "^4.0.0",
+    "tailwindcss": "^4.0.0",
     "vite": "^8.0.1"
   }
 }

package/templates/web-vite/src/components/TemplateComponent/TemplateComponent.behaviour.ts

@@ -0,0 +1,39 @@
+import { useState } from "react";
+
+type UseTemplateComponent = {
+  state: {
+    count: number;
+  };
+  handlers: {
+    handleCountIncrement: () => void;
+    handleCountDecrement: () => void;
+    handleCountReset: () => void;
+  };
+};
+
+export const useTemplateComponent = (): UseTemplateComponent => {
+  const [count, setCount] = useState<number>(0);
+
+  const handleCountIncrement = () => {
+    setCount((prev) => prev + 1);
+  };
+
+  const handleCountDecrement = () => {
+    setCount((prev) => prev - 1);
+  };
+
+  const handleCountReset = () => {
+    setCount(0);
+  };
+
+  return {
+    state: {
+      count,
+    },
+    handlers: {
+      handleCountIncrement,
+      handleCountDecrement,
+      handleCountReset,
+    },
+  };
+};

package/templates/web-vite/src/components/TemplateComponent/TemplateComponent.tsx

@@ -0,0 +1,14 @@
+import React from "react";
+import { useTemplateComponent } from "./TemplateComponent.behaviour";
+
+export const TemplateComponent = () => {
+  const { state, handlers } = useTemplateComponent();
+  return (
+    <div>
+      <div>Count: {state.count}</div>
+      <button onClick={handlers.handleCountIncrement}>Increment</button>
+      <button onClick={handlers.handleCountDecrement}>Decrement</button>
+      <button onClick={handlers.handleCountReset}>Reset</button>
+    </div>
+  );
+};

package/templates/web-vite/src/index.css

@@ -1,8 +1 @@
-*, *::before, *::after {
-  box-sizing: border-box;
-}
-
-body {
-  margin: 0;
-  font-family: system-ui, sans-serif;
-}
+@import "tailwindcss";

package/templates/web-vite/vite.config.ts

@@ -1,7 +1,7 @@
-import { defineConfig } from 'vite'
+import tailwindcss from '@tailwindcss/vite'
 import react from '@vitejs/plugin-react'
+import { defineConfig } from 'vite'
 
-// https://vite.dev/config/
 export default defineConfig({
-  plugins: [react()],
+  plugins: [react(), tailwindcss()],
 })

package/templates/api-nestjs-rest/src/app.controller.spec.ts

@@ -1,22 +0,0 @@
-import { Test, TestingModule } from '@nestjs/testing';
-import { AppController } from './app.controller';
-import { AppService } from './app.service';
-
-describe('AppController', () => {
-  let appController: AppController;
-
-  beforeEach(async () => {
-    const app: TestingModule = await Test.createTestingModule({
-      controllers: [AppController],
-      providers: [AppService],
-    }).compile();
-
-    appController = app.get<AppController>(AppController);
-  });
-
-  describe('root', () => {
-    it('should return "Hello World!"', () => {
-      expect(appController.getHello()).toBe('Hello World!');
-    });
-  });
-});

package/templates/api-nestjs-rest/src/app.controller.ts

@@ -1,12 +0,0 @@
-import { Controller, Get } from '@nestjs/common';
-import { AppService } from './app.service';
-
-@Controller()
-export class AppController {
-  constructor(private readonly appService: AppService) {}
-
-  @Get()
-  getHello(): string {
-    return this.appService.getHello();
-  }
-}

package/templates/api-nestjs-rest/src/app.service.ts

@@ -1,8 +0,0 @@
-import { Injectable } from '@nestjs/common';
-
-@Injectable()
-export class AppService {
-  getHello(): string {
-    return 'Hello World!';
-  }
-}

package/templates/web-nextjs/app/globals.css

@@ -1,10 +0,0 @@
-*, *::before, *::after {
-  box-sizing: border-box;
-  padding: 0;
-  margin: 0;
-}
-
-body {
-  font-family: system-ui, sans-serif;
-  -webkit-font-smoothing: antialiased;
-}