Skip to main content

@signapps/ui

The Tamagui component library and design system: entity cards, dashboard renderers, the theme/token system, and Home Assistant entity bindings.

What's inside

Cards

LightCard, WeatherCard, TemperatureHumidityCard / TempHumidityCard, SensorCard, CurtainCard, MotionCard, MarkdownCard. Each card wraps a Home Assistant entity type and exports a *_CARD_VARIANTS map describing its layout variants (min/max width & height, default spans) used by the editor.

Dashboard renderers

DashboardCardRenderer (maps card type → component), DashboardView, DashboardShell, CustomerDashboardView, DashboardEditor, DashboardTabBar, FitViewportGrid.

Theme system

src/config/tamagui.config.ts builds the central Tamagui config: base config (animations disabled), Inter font, and extended tokens (brand colors, card padding/gap, radius). Themes come from a theme registry (buildSignappsTamaguiThemes). The config is module-augmented into Tamagui's types for autocomplete.

HA bindings & providers

createHomeAssistantEntityContext, useEntityState, useEntityStateOrLoading, useHassHydrated; providers SignappsTamaguiProvider, EdgeAgentProvider, HassSyncProvider.

Exports

package.json exports:

SubpathContents
.Cards, renderers, HA bindings, theme names, automations helpers
./providerThe Tamagui provider entry
./tamagui.configThe theme config
./theme-storagePersistent theme storage

Consumed by

Web admin and Dashboard.