Frontend documentation (docs/frontend)

February 27, 2026 · View on GitHub

Index for Angular/TypeScript frontend standards in core-web. Cursor uses .cursor/rules/frontend-context.mdc, which points here; use @docs/frontend/README.md for this index or @docs/frontend/<file> to load a specific doc.

Documents

DocWhen to load
ANGULAR_STANDARDS.mdComponents, templates, signals, OnPush, PrimeNG, testing stack
BREADCRUMBS.mdGlobalStore breadcrumbs: addNewBreadcrumb, setBreadcrumbs, id/url for tabs, duplicate prevention
COMPONENT_ARCHITECTURE.mdComponent structure, file layout, data flow, parent-child
STATE_MANAGEMENT.mdNgRx Signal Store, rxMethod, patchState — prefer over manual state
STYLING_STANDARDS.mdTailwind CSS, PrimeNG theme, BEM (when needed), SCSS variables
TESTING_FRONTEND.mdSpectator, Jest/Vitest, byTestId, setInput, data-testid
TYPESCRIPT_STANDARDS.mdStrict types, inference, unknown, as const, # private

Congruence

  • Signals: $ prefix (e.g. $loading) — ANGULAR_STANDARDS, COMPONENT_ARCHITECTURE, TESTING_FRONTEND.
  • State: Use NgRx Signal Store for feature state; avoid manual signal soup — STATE_MANAGEMENT, COMPONENT_ARCHITECTURE.
  • Breadcrumbs: GlobalStore only; use addNewBreadcrumb with id or url for tabs/sub-routes to avoid duplicates — BREADCRUMBS.
  • Testing: Spectator, byTestId, setInput, detectChanges, click — TESTING_FRONTEND, ANGULAR_STANDARDS.
  • TypeScript: Strict, no any, as const, # private — TYPESCRIPT_STANDARDS, referenced from others.