create-simone-app 0.1.0

package/templates/fe/base/eslint.config.js

@@ -0,0 +1,169 @@
+import js from '@eslint/js'
+import jsxA11y from 'eslint-plugin-jsx-a11y'
+import reactHooks from 'eslint-plugin-react-hooks'
+import { defineConfig, globalIgnores } from 'eslint/config'
+import globals from 'globals'
+import tseslint from 'typescript-eslint'
+
+// Written by create-simone-app: which state library the chosen variant may import inside src/stores.
+import variants from './eslint.variants.json' with { type: 'json' }
+
+// ---------------------------------------------------------------------------
+// Forbidden imports (dogmas + seams). `allow` lifts a keyword for a folder.
+// ---------------------------------------------------------------------------
+const RESTRICTED = {
+  paths: [
+    {
+      name: 'axios',
+      message:
+        'HTTP only via `apiClient` from @/lib/apiClient (core-rules §8.1).',
+    },
+    { name: 'zustand', message: 'State seam: import from @/stores only.' },
+    { name: 'jotai', message: 'State seam: import from @/stores only.' },
+    { name: 'swr', message: 'TanStack Query only (tanstack-ecosystem §2).' },
+    { name: 'antd', message: 'shadcn/ui only (ui-shadcn §1.1).' },
+    {
+      name: 'styled-components',
+      message: 'Tailwind only, single index.css (ui-shadcn §2.1).',
+    },
+  ],
+  patterns: [
+    // regex, not group: gitignore-style groups would also match '@tanstack/react-router'
+    {
+      regex: '^react-router(-dom)?(/.*)?$',
+      message: 'TanStack Router only (tanstack-ecosystem §1.1).',
+    },
+    {
+      group: ['@mui/*', '@chakra-ui/*'],
+      message: 'shadcn/ui only (ui-shadcn §1.1).',
+    },
+    {
+      group: ['@emotion/*'],
+      message: 'Tailwind only, single index.css (ui-shadcn §2.1).',
+    },
+    {
+      group: ['redux', 'redux-*', '@reduxjs/*', 'react-redux'],
+      message: 'Zustand for client state (core-rules §7).',
+    },
+    {
+      group: ['zustand/*', 'jotai/*'],
+      message: 'State seam: import from @/stores only.',
+    },
+    {
+      group: ['@base-ui/*', '@radix-ui/*', 'radix-ui', 'react-aria-components'],
+      message: 'UI seam: UI primitives only inside src/components/ui.',
+    },
+  ],
+}
+
+const restrictedImports = (allow = []) => [
+  'error',
+  {
+    paths: RESTRICTED.paths.filter(
+      (p) => !allow.some((a) => p.name.startsWith(a)),
+    ),
+    patterns: RESTRICTED.patterns.filter(
+      (p) =>
+        !(p.group ?? [p.regex]).some((g) => allow.some((a) => g.startsWith(a))),
+    ),
+  },
+]
+
+// testing-selectors §1/§5: every interactive element carries data-testid.
+// Native elements + the shadcn wrappers we compose; a spread may carry the attribute, so it is exempt.
+const INTERACTIVE = 'button|a|input|select|textarea|Button|Input'
+const MISSING_TESTID = {
+  selector: `JSXOpeningElement[name.name=/^(${INTERACTIVE})$/]:not(:has(JSXAttribute[name.name="data-testid"])):not(:has(JSXSpreadAttribute))`,
+  message:
+    'Interactive element without data-testid="feature-element-qualifier" (testing-selectors §1).',
+}
+
+export default defineConfig(
+  // core-rules §10.2: shadcn output is generated, never linted. routeTree is generated too.
+  globalIgnores([
+    'node_modules',
+    'dist',
+    'coverage',
+    'docs/ai-rules',
+    'src/components/ui/',
+    'src/routeTree.gen.ts',
+    'playwright-report',
+    'test-results',
+  ]),
+  js.configs.recommended,
+  tseslint.configs.strict,
+  tseslint.configs.stylistic,
+  {
+    // core-rules §10.2: only these two import rules; ordering is Prettier's job (§10.1)
+    rules: {
+      'no-duplicate-imports': 'error',
+      '@typescript-eslint/consistent-type-imports': 'error',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
+      ],
+    },
+  },
+  {
+    files: ['src/**/*.{ts,tsx}'],
+    extends: [
+      reactHooks.configs.flat.recommended,
+      jsxA11y.flatConfigs.recommended,
+    ],
+    languageOptions: { globals: globals.browser },
+    rules: {
+      'no-restricted-imports': restrictedImports(),
+      'no-restricted-syntax': ['error', MISSING_TESTID],
+      // React Compiler is not enabled; TanStack Table (a dogma) trips this heuristic.
+      'react-hooks/incompatible-library': 'off',
+      // a11y §1.2: reinforced severity
+      'jsx-a11y/alt-text': 'error',
+      'jsx-a11y/anchor-has-content': 'error',
+      'jsx-a11y/anchor-is-valid': [
+        'error',
+        {
+          components: ['Link'],
+          specialLink: ['to'],
+          aspects: ['noHref', 'invalidHref', 'preferButton'],
+        },
+      ],
+      'jsx-a11y/aria-activedescendant-has-tabindex': 'error',
+      'jsx-a11y/aria-props': 'error',
+      'jsx-a11y/aria-proptypes': 'error',
+      'jsx-a11y/aria-role': ['error', { ignoreNonDOM: true }],
+      'jsx-a11y/aria-unsupported-elements': 'error',
+      'jsx-a11y/autocomplete-valid': 'error',
+      'jsx-a11y/click-events-have-key-events': 'error',
+      'jsx-a11y/heading-has-content': 'error',
+      'jsx-a11y/html-has-lang': 'error',
+      'jsx-a11y/img-redundant-alt': 'error',
+      'jsx-a11y/interactive-supports-focus': 'error',
+      'jsx-a11y/label-has-associated-control': 'error',
+      'jsx-a11y/lang': 'error',
+      'jsx-a11y/media-has-caption': 'error',
+      'jsx-a11y/mouse-events-have-key-events': 'error',
+      'jsx-a11y/no-access-key': 'error',
+      'jsx-a11y/no-autofocus': ['error', { ignoreNonDOM: true }],
+      'jsx-a11y/no-distracting-elements': 'error',
+      'jsx-a11y/no-interactive-element-to-noninteractive-role': 'error',
+      'jsx-a11y/no-noninteractive-element-interactions': 'error',
+      'jsx-a11y/no-noninteractive-element-to-interactive-role': 'error',
+      'jsx-a11y/no-noninteractive-tabindex': 'error',
+      'jsx-a11y/no-redundant-roles': 'error',
+      'jsx-a11y/no-static-element-interactions': 'error',
+      'jsx-a11y/role-has-required-aria-props': 'error',
+      'jsx-a11y/role-supports-aria-props': 'error',
+      'jsx-a11y/scope': 'error',
+      'jsx-a11y/tabindex-no-positive': 'error',
+    },
+  },
+  // Seams: the only places allowed to touch the underlying libraries.
+  {
+    files: ['src/lib/apiClient.ts'],
+    rules: { 'no-restricted-imports': restrictedImports(['axios']) },
+  },
+  {
+    files: ['src/stores/**'],
+    rules: { 'no-restricted-imports': restrictedImports(variants.stateLibs) },
+  },
+)

