AngularAtlased. 22.2

Ch. 07Application architecture40 / 75

State management with signals

Simple signal stores, facades, local vs global state, and when you need NgRx.

architecture ~0 min read Official docs

With signals, most applications no longer need a state-management library. A service with a few private signals, computed() selectors and methods with clear names covers almost every case. The important question isn’t “which library”, but where each piece of state lives. When a screen keeps reaching combinations that shouldn’t exist, the answer is a state machine.

The levels of state

Kind of state       Example                          Where you keep it
────────────────────────────────────────────────────────────────────────────────
Local UI            open dropdown, hover, tab        signal() in the component
Form                fields, validation, dirty        Signal Forms (form())
Feature             filters, selection, list         @Injectable() store on the route/page
Server              products, orders                 resource / httpResource (in the store)
URL                 search, page, shareable filter   query params + input() (router)
Global              current user, cart, theme, lang  @Service() in root
The rule

Keep the state at the lowest level where it is needed. Lift it (component → feature → global) only when a new consumer requires it.

The basic pattern: a store on signals

@Injectable() // provided by the feature’s page / route
export class TodoStore {
  // 1. STATE — private, writable
  private readonly _todos = signal<Todo[]>([]);
  private readonly _filter = signal<TodoFilter>('all');

  // 2. SELECTORS — public, read-only
  readonly todos = this._todos.asReadonly();
  readonly filter = this._filter.asReadonly();
  readonly visible = computed(() => {
    const f = this._filter();
    return this._todos().filter((t) => f === 'all' || (f === 'done' ? t.done : !t.done));
  });
  readonly remaining = computed(() => this._todos().filter((t) => !t.done).length);

  // 3. ACTIONS — methods with domain names, immutable updates
  add(title: string) {
    this._todos.update((list) => [...list, { id: Date.now(), title, done: false }]);
  }
  toggle(id: number) {
    this._todos.update((list) => list.map((t) => (t.id === id ? { ...t, done: !t.done } : t)));
  }
  setFilter(filter: TodoFilter) {
    this._filter.set(filter);
  }
}
LiveFeature store + persistence + URL sync
2 remaining

The filter is also in the URL (?filtru=…) — reload the page: both the list (localStorage) and the filter (URL) remain.

The filter goes into the URL (?filtru=…), the list into localStorage. The component knows nothing about how the store is implemented.

Server state

Data from the server is not “your state” — it is a cache of the server’s state. Keep it in httpResource/resource inside the store, and after writes reload or update locally.

// A store with server data: resource for reading, HttpClient for writing
@Service()
export class ProductsStore {
  private readonly api = inject(ProductsApi);

  readonly query = signal('');
  readonly page = linkedSignal({ source: this.query, computation: () => 1 });

  readonly products = httpResource<PageDto<Product>>(
    () => ({ url: '/api/products', params: { q: this.query(), page: this.page() } }),
    { defaultValue: { items: [], total: 0 } },
  );

  readonly isEmpty = computed(() => !this.products.isLoading() && this.products.value().items.length === 0);

  async remove(id: number) {
    await firstValueFrom(this.api.delete(id));
    this.products.reload();
  }
}

The URL is state too

// State that must survive a refresh / be sendable as a link → the URL
// with withComponentInputBinding(), query params go straight into inputs:
@Component({ /* routed at /products?q=laptop&page=2 */ })
export class ProductsPage {
  readonly q = input<string>('');               // ?q=
  readonly page = input(1, { transform: numberAttribute }); // ?page=

  private readonly router = inject(Router);

  search(q: string) {
    this.router.navigate([], { queryParams: { q, page: null }, queryParamsHandling: 'merge' });
  }
}

Facade

When a page combines data from several stores, a facade gathers them into a single “view model”. The component stays thin, and the orchestration has a clear place.

// Facade: a single entry point for the page, hiding several sources
@Injectable()
export class CheckoutFacade {
  private readonly cart = inject(CartStore);
  private readonly user = inject(AuthStore);
  private readonly shipping = inject(ShippingStore);

  readonly vm = computed(() => ({
    items: this.cart.items(),
    total: this.cart.total(),
    address: this.user.current()?.address,
    shippingOptions: this.shipping.options.value(),
    canPay: this.cart.items().length > 0 && !!this.user.current(),
  }));

