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

package/workspace/apps/api/webpack.config.cjs

@@ -0,0 +1,25 @@
+const { NxAppWebpackPlugin } = require('@nx/webpack/app-plugin');
+const { join } = require('path');
+
+module.exports = {
+  output: {
+    path: join(__dirname, 'dist'),
+    clean: true,
+    ...(process.env.NODE_ENV !== 'production' && {
+      devtoolModuleFilenameTemplate: '[absolute-resource-path]',
+    }),
+  },
+  plugins: [
+    new NxAppWebpackPlugin({
+      target: 'node',
+      compiler: 'tsc',
+      main: './src/main.ts',
+      tsConfig: './tsconfig.app.json',
+      assets: ['./src/assets'],
+      optimization: false,
+      outputHashing: 'none',
+      generatePackageJson: false,
+      sourceMap: true,
+    }),
+  ],
+};

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

@@ -0,0 +1,3 @@
+import baseConfig from '../../eslint.config.mjs';
+
+export default [...baseConfig];

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

@@ -0,0 +1,28 @@
+{
+  "name": "api-e2e",
+  "version": "0.0.1",
+  "private": true,
+  "nx": {
+    "implicitDependencies": [
+      "api"
+    ],
+    "targets": {
+      "e2e": {
+        "executor": "nx:run-commands",
+        "outputs": [
+          "{projectRoot}/test-output/vitest/coverage"
+        ],
+        "dependsOn": [
+          "api:build",
+          "api:serve"
+        ],
+        "options": {
+          "command": "vitest run --config apps/api-e2e/vitest.config.mts"
+        }
+      }
+    },
+    "tags": [
+      "scope:api"
+    ]
+  }
+}

package/workspace/apps/api-e2e/src/api/api.spec.ts

@@ -0,0 +1,11 @@
+import { describe, expect, it } from 'vitest';
+import axios from 'axios';
+
+describe('GET /api/health', () => {
+  it('should return ok status', async () => {
+    const res = await axios.get(`/api/health`);
+
+    expect(res.status).toBe(200);
+    expect(res.data).toEqual({ status: 'ok' });
+  });
+});

package/workspace/apps/api-e2e/src/support/global-setup.ts

@@ -0,0 +1,17 @@
+import { killPort, waitForPortOpen } from '@nx/node/utils';
+
+// Start services that the app needs to run (e.g. database, docker-compose,
+// etc.). Vitest's `globalSetup` runs this once before the suite and, if a
+// function is returned, runs it once after the suite as teardown.
+export default async function setup() {
+  console.log('\nSetting up...\n');
+
+  const host = process.env.HOST ?? 'localhost';
+  const port = process.env.PORT ? Number(process.env.PORT) : 3333;
+  await waitForPortOpen(port, { host });
+
+  return async function teardown() {
+    console.log('\nTearing down...\n');
+    await killPort(port);
+  };
+}

package/workspace/apps/api-e2e/src/support/test-setup.ts

@@ -0,0 +1,6 @@
+import axios from 'axios';
+
+// Configure axios for tests to use.
+const host = process.env.HOST ?? 'localhost';
+const port = process.env.PORT ?? '3333';
+axios.defaults.baseURL = `http://${host}:${port}`;

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

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/workspace/apps/api-e2e/tsconfig.spec.json

@@ -0,0 +1,28 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./out-tsc/vitest",
+    "composite": true,
+    "declaration": true,
+    "esModuleInterop": true,
+    "noUnusedLocals": false,
+    "noImplicitAny": false,
+    "types": [
+      "vitest/globals",
+      "vitest/importMeta",
+      "vite/client",
+      "node",
+      "vitest"
+    ],
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/**/*.ts",
+    "src/**/*.d.ts"
+  ],
+  "references": []
+}

package/workspace/apps/api-e2e/vitest.config.mts

