# Frontend Framework References

This bundle pins frontend framework guidance for deterministic AI/UI work.
Use it before browsing unless a chunk explicitly requires latest docs.

## References

- Angular: `docs/angular-llms.txt`, source `https://angular.dev/llms.txt`
- PrimeNG: `docs/primeng-reference.md`, source `https://primeng.org/`
- RxJS: `docs/rxjs-reference.md`, source `https://rxjs.dev/guide/overview`
- Apollo Angular: `docs/apollo-angular-reference.md`, source `https://the-guild.dev/graphql/apollo-angular/docs`
- Apollo Client: `docs/apollo-client-reference.md`, source `https://www.apollographql.com/docs/react/`

## Usage

- Angular component, signal, template, routing, and testing work must consult
  the Angular reference and `ai/standards/angular.md`.
- PrimeNG is not currently installed in `apps/frontend`; use its docs as a
  visual/component-behavior benchmark unless a future chunk explicitly adds the
  dependency. Internal shared UI components remain the current implementation
  path.
- PrimeNG-like local component work must consult the PrimeNG reference before
  adding local patterns, then adapt behavior and visuals to this app's themes.
- Use `@lucide/angular` for modern iconography where an icon is needed; do not
  hand-roll icons when Lucide provides an appropriate one.
- GraphQL UI data access must use generated Apollo Angular services and the
  operation documents under `apps/frontend/src/app/core/graphql/operations`.
- UI proof selectors must be stable test/accessibility hooks and must not own
  application behavior.