Skip to content

README.md

Latest commit

 

History

History
23 lines (18 loc) · 1.75 KB

README.md

File metadata and controls

23 lines (18 loc) · 1.75 KB

Frontend documentation (docs/frontend)

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

Doc When to load
ANGULAR_STANDARDS.md Components, templates, signals, OnPush, PrimeNG, testing stack
BREADCRUMBS.md GlobalStore breadcrumbs: addNewBreadcrumb, setBreadcrumbs, id/url for tabs, duplicate prevention
COMPONENT_ARCHITECTURE.md Component structure, file layout, data flow, parent-child
STATE_MANAGEMENT.md NgRx Signal Store, rxMethod, patchState — prefer over manual state
STYLING_STANDARDS.md Tailwind CSS, PrimeNG theme, BEM (when needed), SCSS variables
TESTING_FRONTEND.md Spectator, Jest/Vitest, byTestId, setInput, data-testid
TYPESCRIPT_STANDARDS.md Strict 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.