@@ -0,0 +1,20 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig(() => ({
+  root: __dirname,
+  cacheDir: '../../node_modules/.vite/apps/api-e2e',
+  test: {
+    name: 'api-e2e',
+    watch: false,
+    globals: true,
+    environment: 'node',
+    globalSetup: ['./src/support/global-setup.ts'],
+    setupFiles: ['./src/support/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/.env.example

@@ -0,0 +1,12 @@
+# Copy to apps/web/.env.local for local dev. Next.js loads env files from
+# the app directory, not the workspace root — the root .env.example is
+# apps/api's, and nothing in this file reaches the server.
+#
+# The /api suffix is apps/api's global route prefix (app.setGlobalPrefix in
+# apps/api/src/main.ts). Without it every request lands one path segment
+# short and 404s against a route that plainly exists. 3333 is apps/api's
+# dev port; apps/web itself runs on 3000.
+#
+# NEXT_PUBLIC_ is required: this value is read in the browser, so Next has
+# to inline it at build time.
+NEXT_PUBLIC_API_BASE_URL=http://localhost:3333/api

package/workspace/apps/web/.prettierrc.js

@@ -0,0 +1,10 @@
+import base from '../../packages/config/prettier.js';
+
+export default {
+  ...base,
+  plugins: ['prettier-plugin-tailwindcss'],
+  // Tailwind v4 has no tailwind.config.js to autodetect — the plugin
+  // requires this explicit path (resolved relative to this file) to
+  // locate the design system.
+  tailwindStylesheet: './src/app/global.css',
+};

package/workspace/apps/web/.swcrc

@@ -0,0 +1,30 @@
+{
+  "jsc": {
+    "target": "es2017",
+    "parser": {
+      "syntax": "typescript",
+      "decorators": true,
+      "dynamicImport": true
+    },
+    "transform": {
+      "decoratorMetadata": true,
+      "legacyDecorator": true
+    },
+    "keepClassNames": true,
+    "externalHelpers": true,
+    "loose": true
+  },
+  "module": {
+    "type": "commonjs"
+  },
+  "sourceMaps": true,
+  "exclude": [
+    "jest.config.[ct]s",
+    ".*\\.spec.tsx?$",
+    ".*\\.test.tsx?$",
+    "./src/jest-setup.ts$",
+    "./**/jest-setup.ts$",
+    ".*.js$",
+    ".*.d.ts$"
+  ]
+}

package/workspace/apps/web/components.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/global.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "iconLibrary": "lucide"
+}

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

@@ -0,0 +1,12 @@
+import nextEslintPluginNext from '@next/eslint-plugin-next';
+import nx from '@nx/eslint-plugin';
+import baseConfig from '../../eslint.config.mjs';
+
+export default [
+  { plugins: { '@next/next': nextEslintPluginNext } },
+  ...nx.configs['flat/react-typescript'],
+  ...baseConfig,
+  {
+    ignores: ['.next/**/*', '**/out-tsc', '.prettierrc.js'],
+  },
+];

package/workspace/apps/web/index.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="@nx/next/typings/style.d.ts" />
+/* eslint-disable @typescript-eslint/no-explicit-any */
+declare module '*.svg' {
+  const content: any;
+  export const ReactComponent: any;
+  export default content;
+}

package/workspace/apps/web/next-env.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+import "./.next/types/root-params.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/workspace/apps/web/next.config.js

@@ -0,0 +1,9 @@
+//@ts-check
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  // Next.js options go here
+  // See: https://nextjs.org/docs/app/api-reference/config/next-config-js
+};
+
+export default nextConfig;

package/workspace/apps/web/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "web",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "@radix-ui/react-slot": "^1.3.1",
+    "@tailwindcss/postcss": "^4.3.3",
+    "@tanstack/react-query": "^5.101.4",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "lucide-react": "^1.25.0",
+    "next": "~16.3.0",
+    "postcss": "^8.5.23",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwind-merge": "^3.6.0",
+    "tailwindcss": "^4.3.3"
+  },
+  "devDependencies": {
+    "prettier-plugin-tailwindcss": "^0.7.4"
+  },
+  "nx": {
+    "targets": {
+      "generate-module-routes": {
+        "executor": "nx:run-commands",
+        "cache": true,
+        "inputs": ["{projectRoot}/src/app/*/page.tsx"],
+        "outputs": ["{projectRoot}/src/app/module-routes.ts"],
+        "options": {
+          "command": "node tools/generate-module-routes.cjs",
+          "cwd": "{workspaceRoot}"
+        }
+      }
+    },
+    "tags": ["scope:web"]
+  }
+}

package/workspace/apps/web/postcss.config.mjs

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

package/workspace/apps/web/src/app/global.css

@@ -0,0 +1,83 @@
+@import 'tailwindcss';
+
+@custom-variant dark (&:is(.dark *));
+
+:root {
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --destructive-foreground: oklch(0.577 0.245 27.325);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+  --radius: 0.625rem;
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.205 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.205 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.922 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --destructive-foreground: oklch(0.704 0.191 22.216);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}

package/workspace/apps/web/src/app/layout.tsx

@@ -0,0 +1,34 @@
+import './global.css';
+import { Providers } from './providers';
+
+export const metadata = {
+  title: 'Welcome to web',
+  description: 'Generated by create-nx-workspace',
+};
+
+const themeInitScript = `
+(function () {
+  var stored = localStorage.getItem('theme');
+  var prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+  if (stored === 'dark' || (!stored && prefersDark)) {
+    document.documentElement.classList.add('dark');
+  }
+})();
+`;
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <head>
+        <script dangerouslySetInnerHTML={{ __html: themeInitScript }} />
+      </head>
+      <body>
+        <Providers>{children}</Providers>
+      </body>
+    </html>
+  );
+}

