antd-admin/docs/superpowers/specs/2026-04-14-apps-basic-template-design.md

Design: apps/basic template (from with-lingui, English-only)

1. Summary

Add a new workspace app apps/basic created by copying apps/with-lingui and removing all Lingui-based internationalization, language switching UI, and related tooling. User-facing strings are hard-coded English. Ant Design uses a fixed en_US locale via ConfigProvider. Root README.md documents both templates.

2. Goals and non-goals

Goals

• Parity with with-lingui for product features: auth, RBAC, menus, CRUD, MSW, Playwright, build/lint stack.
• No @lingui/* dependencies, no .po catalogs, no i18n:* npm scripts, no Lingui Vite/SWC plugins.
• No runtime language switcher; document.documentElement.lang set to en once at app shell level.

Non-goals

• No shared packages/* extraction to deduplicate basic vs with-lingui.
• No changes to with-lingui behavior unless a follow-up explicitly requests README or cross-app consistency edits beyond what is listed here.

3. Recommended approach

Copy-and-subtract (directory fork) — duplicate apps/with-lingui → apps/basic, then delete Lingui artifacts and replace t/msg usage with equivalent English strings. Rationale: Clear mapping from source to target, predictable Turbo/pnpm layout (apps/* already wired), minimal architectural risk.

Alternatives rejected: shared core package (too large for this request); documentation-only template (does not deliver a runnable app).

4. Language and Ant Design

• All UI copy, aria-labels, menu titles, table empty states, etc.: English literals in TSX.
• ConfigProvider: import enUS from "antd/locale/en_US" and locale={enUS} (static, not from store).
• Remove zh_CN imports and any locale map keyed by user preference.

5. File and configuration changes

5.1 Remove entirely

• lingui.config.ts
• src/lingui.d.ts
• src/locales/ (compiled and source catalogs as present in source tree)

5.2 package.json (apps/basic)

• Remove dependencies: @lingui/core, @lingui/react, @lingui/cli, @lingui/swc-plugin, @lingui/vite-plugin.
• Remove scripts: i18n:extract, i18n:compile (if present).
• Set name to a unique workspace package name (e.g. antd-admin-basic). The source app currently uses antd-admin; duplicate name values across apps/* can confuse tooling, so basic must not reuse the same name.

5.3 vite.config.ts

• Remove lingui() from plugins and @lingui/swc-plugin from React plugin options.

5.4 Entry and root

• **src/main.tsx:** Remove Lingui i18n load/activate and .po imports; keep React DOM render unchanged otherwise.
• **src/routes/__root.tsx:** Remove I18nProvider, i18n import/effects; wrap tree with ConfigProvider using fixed enUS; set document.documentElement.lang = "en" once (e.g. useLayoutEffect on mount or equivalent pattern already used in codebase).

5.5 Settings store

• Remove Locale type, locale, setLocale, and locale from partialize.
• Keep darkMode, sidebarCollapsed, and their actions unchanged.
• Persist storage name: Prefer a distinct name in createPersistentStore options (e.g. settings-storage-basic) so localStorage from with-lingui and basic never collide when developers alternate apps on the same origin during local testing.

5.6 Components and routes

Replace Lingui in every file that currently imports useLingui / msg / macro APIs with plain strings. Known touchpoints from repository scan:

• src/routes/login/index.tsx — remove language toggle UI and related store usage.
• src/components/Layout/Header/index.tsx — remove language toggle.
• src/components/Layout/Sidebar/index.tsx — replace msg/t menu labels with English strings.
• src/components/Layout/AppFooter/index.tsx, NotFound, DataTable/DataTableEmpty.tsx
• src/routes/_auth/dashboard, 403, users (+ -Toolbar, -FormModal)

5.7 Mock data

• No i18n requirement; keep mock user names/emails as-is unless an assertion or UI string assumes Chinese (none identified in E2E for locale). If any visible mock field is Chinese-only for demos, translate to English for consistency with A.

6. Error handling and edge cases

• Missing translations: N/A after removal.
• Hydration / SSR: Current app is client Vite SPA; no change to strategy.
• Table locale prop: DataTable may still merge restTableProps.locale; default empty text remains English via updated DataTableEmpty copy. No user-controlled Antd locale switch.

7. Testing and acceptance

• vp build (or project-standard build) succeeds for apps/basic.
• vp run lint (or equivalent) passes.
• Playwright suite for apps/basic passes; update selectors only if any depended on Chinese UI text (grep during implementation).
• Manual smoke: login, dashboard, users list, 403, theme toggle, sidebar collapse — all labels English.

8. Documentation

• **apps/basic/README.md (if present after copy):** State English-only, no Lingui, pointer to with-lingui for i18n variant.
• Root README.md: Add a short "Templates" (or equivalent) subsection: describe apps/with-lingui vs apps/basic, how to run each (vp dev from app directory or documented pnpm/turbo filter), remove or soften global wording that implies a single Lingui-only stack if it would mislead (e.g. tech table row for i18n should clarify it applies to the Lingui app).

9. Maintenance note (drift control)

Two apps will duplicate business logic until a future extraction. Convention for this repo: feature and bugfix work lands in **with-lingui first** unless the change is basic-only; port to basic in the same PR when behavior should stay aligned, or document exception. This is guidance for contributors, not enforced by tooling.

10. Implementation handoff

After this spec is approved in review, use the writing-plans skill to produce a step-by-step implementation plan (ordered edits, verification commands, PR checklist).