@skyf0xx/hedgehog-core-full-stack-app 1.0.0

package/workspace/apps/web/tsconfig.json

@@ -0,0 +1,62 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "jsx": "preserve",
+    "noEmit": true,
+    "emitDeclarationOnly": false,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "outDir": "dist",
+    "rootDir": "src",
+    "tsBuildInfoFile": "dist/tsconfig.tsbuildinfo"
+  },
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    "src/**/*.js",
+    "src/**/*.jsx",
+    "../../apps/web/.next/types/**/*.ts",
+    "../../dist/apps/web/.next/types/**/*.ts",
+    "index.d.ts",
+    "next-env.d.ts"
+  ],
+  "exclude": [
+    "out-tsc",
+    "dist",
+    "node_modules",
+    "jest.config.ts",
+    "jest.config.cts",
+    "src/test-setup.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.tsx",
+    ".next",
+    "eslint.config.js",
+    "eslint.config.cjs",
+    "eslint.config.mjs"
+  ],
+  "references": [
+    {
+      "path": "../../packages/config"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/workspace/apps/web/tsconfig.spec.json

@@ -0,0 +1,37 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./out-tsc/vitest",
+    "jsx": "preserve",
+    "types": [
+      "vitest/globals",
+      "vitest/importMeta",
+      "vite/client",
+      "node",
+      "vitest",
+      "@testing-library/jest-dom"
+    ],
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/test-setup.ts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx",
+    "src/**/*.d.ts"
+  ],
+  "references": [
+    {
+      "path": "../../packages/config"
+    }
+  ]
+}

package/workspace/apps/web/vitest.config.mts

@@ -0,0 +1,27 @@
+import { defineConfig } from 'vitest/config';
+import react from '@vitejs/plugin-react';
+import { fileURLToPath } from 'node:url';
+
+export default defineConfig(() => ({
+  root: __dirname,
+  cacheDir: '../../node_modules/.vite/apps/web',
+  plugins: [react()],
+  resolve: {
+    alias: {
+      '@': fileURLToPath(new URL('./src', import.meta.url)),
+    },
+  },
+  test: {
+    name: 'web',
+    watch: false,
+    globals: true,
+    environment: 'jsdom',
+    setupFiles: ['./src/test-setup.ts'],
+    include: ['{src,tests}/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
+    reporters: ['default'],
+    coverage: {
+      reportsDirectory: './test-output/vitest/coverage',
+      provider: 'v8' as const,
+    },
+  },
+}));

package/workspace/apps/web-e2e/eslint.config.mjs

@@ -0,0 +1,12 @@
+import playwright from 'eslint-plugin-playwright';
+import baseConfig from '../../eslint.config.mjs';
+
+export default [
+  playwright.configs['flat/recommended'],
+  ...baseConfig,
+  {
+    files: ['**/*.ts', '**/*.js'],
+    // Override or add rules here
+    rules: {},
+  },
+];

package/workspace/apps/web-e2e/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "web-e2e",
+  "version": "0.0.1",
+  "private": true,
+  "nx": {
+    "implicitDependencies": [
+      "web"
+    ]
+  }
+}

package/workspace/apps/web-e2e/playwright.config.mts

