techbro 0.0.0-stage → 0.5.0

package/templates/_default/apps/frontend/README.md

@@ -0,0 +1,39 @@
+# Frontend
+
+React + Vite + Tailwind CSS + shadcn/ui, plain JavaScript (JSX).
+
+## Run
+
+```bash
+npm ci
+npm run dev   # http://localhost:5173, proxies /api and /health to http://localhost:8080
+```
+
+## Scripts
+
+`dev`, `build`, `preview`, `lint`, `format`, `format:check`, `test` (watch), `test:run`.
+
+## Environment
+
+`VITE_API_BASE_URL` (see `.env.example`): API origin. Empty means same origin / dev proxy.
+`VITE_APP_NAME`: name shown in the header and welcome page. Empty uses "Project Template".
+
+## Pages
+
+React Router (`react-router`) with path-based URLs; routes are registered in `src/routes.jsx` and `App.jsx` is the layout root. Production hosting needs an SPA history fallback (serve `index.html` for unknown paths).
+
+- `/` Welcome (`WelcomePage`): backend status, a guided tour of the sample feature, next steps.
+- `/items` Items (`ItemsPage`): live demo of the items API.
+
+## Layout (MVC)
+
+- `src/models/`: pure data helpers and validation (model)
+- `src/components/`, `src/pages/`: views; `components/ui/` is shadcn/ui
+- `src/hooks/`: controllers coordinating user actions and API calls
+- `src/api/`: HTTP client functions
+- Tests live beside source files (`*.test.js[x]`).
+
+`src/shadcn.css` vendors `dist/tailwind.css` from shadcn 4.21.4, preserving its
+styles and MIT license notice without installing the CLI dependency tree.
+The CLI remains usable for component generation with
+`npx shadcn@latest add <name>`.

package/templates/_default/apps/frontend/_dockerignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+.env

package/templates/_default/apps/frontend/_gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

package/templates/_default/apps/frontend/components.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "base-nova",
+  "rsc": false,
+  "tsx": false,
+  "tailwind": {
+    "config": "",
+    "css": "src/index.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "rtl": false,
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "menuColor": "default",
+  "menuAccent": "subtle",
+  "registries": {}
+}

package/templates/_default/apps/frontend/eslint.config.js

@@ -0,0 +1,37 @@
+import js from "@eslint/js";
+import globals from "globals";
+import reactHooks from "eslint-plugin-react-hooks";
+import reactRefresh from "eslint-plugin-react-refresh";
+import prettier from "eslint-config-prettier";
+import { defineConfig, globalIgnores } from "eslint/config";
+
+export default defineConfig([
+  globalIgnores(["dist"]),
+  {
+    files: ["**/*.{js,jsx}"],
+    extends: [
+      js.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      ecmaVersion: "latest",
+      globals: globals.browser,
+      parserOptions: { ecmaFeatures: { jsx: true }, sourceType: "module" },
+    },
+    rules: { "no-unused-vars": ["error", { varsIgnorePattern: "^[A-Z_]" }] },
+  },
+  {
+    files: ["*.config.js"],
+    languageOptions: { globals: globals.node },
+  },
+  {
+    files: ["**/*.test.{js,jsx}", "src/test/**"],
+    languageOptions: { globals: { ...globals.vitest, vi: "readonly" } },
+  },
+  {
+    files: ["src/components/ui/**"],
+    rules: { "react-refresh/only-export-components": "off" },
+  },
+  prettier,
+]);

package/templates/_default/apps/frontend/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>frontend</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>

package/templates/_default/apps/frontend/jsconfig.json

@@ -0,0 +1,7 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": { "@/*": ["./src/*"] }
+  },
+  "include": ["src"]
+}

package/templates/_default/apps/frontend/nginx.conf

@@ -0,0 +1,30 @@
+server {
+  listen 8080;
+  root /usr/share/nginx/html;
+  index index.html;
+
+  gzip on;
+  gzip_types text/plain text/css application/javascript application/json image/svg+xml;
+
+  location /assets/ {
+    add_header Cache-Control "public, max-age=31536000, immutable";
+    try_files $uri =404;
+  }
+
+  location /api/ {
+    proxy_pass http://backend:8080;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+  }
+
+  location = /health { proxy_pass http://backend:8080; }
+  location = /ready { proxy_pass http://backend:8080; }
+
+  # SPA history fallback for client-side routes such as /items
+  location / {
+    add_header Cache-Control "no-cache";
+    try_files $uri $uri/ /index.html;
+  }
+}