  pay() { /* orchestration between stores */ }
}
// the component: @let vm = facade.vm();  — one object, easy to test

And NgRx?

// When the team wants conventions + plugins: NgRx SignalStore (@ngrx/signals)
export const TodoStore = signalStore(
  withState({ todos: [] as Todo[], filter: 'all' as TodoFilter }),
  withComputed(({ todos, filter }) => ({
    visible: computed(() => todos().filter(/* ... */)),
  })),
  withMethods((store) => ({
    add(title: string) {
      patchState(store, (s) => ({ todos: [...s.todos, { id: Date.now(), title, done: false }] }));
    },
  })),
);
// + withEntities, withHooks, devtools, rxMethod for asynchronous effects
Services on signals (default)
  • Most applications, including large ones.
  • Teams that prefer simple code without boilerplate.
  • Feature state, tied to pages.
NgRx SignalStore / Store
  • SignalStore: you want imposed conventions, entities, hooks, reusable plugins.
  • NgRx Store (Redux): you need an action log, time-travel, event sourcing, many teams on the same state.
  • The application already uses NgRx — keep consistency.

Common pitfalls

  • Everything global: page state in root → old filters appear when you come back, memory grows. Provide the store on the route/page.
  • Public writable signals in a store → anyone can change the state from anywhere. Expose asReadonly().
  • Duplicated state (the same list in two stores) → desynchronisation. One source, the rest derived.
  • Stores that inject each other circularly → a sign that a concept must be moved (or that you need a facade).

Ch. 07 · 0 of 7 complete

Finished this lesson?

Mark it and it shows up on your map: in the contents and on the home page.

Marks itself as done once you have read the whole lesson.

  1. Folder structure
  2. Shared vs feature
  3. Interfaces & models
  4. State management with signals
  5. Style guide & naming
  6. Barrels, aliases & boundaries
  7. Errors: @boundary & ErrorHandler
See your whole map