@@ -0,0 +1,75 @@
+import { defineConfig, devices } from '@playwright/test';
+import { nxE2EPreset } from '@nx/playwright/preset';
+import { workspaceRoot } from '@nx/devkit';
+
+// For CI, you may want to set BASE_URL to the deployed application.
+const baseURL = process.env['BASE_URL'] || 'http://localhost:3000';
+
+/**
+ * Read environment variables from file.
+ * https://github.com/motdotla/dotenv
+ */
+// import 'dotenv/config';
+
+/**
+ * See https://playwright.dev/docs/test-configuration.
+ *
+ * Generated as a .mts file so Node forces ESM regardless of workspace
+ * `type`. Playwright routes `.mts` through its ESM loader (dynamic import,
+ * bypassing the pirates CJS-compile path), and Nx's native TS strip loads
+ * `.mts` directly. Playwright's configLoader auto-discovers
+ * `playwright.config.mts` via its extension list
+ * (.ts/.js/.mts/.mjs/.cts/.cjs).
+ */
+export default defineConfig({
+  ...nxE2EPreset(import.meta.dirname, { testDir: './src' }),
+  /* Shared settings for all the projects below. See https://playwright.dev/docs/api/class-testoptions. */
+  use: {
+    baseURL,
+    /* Collect trace when retrying the failed test. See https://playwright.dev/docs/trace-viewer */
+    trace: 'on-first-retry',
+  },
+  /* Run your local dev server before starting the tests */
+  webServer: {
+    command: 'pnpm exec nx run web:dev',
+    url: 'http://localhost:3000',
+    reuseExistingServer: true,
+    cwd: workspaceRoot,
+  },
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+
+    {
+      name: 'firefox',
+      use: { ...devices['Desktop Firefox'] },
+    },
+
+    {
+      name: 'webkit',
+      use: { ...devices['Desktop Safari'] },
+    },
+
+    // Uncomment for mobile browsers support
+    /* {
+      name: 'Mobile Chrome',
+      use: { ...devices['Pixel 5'] },
+    },
+    {
+      name: 'Mobile Safari',
+      use: { ...devices['iPhone 12'] },
+    }, */
+
+    // Uncomment for branded browsers
+    /* {
+      name: 'Microsoft Edge',
+      use: { ...devices['Desktop Edge'], channel: 'msedge' },
+    },
+    {
+      name: 'Google Chrome',
+      use: { ...devices['Desktop Chrome'], channel: 'chrome' },
+    } */
+  ],
+});

package/workspace/apps/web-e2e/src/example.spec.ts

@@ -0,0 +1,7 @@
+import { test, expect } from '@playwright/test';
+
+test('renders the base page', async ({ page }) => {
+  await page.goto('/');
+
+  await expect(page.locator('h1')).toContainText('Hedgehog');
+});

package/workspace/apps/web-e2e/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "allowJs": true,
+    "outDir": "out-tsc/playwright",
+    "sourceMap": false,
+    "types": ["node"]
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.js",
+    "playwright.config.mts",
+    "src/**/*.spec.ts",
+    "src/**/*.spec.js",
+    "src/**/*.test.ts",
+    "src/**/*.test.js",
+    "src/**/*.d.ts"
+  ],
+  "exclude": [
+    "out-tsc",
+    "test-output",
+    "eslint.config.js",
+    "eslint.config.mjs",
+    "eslint.config.cjs"
+  ]
+}

package/workspace/commitlint.config.cjs

@@ -0,0 +1,3 @@
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+};

package/workspace/core.yaml

