chore: scaffold apps/basic from with-lingui

Made-with: Cursor

apps/basic/.github/instructions/README.md

@@ -0,0 +1,17 @@
+# AI Instruction Files
+
+This directory contains scoped instruction files used by AI coding agents.
+
+## Files
+
+- `frontend.instructions.md`: UI/routes/components/style changes
+- `testing.instructions.md`: Playwright/MSW/test changes
+- `api.instructions.md`: API client/schema/handler changes
+- `refactor.instructions.md`: behavior-preserving cleanup and deduplication
+
+## Authoring Rules
+
+- Keep each file focused on one domain.
+- Put trigger phrases in `description` so agents can discover the file.
+- Use narrow `applyTo` patterns to avoid unnecessary context load.
+- Keep instructions executable: short Do/Do Not/Validation sections.

apps/basic/.github/instructions/api.instructions.md

@@ -0,0 +1,29 @@
+---
+applyTo: "src/api/**/*.ts,src/utils/http.ts,src/mocks/handlers/**/*.ts,src/mocks/createHandler.ts"
+description: "Use when editing API clients, schemas, HTTP behavior, response types, or MSW endpoint handlers. Keywords: api, http, schema, zod, handler, endpoint, auth, users."
+---
+
+# API Instructions
+
+## Purpose
+
+Maintain strict API contracts and consistent server/client mock behavior.
+
+## Do
+
+- Keep request/response shapes schema-driven and type-safe.
+- Reuse endpoint constants and shared response helpers.
+- Keep handler response envelope consistent (`code`, `data`, `message`).
+- Ensure mock handlers reflect real API behavior and error semantics.
+- Keep naming stable for endpoint keys and mutation/query keys.
+
+## Do Not
+
+- Do not return ad-hoc response shapes for one-off convenience.
+- Do not bypass schema parsing in new client mutations/queries.
+- Do not mix unrelated domain endpoints in the same module.
+
+## Validation
+
+- Verify TypeScript and schema parsing paths compile cleanly.
+- Run: `vp check --no-fmt`

apps/basic/.github/instructions/frontend.instructions.md

@@ -0,0 +1,31 @@
+---
+applyTo: "src/**/*.{ts,tsx,css}"
+description: "Use when editing React UI, route pages, components, styles, layout, i18n text, or Ant Design behavior. Keywords: frontend, component, page, ui, layout, style, antd, i18n."
+---
+
+# Frontend Instructions
+
+## Purpose
+
+Keep frontend changes predictable, minimal, and reusable for AI-assisted edits.
+
+## Do
+
+- Preserve existing route contracts and UI behavior unless explicitly asked.
+- Prefer reusable components and hooks over copy-paste logic.
+- Keep styles token-driven using existing theme/store patterns.
+- For Ant Design styling, follow this priority: component native API (`variant`/`type`/`size`/`styles`/`classNames`) -> `theme.useToken()` with inline `style` -> `className` + external CSS.
+- Keep translations compatible with Lingui macros and catalogs.
+- Follow current folder conventions under src/components and src/routes.
+
+## Do Not
+
+- Do not introduce new UI libraries when Ant Design already covers the need.
+- Do not bypass existing theme/store abstractions with hardcoded global state.
+- Do not write CSS overrides first when props or semantic `styles` can express the same UI.
+- Do not refactor unrelated files in the same change.
+
+## Validation
+
+- Run: `vp check --no-fmt`
+- For UI flow changes, run focused e2e where possible.

apps/basic/.github/instructions/refactor.instructions.md

@@ -0,0 +1,37 @@
+---
+
+## applyTo: "src/\*_/_.{ts,tsx}"
+
+description: "Use when refactoring existing code for deduplication, modularization, naming cleanup, or maintainability improvements without behavior changes. Keywords: refactor, cleanup, simplify, deduplicate, maintainability."
+
+# Refactor Instructions
+
+## Purpose
+
+Reduce duplication while preserving behavior and public contracts.
+
+## Do
+
+- Keep refactors incremental and scoped to one concern per change.
+- Prefer extracting shared utilities/hooks/components over large rewrites.
+- Preserve existing external behavior and route/store contracts.
+- Keep diffs reviewable with minimal unrelated formatting churn.
+- Add or update lightweight comments only when logic is non-obvious.
+
+## Do Not
+
+- Do not change runtime behavior unless explicitly requested.
+- Do not rename broadly across the codebase without clear benefit.
+- Do not delete tests that still cover unique critical scenarios.
+- Do not introduce large dependencies for minor convenience; prefer composition or small utilities.
+
+## Considerations
+
+- Bundle: Main app chunk is ~135KB (gzip ~41KB). Ant Design (vendor-antd) and TanStack (vendor-tanstack) are in separate chunks for parallel loading. Avoid adding large UI libraries when Ant Design covers the need.
+- Type safety: Keep validations at API boundaries (Zod schemas) rather than adding more runtime checks throughout the app.
+
+## Validation
+
+- Confirm no new diagnostics in touched files.
+- Run: `vp check --no-fmt`
+- For significant changes, verify bundle size impact: `vp build 2>&1 | grep "kB"`

apps/basic/.github/instructions/testing.instructions.md

@@ -0,0 +1,30 @@
+---
+
+## applyTo: "tests/**/\*.ts,tests/**/_.tsx,src/mocks/\*\*/_.ts,playwright.config.ts"
+
+description: "Use when adding or editing tests, Playwright cases, MSW handlers, mock data, or test configuration. Keywords: test, e2e, playwright, mock, msw, coverage."
+
+# Testing Instructions
+
+## Purpose
+
+Keep tests fast, deterministic, and aligned with core business flows.
+
+## Do
+
+- Prioritize core flows first (auth, users CRUD, permission gates).
+- Keep assertions user-visible and behavior-focused.
+- Reuse existing helper patterns in tests before adding new helpers.
+- Keep mock handlers and mock data synchronized with API schemas.
+- Prefer focused test runs over full-suite runs during iteration.
+
+## Do Not
+
+- Do not add brittle selectors tied to unstable DOM internals.
+- Do not expand fixture data without a clear scenario need.
+- Do not duplicate scenarios already covered by existing tests.
+
+## Validation
+
+- Run focused tests first, then broader checks if needed.
+- Run: `vp check --no-fmt`