package/templates/fe/base/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="it">
+  <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>__NAME__</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/fe/base/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "__NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build",
+    "preview": "vite preview",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+    "e2e": "playwright test",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc --noEmit",
+    "verify": "bun run typecheck && bun run lint && bun run format:check && bun run agents:check && bun run test",
+    "rules:sync": "bun scripts/rules-sync.ts",
+    "rules:check": "bun scripts/rules-check.ts",
+    "agents:build": "bun scripts/agents-build.ts",
+    "agents:check": "bun scripts/agents-build.ts --check"
+  },
+  "dependencies": {
+    "@tailwindcss/vite": "^4.3.3",
+    "@tanstack/react-query": "^5.103.1",
+    "@tanstack/react-router": "^1.170.38",
+    "@tanstack/react-table": "^8",
+    "axios": "^1.20.0",
+    "lucide-react": "^1.47.0",
+    "react": "^19",
+    "react-dom": "^19",
+    "tailwindcss": "^4.3.3",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@playwright/test": "^1.63.0",
+    "@tanstack/router-plugin": "^1.168.40",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.3",
+    "@testing-library/user-event": "^14.6.7",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
+    "@types/bun": "^1.4.2",
+    "@types/node": "^26.6.1",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-react": "^5",
+    "@vitest/coverage-v8": "^5.0.1",
+    "eslint": "^9",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "globals": "^17.12.0",
+    "jsdom": "^30.1.0",
+    "msw": "^2.15.0",
+    "prettier": "^3.9.8",
+    "typescript": "^5",
+    "typescript-eslint": "^8.70.0",
+    "vite": "^7",
+    "vitest": "^5.0.1"
+  }
+}