@@ -0,0 +1,68 @@
+# Shipped core definition for full-stack-app. Layer order, scope, and
+# verify commands are the same shape this package's skills/hedgehog-loop
+# Domain Module step tables describe in prose — this file is their data form.
+# {module} is filled in by the compiler with the domain module name a
+# task is generated for.
+#
+# Every per-module layer's scope carries {module} — module-disjoint by
+# construction, so two modules' tasks never touch the same file
+# (src/db/core.mjs's validateCore enforces this: a module-axis core
+# rejects any non-exclusive layer whose scope omits {module}). schema and
+# hook run Vitest anchored to their own module's directory (`nx test db
+# -- src/schema/{module}/`), a distinct Nx target from typecheck under
+# this workspace's target inference (nx.json), so the command's real
+# radius is exactly its scope — no wider declaration to make. Cross-module
+# type/integration breakage isn't caught at the task that caused it; join
+# is exclusive: true and scoped to everything, running full typecheck and
+# every test once after every module's layers land, in exchange for those
+# layers running in parallel.
+id: full-stack-app
+layers:
+  - id: schema
+    scope: ["packages/db/src/schema/{module}/**", "packages/db/src/schema/index.ts"]
+    verify: "pnpm nx test db -- src/schema/{module}/"
+    commit: "feat({module}): schema"
+  - id: contract
+    depends_on: schema
+    scope: ["packages/contracts/src/{module}/**"]
+    verify: "pnpm nx test contracts -- src/{module}/"
+    commit: "feat({module}): contract"
+  - id: repository
+    depends_on: contract
+    scope: ["libs/{module}/repository/**"]
+    verify: "pnpm nx test {module}-repository"
+    commit: "feat({module}): repository"
+  - id: service
+    depends_on: repository
+    scope: ["libs/{module}/service/**"]
+    verify: "pnpm nx test {module}-service"
+    commit: "feat({module}): service"
+  - id: controller
+    depends_on: service
+    scope: ["apps/api/src/app/{module}/**"]
+    verify: "pnpm nx test api -- src/app/{module}/"
+    commit: "feat({module}): api"
+  - id: hook
+    depends_on: controller
+    scope: ["packages/hooks/src/{module}/**"]
+    verify: "pnpm nx test hooks -- src/{module}/"
+    commit: "feat({module}): hooks"
+  # Web only, because apps/mobile only exists when the Mobile add-on is
+  # on. A layer scoped to a project that was never scaffolded fails its
+  # own verify on every module, so the Mobile clause is added by
+  # hedgehog-bootstrap's Expo step — which is also what creates the Nx
+  # project the extra verify target needs — rather than shipped here and
+  # broken by default.
+  - id: screen
+    depends_on: hook
+    scope: ["apps/web/src/app/{module}/**"]
+    verify: "pnpm nx test web -- src/app/{module}/"
+    commit: "feat({module}): screen-web"
+  # Workspace-wide by design: the only gate that can see cross-module
+  # breakage, since every layer above is parallel and module-scoped.
+  - id: join
+    depends_on: screen
+    scope: ["**"]
+    verify: "pnpm nx run-many -t typecheck && pnpm nx run-many -t test"
+    exclusive: true
+    commit: "chore({module}): join"

package/workspace/docker-compose.yml

@@ -0,0 +1,14 @@
+services:
+  postgres:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: app
+    ports:
+      - '5432:5432'
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+
+volumes:
+  postgres-data:

package/workspace/eslint.config.mjs

@@ -0,0 +1,15 @@
+import baseConfig from './packages/config/eslint-base.js';
+
+/**
+ * Root flat ESLint config. Extends the locked shared base from
+ * `packages/config/eslint-base.js` (module boundaries, TypeScript/JS
+ * rules). Every app/lib in the workspace resolves through this file —
+ * don't add per-project overrides here; fix the base config at its
+ * source instead.
+ */
+export default [
+  ...baseConfig,
+  {
+    ignores: ['**/vitest.config.*.timestamp*', '**/test-output'],
+  },
+];

package/workspace/gitignore.template

@@ -0,0 +1,24 @@
+node_modules
+dist
+tmp
+out-tsc
+.env
+.env.local
+*.log
+.DS_Store
+.hedgehog/graph-server.json
+.hedgehog/hedgehog.db
+.hedgehog/hedgehog.db-*
+.hedgehog/commit.lock
+
+.nx/cache
+.nx/workspace-data
+.nx/polygraph
+.claude/worktrees
+.claude/settings.local.json
+vitest.config.*.timestamp*
+
+# Next.js
+.next
+out
+test-output

package/workspace/lefthook.yml

