'%20d='M64%205c-3%2018-15%2026-13%2043-9-5-13-13-13-22C20%2043%2015%2062%2022%2082c7%2022%2023%2037%2042%2041%2022-4%2039-21%2043-43%203-17-3-32-18-45%202%2011%200%2018-6%2025C84%2036%2075%2019%2064%205Z'%20/%3e%3cpath%20fill='url(%23heat)'%20d='M64%2045c-2%2015-14%2022-13%2038-5-4-8-9-9-15-7%2010-8%2020-4%2030%205%2012%2014%2020%2026%2023%2013-3%2023-12%2027-25%203-11%200-20-8-29%200%207-2%2012-6%2016%201-16-5-27-13-38Z'%20/%3e%3c!--%20The%20glasses%20render%20as%20two%20stacked%20stroke%20groups:%20a%20pale%20warm%20casing%20under%20a%20dark%20warm-charcoal%20stroke.%20The%20casing%20keeps%20the%20dark%20strokes%20legible%20where%20they%20leave%20the%20flame%20body%20(temple%20tips,%20lower%20rims)%20on%20dark%20backgrounds,%20and%20reads%20as%20a%20rim%20light%20against%20the%20flame%20on%20light%20ones.%20--%3e%3cg%20fill='none'%20stroke='%23ffe3ae'%20stroke-opacity='0.85'%20stroke-linecap='round'%20stroke-linejoin='round'%3e%3cpath%20stroke-width='14'%20d='M7%2063c12-4%2027-5%2043-1M78%2062c16-4%2031-3%2043%201'/%3e%3crect%20x='12'%20y='58'%20width='46'%20height='35'%20rx='13'%20stroke-width='14'/%3e%3crect%20x='70'%20y='58'%20width='46'%20height='35'%20rx='13'%20stroke-width='14'/%3e%3cpath%20stroke-width='13'%20d='M57%2066c5-4%209-4%2014%200'/%3e%3c/g%3e%3cg%20fill='none'%20stroke='%2333221b'%20stroke-linecap='round'%20stroke-linejoin='round'%3e%3cpath%20stroke-width='8'%20d='M7%2063c12-4%2027-5%2043-1M78%2062c16-4%2031-3%2043%201'/%3e%3crect%20x='12'%20y='58'%20width='46'%20height='35'%20rx='13'%20stroke-width='8'/%3e%3crect%20x='70'%20y='58'%20width='46'%20height='35'%20rx='13'%20stroke-width='8'/%3e%3cpath%20stroke-width='7'%20d='M57%2066c5-4%209-4%2014%200'/%3e%3c/g%3e%3c/svg%3e){kind=small}
@happyvertical/smrt-preferences
Saved user-interface preferences: tenant defaults and per-user overrides for overview layouts and the app frame, validated per registered kind.
What it gives you
Saved user-interface preferences: tenant defaults and per-user overrides for overview layouts and the app frame, validated per registered kind.
- 01Two built-in kinds: overview (widget layout of a customizable overview page) and shell-layout (AdminShell settings)
- 02An organization sets the default; each person keeps their own version on top; reset returns to the layer below
- 03Every kind validates its payload on save and again on load; invalid data is refused or dropped and reported
Stores, not the model
createPreferenceStore, createOverviewStore, and createShellSettingsPreferences are the application API. The UiPreferenceRecord model refuses writes that do not come from the store and never returns another person’s preferences. Saves pass the revision they loaded; a stale revision returns conflict instead of overwriting.
Permissions are per kind
overviews.customize and shell.customize change the organization default; overviews.personalize and shell.personalize keep a personal version. Owners and admins receive all four when role permissions are seeded; members and viewers receive the two personalize slugs. The store reads them from the signed-in person’s permission set in the request context.
Register more kinds
registerPreferenceKind takes a kind name, a format version, the two permission slugs, and a validate function. The table _smrt_ui_preferences is created by smrt db:migrate, never at runtime.
Package UI
No UI layer to carry
This package stays focused on models, runtime behavior, or tooling. Build its interface with smrt-ui, or use a related domain package that exposes a /svelte entry point.
Intentionally headless
Package previews
No playground module yet
This package does not currently export a ./playground module. Its component names and import path remain available in the Components tab.
Intentionally not registered
Generated interface
REST
The exact route set comes from each model's @smrt({ api }) policy
and the application manifest—not from a second controller definition.
The preference table has no generated REST, MCP, WebMCP, or CLI surface: a generated route would skip kind validation. Applications call the stores from their own server code.
Generated interface
MCP
AI tools are generated from the methods you explicitly include. Their inputs are validated against the same model metadata used by REST and CLI.
The preference table has no generated REST, MCP, WebMCP, or CLI surface: a generated route would skip kind validation. Applications call the stores from their own server code.
Browser-native agent interface
WebMCP
The generated web definitions carry the same tool names, descriptions, and JSON Schema
inputs as MCP. smrt-web registers them with document.modelContext.
The preference table has no generated REST, MCP, WebMCP, or CLI surface: a generated route would skip kind validation. Applications call the stores from their own server code.
Generated interface
CLI
The app CLI turns manifest resources into predictable operator commands while keeping package-specific actions close to their models.
The preference table has no generated REST, MCP, WebMCP, or CLI surface: a generated route would skip kind validation. Applications call the stores from their own server code.