create-forgeon 0.1.2 → 0.1.6

package/templates/base/apps/web/src/App.tsx

@@ -1,37 +1,37 @@
-import { useState } from 'react';
-import './styles.css';
-
-type HealthResponse = {
-  status: string;
-  message: string;
-};
-
-export default function App() {
-  const [data, setData] = useState<HealthResponse | null>(null);
-  const [error, setError] = useState<string | null>(null);
-
-  const checkApi = async () => {
-    setError(null);
-    try {
-      const response = await fetch('/api/health');
-      if (!response.ok) {
-        throw new Error(`HTTP ${response.status}`);
-      }
-      const payload = (await response.json()) as HealthResponse;
-      setData(payload);
-    } catch (err) {
-      setError(err instanceof Error ? err.message : 'Unknown error');
-    }
-  };
-
-  return (
-    <main className="page">
-      <h1>Forgeon Fullstack Scaffold</h1>
-      <p>Default frontend preset: React + Vite + TypeScript.</p>
-      <button onClick={checkApi}>Check API health</button>
-      {data ? <pre>{JSON.stringify(data, null, 2)}</pre> : null}
-      {error ? <p className="error">{error}</p> : null}
-    </main>
-  );
+import { useState } from 'react';
+import './styles.css';
+
+type HealthResponse = {
+  status: string;
+  message: string;
+};
+
+export default function App() {
+  const [data, setData] = useState<HealthResponse | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  const checkApi = async () => {
+    setError(null);
+    try {
+      const response = await fetch('/api/health');
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`);
+      }
+      const payload = (await response.json()) as HealthResponse;
+      setData(payload);
+    } catch (err) {
+      setError(err instanceof Error ? err.message : 'Unknown error');
+    }
+  };
+
+  return (
+    <main className="page">
+      <h1>Forgeon Fullstack Scaffold</h1>
+      <p>Default frontend preset: React + Vite + TypeScript.</p>
+      <button onClick={checkApi}>Check API health</button>
+      {data ? <pre>{JSON.stringify(data, null, 2)}</pre> : null}
+      {error ? <p className="error">{error}</p> : null}
+    </main>
+  );
 }
 

package/templates/base/apps/web/src/main.tsx

@@ -1,9 +1,9 @@
-import React from 'react';
-import ReactDOM from 'react-dom/client';
-import App from './App';
-
-ReactDOM.createRoot(document.getElementById('root')!).render(
-  <React.StrictMode>
-    <App />
-  </React.StrictMode>,
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
 );

package/templates/base/apps/web/src/styles.css

@@ -1,33 +1,33 @@
-:root {
-  font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
-}
-
-body {
-  margin: 0;
-  background: #f8fafc;
-  color: #0f172a;
-}
-
-.page {
-  max-width: 720px;
-  margin: 3rem auto;
-  padding: 0 1rem;
-}
-
-button {
-  padding: 0.6rem 1rem;
-  border: 0;
-  border-radius: 0.5rem;
-  cursor: pointer;
-}
-
-pre {
-  background: #e2e8f0;
-  padding: 1rem;
-  border-radius: 0.5rem;
-  overflow: auto;
-}
-
-.error {
-  color: #b91c1c;
+:root {
+  font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+}
+
+body {
+  margin: 0;
+  background: #f8fafc;
+  color: #0f172a;
+}
+
+.page {
+  max-width: 720px;
+  margin: 3rem auto;
+  padding: 0 1rem;
+}
+
+button {
+  padding: 0.6rem 1rem;
+  border: 0;
+  border-radius: 0.5rem;
+  cursor: pointer;
+}
+
+pre {
+  background: #e2e8f0;
+  padding: 1rem;
+  border-radius: 0.5rem;
+  overflow: auto;
+}
+
+.error {
+  color: #b91c1c;
 }

package/templates/base/apps/web/tsconfig.json

@@ -1,18 +1,18 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "useDefineForClassFields": true,
-    "lib": ["ES2020", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "skipLibCheck": true,
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": false,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "strict": true,
-    "types": ["vite/client"]
-  },
-  "include": ["src"]
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": false,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "types": ["vite/client"]
+  },
+  "include": ["src"]
 }

package/templates/base/apps/web/vite.config.ts

@@ -1,15 +1,15 @@
-import { defineConfig } from 'vite';
-import react from '@vitejs/plugin-react';
-
-export default defineConfig({
-  plugins: [react()],
-  server: {
-    port: 5173,
-    proxy: {
-      '/api': {
-        target: 'http://localhost:3000',
-        changeOrigin: true,
-      },
-    },
-  },
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    port: 5173,
+    proxy: {
+      '/api': {
+        target: 'http://localhost:3000',
+        changeOrigin: true,
+      },
+    },
+  },
 });

package/templates/base/docs/AI/ARCHITECTURE.md

@@ -1,38 +1,38 @@
-# ARCHITECTURE
-
-## Monorepo Layout
-
-- `apps/*` - deployable apps
-- `packages/*` - reusable modules/presets
-- `infra/*` - runtime infrastructure
-- `resources/*` - static assets (translations)
-
-## Environment Flags
-
-- `PORT` - API port (default 3000)
-- `DATABASE_URL` - Prisma Postgres connection
-- `I18N_ENABLED` - toggles i18n package wiring
-- `I18N_DEFAULT_LANG` - default language
-- `I18N_FALLBACK_LANG` - fallback language
-
-## Default DB Stack
-
-Current default is Prisma + Postgres.
-
-- Prisma schema and migrations live in `apps/api/prisma`
-- DB access is encapsulated via `PrismaModule` (`apps/api/src/prisma`)
-
-## Future DB Presets (Not Implemented Yet)
-
-A future preset can switch DB by:
-1. Replacing `PrismaModule` with another DB module package (for example Mongo package).
-2. Updating `infra/docker/compose.yml` DB service.
-3. Updating `DATABASE_URL` and related env keys.
-4. Keeping app-level services dependent only on repository/data-access abstractions.
-
-## Future Feature Modules
-
-Reusable features should be added as workspace packages and imported by apps as needed:
-
-- `packages/core` for shared backend primitives
+# ARCHITECTURE
+
+## Monorepo Layout
+
+- `apps/*` - deployable apps
+- `packages/*` - reusable modules/presets
+- `infra/*` - runtime infrastructure
+- `resources/*` - static assets (translations)
+
+## Environment Flags
+
+- `PORT` - API port (default 3000)
+- `DATABASE_URL` - Prisma Postgres connection
+- `I18N_ENABLED` - toggles i18n package wiring
+- `I18N_DEFAULT_LANG` - default language
+- `I18N_FALLBACK_LANG` - fallback language
+
+## Default DB Stack
+
+Current default is Prisma + Postgres.
+
+- Prisma schema and migrations live in `apps/api/prisma`
+- DB access is encapsulated via `PrismaModule` (`apps/api/src/prisma`)
+
+## Future DB Presets (Not Implemented Yet)
+
+A future preset can switch DB by:
+1. Replacing `PrismaModule` with another DB module package (for example Mongo package).
+2. Updating `infra/docker/compose.yml` DB service.
+3. Updating `DATABASE_URL` and related env keys.
+4. Keeping app-level services dependent only on repository/data-access abstractions.
+
+## Future Feature Modules
+
+Reusable features should be added as workspace packages and imported by apps as needed:
+
+- `packages/core` for shared backend primitives
 - Additional packages for auth presets, guards, queues, mailers, etc.

package/templates/base/docs/AI/MODULE_SPEC.md

@@ -1,56 +1,56 @@
-# MODULE SPEC
-
-## Goal
-
-Define one repeatable fullstack pattern for Forgeon add-modules.
-
-Each feature module should be split into:
-
-1. `@forgeon/<feature>-contracts`
-2. `@forgeon/<feature>-api`
-3. `@forgeon/<feature>-web`
-
-## 1) Contracts Package
-
-Single source of truth shared by backend and frontend.
-
-Must contain:
-
-- DTO/request/response types
-- route constants (`API.<feature>.*`)
-- error codes (`<FEATURE>_*`)
-- shared constants (header/cookie names)
-
-Should contain:
-
-- zod schemas + inferred TS types
-
-## 2) API Package
-
-NestJS module integrating contracts into backend runtime.
-
-Must contain:
-
-- module/service/controller
-- guards/strategies (if auth/security related)
-- config keys
-- minimal e2e test path
-- integration with `@forgeon/core` errors/logging
-
-## 3) Web Package
-
-React integration layer for the same feature.
-
-Must contain:
-
-- provider/hooks/store
-- route guard (if feature requires auth/access)
-- API client helpers using contracts route constants/types
-- token/header/cookie wiring where relevant
-
-## Acceptance Criteria
-
-- No duplicate route strings across api/web.
-- No duplicate error-code enums across api/web.
-- Contracts package can be imported from both sides without circular dependencies.
-- Module has docs under `docs/AI/MODULES/<module-id>.md`.
+# MODULE SPEC
+
+## Goal
+
+Define one repeatable fullstack pattern for Forgeon add-modules.
+
+Each feature module should be split into:
+
+1. `@forgeon/<feature>-contracts`
+2. `@forgeon/<feature>-api`
+3. `@forgeon/<feature>-web`
+
+## 1) Contracts Package
+
+Single source of truth shared by backend and frontend.
+
+Must contain:
+
+- DTO/request/response types
+- route constants (`API.<feature>.*`)
+- error codes (`<FEATURE>_*`)
+- shared constants (header/cookie names)
+
+Should contain:
+
+- zod schemas + inferred TS types
+
+## 2) API Package
+
+NestJS module integrating contracts into backend runtime.
+
+Must contain:
+
+- module/service/controller
+- guards/strategies (if auth/security related)
+- config keys
+- minimal e2e test path
+- integration with `@forgeon/core` errors/logging
+
+## 3) Web Package
+
+React integration layer for the same feature.
+
+Must contain:
+
+- provider/hooks/store
+- route guard (if feature requires auth/access)
+- API client helpers using contracts route constants/types
+- token/header/cookie wiring where relevant
+
+## Acceptance Criteria
+
+- No duplicate route strings across api/web.
+- No duplicate error-code enums across api/web.
+- Contracts package can be imported from both sides without circular dependencies.
+- Module has docs under `docs/AI/MODULES/<module-id>.md`.

package/templates/base/docs/AI/PROJECT.md

@@ -1,32 +1,32 @@
-# PROJECT
-
-## What This Repository Is
-
-A canonical fullstack monorepo scaffold intended to be reused as a project starter.
-
-## Structure
-
-- `apps/api` - NestJS backend
-- `apps/web` - frontend scaffold (default React + Vite + TS)
-- `packages/core` - shared backend core placeholder
-- `packages/i18n` - reusable nestjs-i18n integration package
-- `infra` - Docker Compose + reverse proxy preset (nginx/caddy)
-- `resources/i18n` - translation dictionaries
-- `docs` - documentation and AI workflow prompts
-
-## Run Modes
-
-### Dev mode
-
-```bash
-pnpm install
-pnpm dev
-```
-
-### Docker mode
-
-```bash
-docker compose --env-file infra/docker/.env.example -f infra/docker/compose.yml up --build
-```
-
+# PROJECT
+
+## What This Repository Is
+
+A canonical fullstack monorepo scaffold intended to be reused as a project starter.
+
+## Structure
+
+- `apps/api` - NestJS backend
+- `apps/web` - frontend scaffold (default React + Vite + TS)
+- `packages/core` - shared backend core placeholder
+- `packages/i18n` - reusable nestjs-i18n integration package
+- `infra` - Docker Compose + reverse proxy preset (nginx/caddy)
+- `resources/i18n` - translation dictionaries
+- `docs` - documentation and AI workflow prompts
+
+## Run Modes
+
+### Dev mode
+
+```bash
+pnpm install
+pnpm dev
+```
+
+### Docker mode
+
+```bash
+docker compose --env-file infra/docker/.env.example -f infra/docker/compose.yml up --build
+```
+
 The API uses Prisma and expects `DATABASE_URL` from env.

package/templates/base/docs/AI/TASKS.md

@@ -1,58 +1,58 @@
-# TASKS
-
-## Feature Discovery Matrix
-
-```text
-Scan this monorepo and build a backend feature matrix by app/package.
-Use only evidence from code and dependencies.
-Output:
-1) taxonomy by category
-2) feature comparison table
-3) common core
-4) unique features
-5) architectural inconsistencies
-Include file references for every feature.
-```
-
-## Add Module Package
-
-```text
-Create a new reusable package under packages/ for <feature-name>.
-Requirements:
-- minimal API
-- NestJS-compatible module
-- docs in package README
-- wire into apps/api conditionally via env flag
-- keep backward compatibility
-```
-
-## Refactor Core
-
-```text
-Move shared backend logic from apps/api into packages/core.
-Do not change behavior.
-Update imports, package dependencies, and docs.
-Run build checks and show changed files.
-```
-
-## Generate Preset
-
-```text
-Create or update create-forgeon preset flow:
-- keep canonical stack fixed: NestJS + React + Prisma/Postgres + Docker
-- allow only runtime proxy choice: caddy/nginx/none
-- update generated docs fragments
-- update docs/AI/ARCHITECTURE.md and docs/AI/MODULE_SPEC.md when scope changes
-```
-
-## Add Fullstack Module
-
-```text
-Implement `create-forgeon add <module-id>` for a fullstack feature.
-Requirements:
-- split module into contracts/api/web packages
-- contracts is source of truth for routes, DTOs, errors
-- add docs note under docs/AI/MODULES/<module-id>.md
-- keep backward compatibility
-```
+# TASKS
+
+## Feature Discovery Matrix
+
+```text
+Scan this monorepo and build a backend feature matrix by app/package.
+Use only evidence from code and dependencies.
+Output:
+1) taxonomy by category
+2) feature comparison table
+3) common core
+4) unique features
+5) architectural inconsistencies
+Include file references for every feature.
+```
+
+## Add Module Package
+
+```text
+Create a new reusable package under packages/ for <feature-name>.
+Requirements:
+- minimal API
+- NestJS-compatible module
+- docs in package README
+- wire into apps/api conditionally via env flag
+- keep backward compatibility
+```
+
+## Refactor Core
+
+```text
+Move shared backend logic from apps/api into packages/core.
+Do not change behavior.
+Update imports, package dependencies, and docs.
+Run build checks and show changed files.
+```
+
+## Generate Preset
+
+```text
+Create or update create-forgeon preset flow:
+- keep canonical stack fixed: NestJS + React + Prisma/Postgres + Docker
+- allow only runtime proxy choice: caddy/nginx/none
+- update generated docs fragments
+- update docs/AI/ARCHITECTURE.md and docs/AI/MODULE_SPEC.md when scope changes
+```
+
+## Add Fullstack Module
+
+```text
+Implement `create-forgeon add <module-id>` for a fullstack feature.
+Requirements:
+- split module into contracts/api/web packages
+- contracts is source of truth for routes, DTOs, errors
+- add docs note under docs/AI/MODULES/<module-id>.md
+- keep backward compatibility
+```
 

package/templates/base/docs/README.md

@@ -1,6 +1,6 @@
-# Documentation Index
-
-- `AI/PROJECT.md` - project overview and run modes
-- `AI/ARCHITECTURE.md` - monorepo design and extension model
-- `AI/MODULE_SPEC.md` - fullstack module contract (`contracts/api/web`)
-- `AI/TASKS.md` - ready-to-use Codex prompts
+# Documentation Index
+
+- `AI/PROJECT.md` - project overview and run modes
+- `AI/ARCHITECTURE.md` - monorepo design and extension model
+- `AI/MODULE_SPEC.md` - fullstack module contract (`contracts/api/web`)
+- `AI/TASKS.md` - ready-to-use Codex prompts

package/templates/base/infra/caddy/Caddyfile

@@ -1,15 +1,15 @@
-:80 {
-  encode gzip zstd
-
-  route {
-    handle /api/* {
-      reverse_proxy api:3000
-    }
-
-    handle {
-      root * /srv
-      try_files {path} /index.html
-      file_server
-    }
-  }
-}
+:80 {
+  encode gzip zstd
+
+  route {
+    handle /api/* {
+      reverse_proxy api:3000
+    }
+
+    handle {
+      root * /srv
+      try_files {path} /index.html
+      file_server
+    }
+  }
+}

package/templates/base/infra/docker/.env.example

@@ -1,10 +1,10 @@
-POSTGRES_USER=postgres
-POSTGRES_PASSWORD=postgres
-POSTGRES_DB=app
-
-PORT=3000
-DATABASE_URL=postgresql://postgres:postgres@db:5432/app?schema=public
-
-I18N_ENABLED=true
-I18N_DEFAULT_LANG=en
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=postgres
+POSTGRES_DB=app
+
+PORT=3000
+DATABASE_URL=postgresql://postgres:postgres@db:5432/app?schema=public
+
+I18N_ENABLED=true
+I18N_DEFAULT_LANG=en
 I18N_FALLBACK_LANG=en