@@ -0,0 +1,52 @@
+# The commit gate. Two things in here are load-bearing and read like
+# noise if you don't know what they're for — don't "clean them up".
+#
+# `assert_lefthook_installed: true` is what makes the gate fail CLOSED.
+# It is consumed by `lefthook install`, which bakes a refusing branch
+# into the generated .git/hooks/* scripts. Without it, a repo whose
+# node_modules has been cleared — a workspace clean, a fresh clone
+# before install, a core switch — prints "Can't find lefthook in PATH"
+# and exits 0, so the commit lands with no typecheck, no lint and no
+# test while .git/hooks and this file both still look like a gate.
+# There is nothing in the output that distinguishes "passed the gate"
+# from "there was no gate". With it, the hook refuses the commit and
+# names the escape hatch (`git commit --no-verify`, or `LEFTHOOK=0`).
+# Restore enforcement with `pnpm install` — lefthook's own postinstall
+# re-runs `lefthook install -f` — or with `pnpm dlx lefthook install`
+# on its own. `hedgehog status` reports whether the gate is live.
+#
+# Because the assertion is written into the hook at install time, this
+# flag only protects hooks generated after it was set. `pnpm install`
+# regenerates them, so any project that has installed once since is
+# covered.
+#
+# The `git rev-parse --verify --quiet HEAD` guard on each command is
+# there because `--base=HEAD` cannot resolve in a repo with no commits:
+# on the very first commit of a fresh install every command dies with
+# "fatal: ambiguous argument 'HEAD': unknown revision", the commit is
+# rejected, and `git commit --no-verify` becomes the only way through —
+# which is exactly the habit this gate exists to prevent. The fallback
+# is `run-many`, not a skip: with no history there is no diff to narrow
+# by, every project is new, and running the whole workspace is both the
+# honest answer and the strongest one. Silencing the gate on the one
+# commit that introduces the entire codebase would be the worst
+# possible place to do it.
+assert_lefthook_installed: true
+
+pre-commit:
+  parallel: true
+  commands:
+    typecheck:
+      glob: '*.{ts,tsx}'
+      run: if git rev-parse --verify --quiet HEAD >/dev/null 2>&1; then npx nx affected -t typecheck --base=HEAD; else npx nx run-many -t typecheck; fi
+    lint:
+      glob: '*.{ts,tsx}'
+      run: if git rev-parse --verify --quiet HEAD >/dev/null 2>&1; then npx nx affected -t lint --base=HEAD; else npx nx run-many -t lint; fi
+    test:
+      glob: '*.{ts,tsx}'
+      run: if git rev-parse --verify --quiet HEAD >/dev/null 2>&1; then npx nx affected -t test --base=HEAD; else npx nx run-many -t test; fi
+
+commit-msg:
+  commands:
+    commitlint:
+      run: npx commitlint --edit {1}

package/workspace/nx.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "./node_modules/nx/schemas/nx-schema.json",
+  "targetDefaults": {
+    "build": {
+      "cache": true,
+      "dependsOn": ["generate-module-routes"]
+    },
+    "dev": {
+      "dependsOn": ["generate-module-routes"]
+    },
+    "test": {
+      "cache": true,
+      "dependsOn": ["^build", "generate-feature-modules", "generate-module-routes"]
+    },
+    "typecheck": {
+      "dependsOn": ["generate-feature-modules", "generate-module-routes"]
+    },
+    "lint": {
+      "cache": true
+    }
+  },
+  "defaultBase": "master",
+  "plugins": [
+    {
+      "plugin": "@nx/js/typescript",
+      "options": {
+        "typecheck": {
+          "targetName": "typecheck"
+        },
+        "build": {
+          "targetName": "build",
+          "configName": "tsconfig.lib.json",
+          "buildDepsName": "build-deps",
+          "watchDepsName": "watch-deps"
+        }
+      }
+    },
+    {
+      "plugin": "@nx/vitest",
+      "options": {
+        "testTargetName": "test",
+        "ciTargetName": "test-ci",
+        "testMode": "watch"
+      },
+      "exclude": ["apps/api-e2e/**"]
+    },
+    {
+      "plugin": "@nx/eslint/plugin",
+      "options": {
+        "targetName": "lint"
+      }
+    },
+    {
+      "plugin": "@nx/webpack/plugin",
+      "options": {
+        "buildTargetName": "build",
+        "serveTargetName": "serve",
+        "previewTargetName": "preview",
+        "buildDepsTargetName": "build-deps",
+        "watchDepsTargetName": "watch-deps",
+        "serveStaticTargetName": "serve-static"
+      }
+    },
+    {
+      "plugin": "@nx/next/plugin",
+      "options": {
+        "startTargetName": "start",
+        "buildTargetName": "build",
+        "devTargetName": "dev",
+        "serveStaticTargetName": "serve-static",
+        "buildDepsTargetName": "build-deps",
+        "watchDepsTargetName": "watch-deps"
+      }
+    },
+    {
+      "plugin": "@nx/playwright/plugin",
+      "options": {
+        "targetName": "e2e"
+      }
+    }
+  ],
+  "generators": {
+    "@nx/next": {
+      "application": {
+        "style": "css",
+        "linter": "eslint"
+      }
+    }
+  }
+}

