ember-local-storage-decorator — Complete A3 Reference

Used in 32 A3 files. The @localStorage decorator provides a simple, reactive way to persist UI state to the browser's localStorage. It integrates with Glimmer's tracking system so that changes to localStorage-backed properties automatically trigger template re-renders.

Package: ember-local-storage-decorator Import: import { localStorage } from 'ember-local-storage-decorator';

Core Concept

The @localStorage decorator creates a class property that:

1. Reads its initial value from localStorage (if a stored value exists)
2. Falls back to a default value if nothing is stored
3. Writes to localStorage whenever the property is set
4. Is tracked (reactive) — template bindings update when the value changes
5. Handles serialization/deserialization automatically (JSON.stringify/parse)