package/templates/fe/base/playwright.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig, devices } from '@playwright/test'
+
+export default defineConfig({
+  testDir: 'e2e',
+  fullyParallel: true,
+  forbidOnly: Boolean(process.env.CI),
+  retries: process.env.CI ? 1 : 0,
+  reporter: process.env.CI ? 'github' : 'list',
+  use: { baseURL: 'http://localhost:3000', trace: 'on-first-retry' },
+  projects: [{ name: 'chromium', use: { ...devices['Desktop Chrome'] } }],
+  webServer: {
+    command: 'bun run dev',
+    url: 'http://localhost:3000',
+    reuseExistingServer: !process.env.CI,
+    timeout: 60_000,
+  },
+})

package/templates/fe/base/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="48" height="46" fill="none" viewBox="0 0 48 46"><path fill="#863bff" d="M25.946 44.938c-.664.845-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.287c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.497 0-3.578-1.842-3.578H1.237c-.92 0-1.456-1.04-.92-1.788L10.013.474c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.579 1.842 3.579h11.377c.943 0 1.473 1.088.89 1.83L25.947 44.94z" style="fill:#863bff;fill:color(display-p3 .5252 .23 1);fill-opacity:1"/><mask id="a" width="48" height="46" x="0" y="0" maskUnits="userSpaceOnUse" style="mask-type:alpha"><path fill="#000" d="M25.842 44.938c-.664.844-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.183c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.498 0-3.579-1.842-3.579H1.133c-.92 0-1.456-1.04-.92-1.787L9.91.473c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.578 1.842 3.578h11.377c.943 0 1.473 1.088.89 1.832L25.843 44.94z" style="fill:#000;fill-opacity:1"/></mask><g mask="url(#a)"><g filter="url(#b)"><ellipse cx="5.508" cy="14.704" fill="#ede6ff" rx="5.508" ry="14.704" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -4.47 31.516)"/></g><g filter="url(#c)"><ellipse cx="10.399" cy="29.851" fill="#ede6ff" rx="10.399" ry="29.851" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -39.328 7.883)"/></g><g filter="url(#d)"><ellipse cx="5.508" cy="30.487" fill="#7e14ff" rx="5.508" ry="30.487" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -25.913 -14.639)scale(1 -1)"/></g><g filter="url(#e)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -32.644 -3.334)scale(1 -1)"/></g><g filter="url(#f)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -34.34 30.47)"/></g><g filter="url(#g)"><ellipse cx="14.072" cy="22.078" fill="#ede6ff" rx="14.072" ry="22.078" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="rotate(93.35 24.506 48.493)scale(-1 1)"/></g><g filter="url(#h)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#i)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#j)"><ellipse cx=".387" cy="8.972" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(39.51 .387 8.972)"/></g><g filter="url(#k)"><ellipse cx="47.523" cy="-6.092" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 47.523 -6.092)"/></g><g filter="url(#l)"><ellipse cx="41.412" cy="6.333" fill="#47bfff" rx="5.971" ry="9.665" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 41.412 6.333)"/></g><g filter="url(#m)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#n)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#o)"><ellipse cx="35.651" cy="29.907" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 35.651 29.907)"/></g><g filter="url(#p)"><ellipse cx="38.418" cy="32.4" fill="#47bfff" rx="5.971" ry="15.297" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 38.418 32.4)"/></g></g><defs><filter id="b" width="60.045" height="41.654" x="-19.77" y="16.149" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="c" width="90.34" height="51.437" x="-54.613" y="-7.533" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="d" width="79.355" height="29.4" x="-49.64" y="2.03" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="e" width="79.579" height="29.4" x="-45.045" y="20.029" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="f" width="79.579" height="29.4" x="-43.513" y="21.178" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="g" width="74.749" height="58.852" x="15.756" y="-17.901" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="h" width="61.377" height="25.362" x="23.548" y="2.284" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="i" width="61.377" height="25.362" x="23.548" y="2.284" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="j" width="56.045" height="63.649" x="-27.636" y="-22.853" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="k" width="54.814" height="64.646" x="20.116" y="-38.415" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="l" width="33.541" height="35.313" x="24.641" y="-11.323" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="m" width="54.814" height="64.646" x="-29.286" y="6.009" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="n" width="54.814" height="64.646" x="-29.286" y="6.009" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="o" width="54.814" height="64.646" x="8.244" y="-2.416" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="p" width="39.409" height="43.623" x="18.713" y="10.588" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter></defs></svg>

package/templates/fe/base/public/icons.svg

@@ -0,0 +1,24 @@
+<svg xmlns="http://www.w3.org/2000/svg">
+  <symbol id="bluesky-icon" viewBox="0 0 16 17">
+    <g clip-path="url(#bluesky-clip)"><path fill="#08060d" d="M7.75 7.735c-.693-1.348-2.58-3.86-4.334-5.097-1.68-1.187-2.32-.981-2.74-.79C.188 2.065.1 2.812.1 3.251s.241 3.602.398 4.13c.52 1.744 2.367 2.333 4.07 2.145-2.495.37-4.71 1.278-1.805 4.512 3.196 3.309 4.38-.71 4.987-2.746.608 2.036 1.307 5.91 4.93 2.746 2.72-2.746.747-4.143-1.747-4.512 1.702.189 3.55-.4 4.07-2.145.156-.528.397-3.691.397-4.13s-.088-1.186-.575-1.406c-.42-.19-1.06-.395-2.741.79-1.755 1.24-3.64 3.752-4.334 5.099"/></g>
+    <defs><clipPath id="bluesky-clip"><path fill="#fff" d="M.1.85h15.3v15.3H.1z"/></clipPath></defs>
+  </symbol>
+  <symbol id="discord-icon" viewBox="0 0 20 19">
+    <path fill="#08060d" d="M16.224 3.768a14.5 14.5 0 0 0-3.67-1.153c-.158.286-.343.67-.47.976a13.5 13.5 0 0 0-4.067 0c-.128-.306-.317-.69-.476-.976A14.4 14.4 0 0 0 3.868 3.77C1.546 7.28.916 10.703 1.231 14.077a14.7 14.7 0 0 0 4.5 2.306q.545-.748.965-1.587a9.5 9.5 0 0 1-1.518-.74q.191-.14.372-.293c2.927 1.369 6.107 1.369 8.999 0q.183.152.372.294-.723.437-1.52.74.418.838.963 1.588a14.6 14.6 0 0 0 4.504-2.308c.37-3.911-.63-7.302-2.644-10.309m-9.13 8.234c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.894 0 1.614.82 1.599 1.82.001 1-.705 1.82-1.6 1.82m5.91 0c-.878 0-1.599-.82-1.599-1.82 0-.998.705-1.82 1.6-1.82.893 0 1.614.82 1.599 1.82 0 1-.706 1.82-1.6 1.82"/>
+  </symbol>
+  <symbol id="documentation-icon" viewBox="0 0 21 20">
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="m15.5 13.333 1.533 1.322c.645.555.967.833.967 1.178s-.322.623-.967 1.179L15.5 18.333m-3.333-5-1.534 1.322c-.644.555-.966.833-.966 1.178s.322.623.966 1.179l1.534 1.321"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M17.167 10.836v-4.32c0-1.41 0-2.117-.224-2.68-.359-.906-1.118-1.621-2.08-1.96-.599-.21-1.349-.21-2.848-.21-2.623 0-3.935 0-4.983.369-1.684.591-3.013 1.842-3.641 3.428C3 6.449 3 7.684 3 10.154v2.122c0 2.558 0 3.838.706 4.726q.306.383.713.671c.76.536 1.79.64 3.581.66"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M3 10a2.78 2.78 0 0 1 2.778-2.778c.555 0 1.209.097 1.748-.047.48-.129.854-.503.982-.982.145-.54.048-1.194.048-1.749a2.78 2.78 0 0 1 2.777-2.777"/>
+  </symbol>
+  <symbol id="github-icon" viewBox="0 0 19 19">
+    <path fill="#08060d" fill-rule="evenodd" d="M9.356 1.85C5.05 1.85 1.57 5.356 1.57 9.694a7.84 7.84 0 0 0 5.324 7.44c.387.079.528-.168.528-.376 0-.182-.013-.805-.013-1.454-2.165.467-2.616-.935-2.616-.935-.349-.91-.864-1.143-.864-1.143-.71-.48.051-.48.051-.48.787.051 1.2.805 1.2.805.695 1.194 1.817.857 2.268.649.064-.507.27-.857.49-1.052-1.728-.182-3.545-.857-3.545-3.87 0-.857.31-1.558.8-2.104-.078-.195-.349-1 .077-2.078 0 0 .657-.208 2.14.805a7.5 7.5 0 0 1 1.946-.26c.657 0 1.328.092 1.946.26 1.483-1.013 2.14-.805 2.14-.805.426 1.078.155 1.883.078 2.078.502.546.799 1.247.799 2.104 0 3.013-1.818 3.675-3.558 3.87.284.247.528.714.528 1.454 0 1.052-.012 1.896-.012 2.156 0 .208.142.455.528.377a7.84 7.84 0 0 0 5.324-7.441c.013-4.338-3.48-7.844-7.773-7.844" clip-rule="evenodd"/>
+  </symbol>
+  <symbol id="social-icon" viewBox="0 0 20 20">
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M12.5 6.667a4.167 4.167 0 1 0-8.334 0 4.167 4.167 0 0 0 8.334 0"/>
+    <path fill="none" stroke="#aa3bff" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.35" d="M2.5 16.667a5.833 5.833 0 0 1 8.75-5.053m3.837.474.513 1.035c.07.144.257.282.414.309l.93.155c.596.1.736.536.307.965l-.723.73a.64.64 0 0 0-.152.531l.207.903c.164.715-.213.991-.84.618l-.872-.52a.63.63 0 0 0-.577 0l-.872.52c-.624.373-1.003.094-.84-.618l.207-.903a.64.64 0 0 0-.152-.532l-.723-.729c-.426-.43-.289-.864.306-.964l.93-.156a.64.64 0 0 0 .412-.31l.513-1.034c.28-.562.735-.562 1.012 0"/>
+  </symbol>
+  <symbol id="x-icon" viewBox="0 0 19 19">
+    <path fill="#08060d" fill-rule="evenodd" d="M1.893 1.98c.052.072 1.245 1.769 2.653 3.77l2.892 4.114c.183.261.333.48.333.486s-.068.089-.152.183l-.522.593-.765.867-3.597 4.087c-.375.426-.734.834-.798.905a1 1 0 0 0-.118.148c0 .01.236.017.664.017h.663l.729-.83c.4-.457.796-.906.879-.999a692 692 0 0 0 1.794-2.038c.034-.037.301-.34.594-.675l.551-.624.345-.392a7 7 0 0 1 .34-.374c.006 0 .93 1.306 2.052 2.903l2.084 2.965.045.063h2.275c1.87 0 2.273-.003 2.266-.021-.008-.02-1.098-1.572-3.894-5.547-2.013-2.862-2.28-3.246-2.273-3.266.008-.019.282-.332 2.085-2.38l2-2.274 1.567-1.782c.022-.028-.016-.03-.65-.03h-.674l-.3.342a871 871 0 0 1-1.782 2.025c-.067.075-.405.458-.75.852a100 100 0 0 1-.803.91c-.148.172-.299.344-.99 1.127-.304.343-.32.358-.345.327-.015-.019-.904-1.282-1.976-2.808L6.365 1.85H1.8zm1.782.91 8.078 11.294c.772 1.08 1.413 1.973 1.425 1.984.016.017.241.02 1.05.017l1.03-.004-2.694-3.766L7.796 5.75 5.722 2.852l-1.039-.004-1.039-.004z" clip-rule="evenodd"/>
+  </symbol>
+</svg>

package/templates/fe/base/scripts/agents-build.ts

@@ -0,0 +1,26 @@
+import { join } from 'node:path'
+
+/** Fragment order, written by create-simone-app for the chosen variants. */
+const FRAGMENTS: string[] = await Bun.file('docs/agents/fragments.json').json()
+const OUT = 'AGENTS.md'
+const HEADER =
+  '<!-- Generated by `bun run agents:build` from docs/agents/*.md. Edit the fragments, not this file. -->\n\n'
+
+const parts = await Promise.all(
+  FRAGMENTS.map((name) => Bun.file(join('docs/agents', `${name}.md`)).text()),
+)
+const built = HEADER + parts.map((p) => p.trim()).join('\n\n') + '\n'
+
+if (process.argv.includes('--check')) {
+  const current = (await Bun.file(OUT).exists())
+    ? await Bun.file(OUT).text()
+    : ''
+  if (current !== built) {
+    console.error(`${OUT} is stale: run \`bun run agents:build\``)
+    process.exit(1)
+  }
+  console.log(`${OUT} up to date (${built.split('\n').length} lines)`)
+} else {
+  await Bun.write(OUT, built)
+  console.log(`wrote ${OUT} (${built.split('\n').length} lines)`)
+}

package/templates/fe/base/scripts/rules-check.ts

@@ -0,0 +1,48 @@
+import { join } from 'node:path'
+
+import {
+  MANIFEST,
+  type Manifest,
+  RULES_DIR,
+  rulesSource,
+  sha256,
+} from './rules.config'
+
+const manifestFile = Bun.file(MANIFEST)
+if (!(await manifestFile.exists())) {
+  console.error(`${MANIFEST} missing: run \`bun run rules:sync\``)
+  process.exit(1)
+}
+const manifest: Manifest = await manifestFile.json()
+const source = rulesSource()
+const upstreamAvailable = await Bun.file(join(source, 'README.md')).exists()
+let failed = false
+
+for (const entry of manifest.files) {
+  const local = join(RULES_DIR, entry.file)
+  if (!(await Bun.file(local).exists())) {
+    console.error(`missing ${local}`)
+    failed = true
+    continue
+  }
+  if ((await sha256(local)) !== entry.sha256) {
+    console.error(`${local} differs from MANIFEST (edited by hand?)`)
+    failed = true
+  }
+  if (upstreamAvailable) {
+    const upstream = join(source, entry.source)
+    if ((await sha256(upstream)) !== entry.sha256) {
+      console.error(
+        `${entry.source} changed upstream: run \`bun run rules:sync\``,
+      )
+      failed = true
+    }
+  }
+}
+
+if (!upstreamAvailable)
+  console.warn(`ai-rules not found at ${source}: checked local integrity only`)
+if (failed) process.exit(1)
+console.log(
+  `ai-rules ok (${manifest.files.length} files, synced ${manifest.syncedAt})`,
+)

package/templates/fe/base/scripts/rules-sync.ts

@@ -0,0 +1,35 @@
+import { mkdir } from 'node:fs/promises'
+import { basename, join } from 'node:path'
+
+import {
+  MANIFEST,
+  type Manifest,
+  RULES,
+  RULES_DIR,
+  rulesSource,
+  sha256,
+} from './rules.config'
+
+const source = rulesSource()
+if (!(await Bun.file(join(source, 'README.md')).exists())) {
+  console.error(`ai-rules not found at ${source} (set AI_RULES_PATH)`)
+  process.exit(1)
+}
+
+await mkdir(RULES_DIR, { recursive: true })
+const manifest: Manifest = { syncedAt: new Date().toISOString(), files: [] }
+
+for (const rule of RULES) {
+  const from = join(source, rule)
+  const to = join(RULES_DIR, basename(rule))
+  await Bun.write(to, Bun.file(from))
+  manifest.files.push({
+    file: basename(rule),
+    source: rule,
+    sha256: await sha256(to),
+  })
+  console.log(`synced ${rule}`)
+}
+
+await Bun.write(MANIFEST, JSON.stringify(manifest, null, 2) + '\n')
+console.log(`wrote ${MANIFEST}`)

package/templates/fe/base/scripts/rules.config.ts

@@ -0,0 +1,35 @@
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+/** ai-rules files (relative to the ai-rules repo root) mirrored into docs/ai-rules. */
+export const RULES = [
+  'frontend/react-stack/core-rules.md',
+  'frontend/react-stack/tanstack-ecosystem.md',
+  'frontend/react-stack/ui-shadcn.md',
+  'frontend/react-stack/a11y.md',
+  'frontend/testing-selectors.md',
+  'frontend/accessibility-legge-stanca.md',
+] as const
+
+export const RULES_DIR = 'docs/ai-rules'
+export const MANIFEST = join(RULES_DIR, 'MANIFEST.json')
+
+export const rulesSource = (): string =>
+  process.env.AI_RULES_PATH ?? join(homedir(), 'Progetti', 'ai-rules')
+
+export interface ManifestEntry {
+  file: string
+  source: string
+  sha256: string
+}
+
+export interface Manifest {
+  syncedAt: string
+  files: ManifestEntry[]
+}
+
+export const sha256 = async (path: string): Promise<string> => {
+  const hasher = new Bun.CryptoHasher('sha256')
+  hasher.update(await Bun.file(path).arrayBuffer())
+  return hasher.digest('hex')
+}

package/templates/fe/base/src/components/shared/EmptyState.tsx

@@ -0,0 +1,23 @@
+import { SearchX } from 'lucide-react'
+
+interface EmptyStateProps {
+  title: string
+  description?: string
+  testId: string
+}
+
+export function EmptyState({ title, description, testId }: EmptyStateProps) {
+  return (
+    <div
+      role="status"
+      className="flex flex-col items-center gap-2 rounded-lg border border-dashed px-6 py-12 text-center"
+      data-testid={testId}
+    >
+      <SearchX aria-hidden="true" className="size-8 text-muted-foreground" />
+      <p className="font-medium">{title}</p>
+      {description && (
+        <p className="text-sm text-muted-foreground">{description}</p>
+      )}
+    </div>
+  )
+}

package/templates/fe/base/src/components/shared/ErrorState.tsx

@@ -0,0 +1,37 @@
+import { AlertCircle } from 'lucide-react'
+
+import {
+  Alert,
+  AlertAction,
+  AlertDescription,
+  AlertTitle,
+} from '@/components/ui/alert'
+import { Button } from '@/components/ui/button'
+
+interface ErrorStateProps {
+  message: string
+  onRetry?: () => void
+  testId: string
+}
+
+export function ErrorState({ message, onRetry, testId }: ErrorStateProps) {
+  return (
+    <Alert variant="destructive" role="alert" data-testid={testId}>
+      <AlertCircle aria-hidden="true" />
+      <AlertTitle>Si è verificato un errore</AlertTitle>
+      <AlertDescription>{message}</AlertDescription>
+      {onRetry && (
+        <AlertAction>
+          <Button
+            variant="outline"
+            size="sm"
+            onClick={onRetry}
+            data-testid={`${testId}-retry-button`}
+          >
+            Riprova
+          </Button>
+        </AlertAction>
+      )}
+    </Alert>
+  )
+}

package/templates/fe/base/src/components/shared/PageHeader.tsx

@@ -0,0 +1,21 @@
+import type { ReactNode } from 'react'
+
+interface PageHeaderProps {
+  title: string
+  description?: string
+  children?: ReactNode
+}
+
+export function PageHeader({ title, description, children }: PageHeaderProps) {
+  return (
+    <div className="mb-6 flex flex-wrap items-end justify-between gap-4">
+      <div>
+        <h1 className="text-2xl font-semibold tracking-tight">{title}</h1>
+        {description && (
+          <p className="mt-1 text-muted-foreground">{description}</p>
+        )}
+      </div>
+      {children}
+    </div>
+  )
+}

package/templates/fe/base/src/features/users/UserSearch.tsx

@@ -0,0 +1,48 @@
+import { type ChangeEvent, useEffect, useRef, useState } from 'react'
+
+import { Input } from '@/components/ui/input'
+
+interface UserSearchProps {
+  value: string
+  onChange: (q: string) => void
+  /** Debounce in ms before `onChange` fires. */
+  delay?: number
+}
+
+export function UserSearch({ value, onChange, delay = 300 }: UserSearchProps) {
+  const [draft, setDraft] = useState(value)
+  const [lastValue, setLastValue] = useState(value)
+  const timer = useRef<ReturnType<typeof setTimeout>>(undefined)
+
+  // External value changed (back/forward, reset): adopt it during render, no effect needed.
+  if (value !== lastValue) {
+    setLastValue(value)
+    setDraft(value)
+  }
+
+  useEffect(() => () => clearTimeout(timer.current), [])
+
+  const handleChange = (event: ChangeEvent<HTMLInputElement>) => {
+    const next = event.target.value
+    setDraft(next)
+    clearTimeout(timer.current)
+    timer.current = setTimeout(() => onChange(next.trim()), delay)
+  }
+
+  return (
+    <div className="mb-4 flex max-w-sm flex-col gap-1.5">
+      <label htmlFor="users-search-input" className="text-sm font-medium">
+        Cerca
+      </label>
+      <Input
+        id="users-search-input"
+        type="search"
+        placeholder="Nome o email"
+        autoComplete="off"
+        value={draft}
+        onChange={handleChange}
+        data-testid="users-search-input"
+      />
+    </div>
+  )
+}