All 75 pages · type to filter

  • 01What's new in Angular 21 & 22All the important changes in v21 and v22, briefly, with a link to the page that explains each one.Start
  • 01Your first app, step by stepA reading list built from an empty component to a finished app — signals, @for, inputs and outputs, a service and a form, one step at a time.Start
  • 01Quick decisions“Where do I put this?”, “Signal or Observable?”, “Shared or feature?” — short answers to everyday questions.Start
  • 01Angular interview questions60 real interview questions for junior, mid and senior, with the answer to give, the follow-up and the red flags. Plus a mock interview.Start
  • 02Standalone & bootstrapHow an app starts without NgModule: bootstrapApplication, app.config.ts, imports in the component.Modern fundamentals
  • 02Data binding & eventsInterpolation, property and attribute bindings, events with $event and key filters, and how [( )] is built — what goes into the DOM and what comes back.Modern fundamentals
  • 02Control flow: @if, @for, @switchThe block syntax that replaces *ngIf/*ngFor/ngSwitch, with track, @empty and exhaustive checks.Modern fundamentals
  • 02@let and the new template expressionsLocal variables with @let, arrow functions, spread, regex, instanceof, comments inside tags.Modern fundamentals
  • 02@defer — lazy loading in templatesLoad heavy components only when needed: triggers, prefetch, placeholder, loading, error.Modern fundamentals
  • 02Class & style bindingsWhy [class.x] and [style.x] replaced ngClass and ngStyle (with automatic migration from v21).Modern fundamentals
  • 02Component styles & encapsulation:host, the three encapsulation modes, theming with CSS variables, and why ::ng-deep is a last resort.Modern fundamentals
  • 02Pipes: when and howPure vs impure pipes, custom pipes, and how you choose between a pipe, computed() and a method.Modern fundamentals
  • 03signal() and computed()The reactive primitives: writable state, derived state, equality, untracked and immutability rules.Signals & reactivity
  • 03effect() — when YES, when NOSide effects synchronised with signals: localStorage, logging, imperative APIs. And their traps.Signals & reactivity
  • 03linkedSignal() — editable derived stateA signal that resets when its source changes, but that you can also set manually.Signals & reactivity
  • 03resource, rxResource, httpResourceAsync data as signals: status, value, error, reload, automatic cancellation. Stable since v22.Signals & reactivity
  • 03debounced() — delayed signalsThe “debounce” version of a signal, without RxJS. Perfect for search.Signals & reactivity
  • 03Lists: search, filter, sort, paginateA chain of computed signals that recalculates only what changed, with the filters kept in the URL so a link reopens the same view.Signals & reactivity
  • 03Observables from zeroWhat an Observable is, subscribe and unsubscribe, the operators you use every week, cold vs hot — and when a signal is enough.Signals & reactivity
  • 03Signals ↔ RxJStoSignal, toObservable, takeUntilDestroyed, outputFromObservable — and when RxJS remains the right choice.Signals & reactivity
  • 04input() and output()Inputs as signals (required, transform, alias) and typed outputs. Data down, events up.Components: communication
  • 04model() — two-way bindingBanana-in-a-box [( )] with a single API. When to use it, and when input + output is better.Components: communication
  • 04viewChild & contentChildQueries as signals: viewChild, viewChildren, contentChild, contentChildren, the read option.Components: communication
  • 04Lifecycle & DestroyRefWhich hooks still matter in the signals era, afterNextRender, DestroyRef and typed ngOnChanges.Components: communication
  • 04Content projectionng-content with select, multiple slots, default content and the trap of conditional projection.Components: communication
  • 04ng-template & ngTemplateOutletTemplates as values: render props in Angular, typed context and customising components.Components: communication
  • 05Smart vs DumbContainer vs presentational: who holds the state, who only displays, and how to split them properly.Component design
  • 05Generic components <T>A correctly typed DataTable<T> or Select<T>, with templates for cells.Component design
  • 05Dynamic componentsNgComponentOutlet, createComponent with inputBinding/outputBinding, and a dashboard built from config.Component design
  • 05Directives & host compositionAttribute directives, the host: {} metadata and the Directive Composition API (hostDirectives).Component design
  • 05Custom form controlsFormValueControl (Signal Forms) vs ControlValueAccessor: a star rating, in both variants.Component design
  • 05Change detectionOnPush is the default from v22, zone.js is gone from v21. What triggers rendering and how not to get burned.Component design
  • 06inject() & @Service()The new @Service() decorator from v22, inject() vs the constructor, and the injection context.Dependency Injection
  • 06Providers & the injector hierarchyRoot vs route vs component, useClass/useValue/useFactory/useExisting, and the optional/self/skipSelf modifiers.Dependency Injection
  • 06InjectionToken & provideX()Typed configuration, provideFeature() functions, makeEnvironmentProviders and initializers.Dependency Injection
  • 06injectAsync() — lazy servicesLoad a heavy service only when you need it, with prefetch on idle.Dependency Injection
  • 07Folder structurecore / shared / features, what goes into each, and what a feature looks like inside.Application architecture
  • 07Shared vs featureWhen to move a component into shared and (especially) when NOT to. A concrete checklist.Application architecture
  • 07Interfaces & modelsInline interface or separate file? DTO vs domain model, type vs interface, where to put them.Application architecture
  • 07State management with signalsSimple signal stores, facades, local vs global state, and when you need NgRx.Application architecture
  • 07Style guide & namingThe current official conventions: file names without suffixes, protected, readonly, member order.Application architecture
  • 07Barrels, aliases & boundariesindex.ts, path aliases, a feature’s public API and dependency rules that can be checked automatically.Application architecture
  • 07Errors: @boundary & ErrorHandlerThe new @boundary block from v22.2, the global ErrorHandler, HTTP errors and errors from resource.Application architecture
  • 08Modern routing & lazy loadingloadComponent, child routes, parameters as inputs and parameter inheritance (the new default in v22).Routing
  • 08Guards & resolverscanActivate, canMatch, canDeactivate and resolve as functions, with redirects via UrlTree / RedirectCommand.Routing
  • 09Signal Forms — the basicsForms built on signals: form(), [formField], schema-based validation. Stable since v22.Forms
  • 09Signal Forms — advancedCustom and cross-field validation, async/HTTP with debounce, dynamic lists, disabled/hidden, reusable schemas.Forms
  • 09Typed Reactive FormsTyped FormGroup, nonNullable, FormArray — and how they coexist with Signal Forms.Forms
  • 10HttpClient, interceptors & the API layerHttpClient without setup (v21), Fetch by default (v22), functional interceptors and an API layer with DTO mapping.HTTP & data
  • 11Performance — a checklistWhat really matters: OnPush + signals, track, @defer, lazy routes, images, bundles and hydration.Quality & performance
  • 11Testing with VitestVitest is the default runner from v21. TestBed, components with signals, services, HTTP and harnesses.Quality & performance
  • 11DevTools: look inside your appChrome DevTools and Angular DevTools step by step: what each panel shows, with exercises that work on this site.Quality & performance
  • 11Angular AriaHeadless, accessible components that you style however you like: tabs, accordion, menu, listbox...Quality & performance
  • 12SSR, prerender & render modesWhen to render on the server, when at build time and when only in the browser: RenderMode per route, app.routes.server.ts and the real costs.SSR & hydration
  • 12Hydration: event replay & incrementalHow the browser takes over server HTML without re-rendering it: full hydration, event replay, @defer (hydrate on …) and mismatch errors.SSR & hydration
  • 12Server-compatible codewindow doesn’t exist on the server: PLATFORM_ID, afterNextRender, DOCUMENT, TransferState, the HTTP cache and PendingTasks.SSR & hydration
  • 13Micro frontendsWhen it is worth splitting an app into several deployments and when it is just complexity: Native Federation, Module Federation, iframes, Web Components.Architecture at scale
  • 13Web Components with Angular ElementscreateCustomElement: an Angular component used as an HTML tag anywhere, plus communication between apps through events and BroadcastChannel.Architecture at scale
  • 13Monorepo, libraries & boundariesA workspace with several apps and libraries: ng generate library, Nx, secondary entry points, publishing and dependency rules.Architecture at scale
  • 13Hexagonal architecture (ports & adapters)A domain without Angular, ports as abstract classes and interchangeable adapters: HTTP, localStorage or in-memory, without touching the UI.Architecture at scale
  • 14Signals under the hoodThe reactive graph: producers and consumers, push-pull, why computed is lazy and glitch-free, the diamond problem and when effects run.Advanced reactivity
  • 14Advanced RxJS: higher-order operatorsswitchMap, mergeMap, concatMap and exhaustMap on a live diagram, plus retry with backoff, shareReplay and how to avoid leaks.Advanced reactivity
  • 14NgRx SignalStoreLarge-scale state management on signals: withState, withComputed, withMethods, rxMethod, entities and hooks — and when a simple store is enough.Advanced reactivity
  • 14State machines with signalsNo more impossible states: a typed machine on signals, with transitions, guards and a live state diagram.Advanced reactivity
  • 15WebSockets: real time that survives the networkA typed socket as signals: reconnect with backoff and jitter, heartbeat, an outbox while offline, and SSR safety.Real time & offline
  • 15Optimistic updates & rollbackAn instant UI that stays honest: snapshot and rollback, out-of-order responses, idempotency keys.Real time & offline
  • 15Offline-first: Service Worker & cachingThe Angular Service Worker: caching strategies, update prompts and an outbox for changes made offline.Real time & offline
  • 16Web WorkersHeavy computation without blocking the UI: a real worker in the page, message passing and when it is not worth it.Advanced UI & performance
  • 16Huge lists: virtual scroll100,000 rows without lag: CDK virtual scroll, itemSize, trackBy and the alternatives (pagination, infinite scroll).Advanced UI & performance
  • 16Modern animations & View Transitionsanimate.enter and animate.leave instead of the deprecated @angular/animations, CSS transitions and View Transitions on navigation.Advanced UI & performance
  • 16Memory leaks: finding and fixing themSubscriptions, timers and listeners that outlive their component — how to spot them in DevTools and close them.Advanced UI & performance
  • 17Security: XSS, sanitisation & CSPWhat Angular does automatically against XSS, when bypassSecurityTrust becomes dangerous, plus CSP with nonce, Trusted Types and XSRF.Security & globalisation
  • 17Authentication: tokens & refreshAn interceptor that attaches the token, refreshes once on 401 and replays the queued requests — plus where you keep the token.Security & globalisation
  • 17OAuth 2.1 & OpenID Connect with PKCEThe authorization code flow with PKCE, step by step: verifier and challenge, state and nonce, the ID token, and why a BFF is safer.Security & globalisation
  • 17Internationalisation (i18n)$localize, the i18n attribute, ICU plural/select, a build per language vs runtime translations, and locale-based formatting.Security & globalisation