package/workspace/apps/web/src/app/module-routes.ts

@@ -0,0 +1,13 @@
+// GENERATED FILE — do not hand-edit. Regenerated by
+// tools/generate-module-routes.cjs (the generate-module-routes Nx
+// target, which build, typecheck and test depend on) from every
+// apps/web/src/app/*/page.tsx file on disk. A module's screen layer
+// only ever creates its own page.tsx inside its own directory —
+// never edits this file or the root page.
+
+export interface ModuleRoute {
+  href: string;
+  label: string;
+}
+
+export const moduleRoutes: ModuleRoute[] = [];

package/workspace/apps/web/src/app/page.tsx

@@ -0,0 +1,34 @@
+import Link from 'next/link';
+import { Button } from '@/components/ui/button';
+import { ThemeToggle } from '@/components/theme-toggle';
+import { moduleRoutes } from './module-routes';
+
+// The index of everything built so far. `moduleRoutes` is generated from
+// the route directories on disk (tools/generate-module-routes.cjs), so a
+// module's screen layer only writes its own apps/web/src/app/<module>/
+// and this page picks it up — no task ever edits this file, which is what
+// keeps it outside every module-scoped layer's ALLOWED SCOPE.
+export default function Index() {
+  return (
+    <div className="flex min-h-screen flex-col items-center justify-center gap-6 p-8">
+      <div className="flex items-center gap-4">
+        <h1 className="text-2xl font-semibold">Hedgehog</h1>
+        <ThemeToggle />
+      </div>
+
+      {moduleRoutes.length === 0 ? (
+        <p className="text-muted-foreground max-w-prose text-center text-sm">
+          No modules yet. Each one you build gets a route here.
+        </p>
+      ) : (
+        <nav className="flex flex-wrap items-center justify-center gap-3">
+          {moduleRoutes.map((route) => (
+            <Button key={route.href} asChild variant="outline">
+              <Link href={route.href}>{route.label}</Link>
+            </Button>
+          ))}
+        </nav>
+      )}
+    </div>
+  );
+}