package/workspace/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "app",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@9.0.0",
+  "scripts": {
+    "dev": "docker compose up -d && nx run-many --target=serve,dev --projects=api,web --parallel"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^21.2.1",
+    "@commitlint/config-conventional": "^21.2.0",
+    "@eslint/js": "^10.0.1",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.0",
+    "@next/eslint-plugin-next": "^16.1.6",
+    "@nx/devkit": "23.1.0",
+    "@nx/eslint": "^23.1.0",
+    "@nx/eslint-plugin": "^23.1.0",
+    "@nx/js": "^23.1.0",
+    "@nx/nest": "23.1.0",
+    "@nx/next": "23.1.0",
+    "@nx/node": "23.1.0",
+    "@nx/playwright": "23.1.0",
+    "@nx/vitest": "23.1.0",
+    "@nx/web": "23.1.0",
+    "@nx/webpack": "23.1.0",
+    "@playwright/test": "^1.37.0",
+    "@swc-node/register": "~1.11.1",
+    "@swc/cli": "~0.8.1",
+    "@swc/core": "~1.15.5",
+    "@swc/helpers": "~0.5.18",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.4",
+    "@types/node": "^22.0.0",
+    "@types/pg": "^8.20.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.65.0",
+    "@typescript-eslint/parser": "^8.65.0",
+    "@vitejs/plugin-react": "^6.0.5",
+    "@vitest/coverage-v8": "~4.1.0",
+    "drizzle-kit": "^0.31.10",
+    "drizzle-zod": "^0.8.3",
+    "eslint": "^10.7.0",
+    "eslint-config-next": "^16.1.6",
+    "eslint-plugin-import": "2.31.0",
+    "eslint-plugin-jsx-a11y": "6.10.1",
+    "eslint-plugin-playwright": "^1.6.2",
+    "eslint-plugin-react": "^7.35.0",
+    "eslint-plugin-react-hooks": "5.0.0",
+    "jsdom": "^30.0.1",
+    "lefthook": "^2.1.10",
+    "nx": "23.1.0",
+    "prettier": "~3.6.2",
+    "tslib": "^2.3.0",
+    "typescript": "~6.0.3",
+    "typescript-eslint": "^8.65.0",
+    "vite": "^8.0.0",
+    "vitest": "~4.1.0",
+    "webpack": "^5.101.3",
+    "webpack-cli": "^7.0.0",
+    "webpack-dev-server": "^5.2.1"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/platform-express": "^11.0.0",
+    "axios": "^1.18.0",
+    "drizzle-orm": "^0.45.2",
+    "nestjs-pino": "^4.6.1",
+    "next": "~16.3.0",
+    "pg": "^8.22.0",
+    "pino-http": "^11.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.8.0",
+    "zod": "^4.4.3"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "lefthook"
+    ],
+    "overrides": {
+      "esbuild": "0.25.12",
+      "axios": "^1.18.0",
+      "brace-expansion@1": "^1.1.18",
+      "brace-expansion@2": "^2.1.4",
+      "brace-expansion@5": "^5.0.9",
+      "fast-uri": "^3.1.5",
+      "js-yaml@3": "^3.15.1",
+      "js-yaml@4": "^4.3.1",
+      "nanoid": "^3.3.17",
+      "sharp": "^0.35.0",
+      "uuid@8": "^11.1.1"
+    }
+  }
+}