package/workspace/apps/web/src/app/providers.tsx

@@ -0,0 +1,12 @@
+'use client';
+
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { useState } from 'react';
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  const [queryClient] = useState(() => new QueryClient());
+
+  return (
+    <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+  );
+}

package/workspace/apps/web/src/components/theme-toggle.spec.tsx

@@ -0,0 +1,20 @@
+import { render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { describe, expect, it } from 'vitest';
+import { ThemeToggle } from './theme-toggle';
+
+describe('ThemeToggle', () => {
+  it('renders a toggle button and flips the document theme class on click', async () => {
+    const user = userEvent.setup();
+    render(<ThemeToggle />);
+
+    const toggle = screen.getByRole('button', { name: /toggle theme/i });
+    expect(toggle).toBeInTheDocument();
+
+    await user.click(toggle);
+    expect(document.documentElement.classList.contains('dark')).toBe(true);
+
+    await user.click(toggle);
+    expect(document.documentElement.classList.contains('dark')).toBe(false);
+  });
+});

package/workspace/apps/web/src/components/theme-toggle.tsx

@@ -0,0 +1,32 @@
+'use client';
+
+import { Moon, Sun } from 'lucide-react';
+import { useEffect, useState } from 'react';
+
+import { Button } from '@/components/ui/button';
+
+export function ThemeToggle() {
+  const [isDark, setIsDark] = useState(false);
+
+  useEffect(() => {
+    setIsDark(document.documentElement.classList.contains('dark'));
+  }, []);
+
+  function toggle() {
+    const next = !isDark;
+    document.documentElement.classList.toggle('dark', next);
+    localStorage.setItem('theme', next ? 'dark' : 'light');
+    setIsDark(next);
+  }
+
+  return (
+    <Button
+      variant="ghost"
+      size="icon"
+      onClick={toggle}
+      aria-label="Toggle theme"
+    >
+      {isDark ? <Sun /> : <Moon />}
+    </Button>
+  );
+}

package/workspace/apps/web/src/components/ui/button.tsx

@@ -0,0 +1,60 @@
+'use client';
+
+import { Slot } from '@radix-ui/react-slot';
+import { cva, type VariantProps } from 'class-variance-authority';
+import * as React from 'react';
+
+import { cn } from '@/lib/utils';
+
+const buttonVariants = cva(
+  'inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]',
+  {
+    variants: {
+      variant: {
+        default:
+          'bg-primary text-primary-foreground shadow-xs hover:bg-primary/90',
+        destructive:
+          'bg-destructive text-white shadow-xs hover:bg-destructive/90 focus-visible:ring-destructive/20',
+        outline:
+          'border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground',
+        secondary:
+          'bg-secondary text-secondary-foreground shadow-xs hover:bg-secondary/80',
+        ghost: 'hover:bg-accent hover:text-accent-foreground',
+        link: 'text-primary underline-offset-4 hover:underline',
+      },
+      size: {
+        default: 'h-9 px-4 py-2 has-[>svg]:px-3',
+        sm: 'h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5',
+        lg: 'h-10 rounded-md px-6 has-[>svg]:px-4',
+        icon: 'size-9',
+      },
+    },
+    defaultVariants: {
+      variant: 'default',
+      size: 'default',
+    },
+  },
+);
+
+function Button({
+  className,
+  variant,
+  size,
+  asChild = false,
+  ...props
+}: React.ComponentProps<'button'> &
+  VariantProps<typeof buttonVariants> & {
+    asChild?: boolean;
+  }) {
+  const Comp = asChild ? Slot : 'button';
+
+  return (
+    <Comp
+      data-slot="button"
+      className={cn(buttonVariants({ variant, size, className }))}
+      {...props}
+    />
+  );
+}
+
+export { Button, buttonVariants };

package/workspace/apps/web/src/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/workspace/apps/web/src/test-setup.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom/vitest';