igloo-ui

Shared React UI package for the Igloo applications.

Status

• Beta.

Owns

• reusable UI primitives
• shared shell/layout components
• reusable FROSTR workflow components
• the compiled package stylesheet at igloo-ui/styles.css

Does Not Own

• signer runtime orchestration
• storage or profile persistence
• Tauri, browser extension, or server APIs
• app-specific bootstrapping and session lifecycle

Consumer Contract

Import the package stylesheet once at app startup:

import 'igloo-ui/styles.css';

For local development and tests, prefer resolving igloo-ui from source so React stays deduped.

Design Tokens

Design tokens are committed package-local artifacts under src/tokens/. They are refreshed by the coordinating workspace handoff process, not by package runtime code, app code, or build-time dependencies.

Do not add package, runtime, test, or published entrypoint dependencies on external design repos or desktop design tooling.

Ownership Note

• igloo-shared owns profile package export and rotation semantics.
• igloo-ui owns reusable presentation only.
• igloo-chrome, igloo-pwa, and igloo-home own storage, runtime transport, lifecycle wiring, and UI state.
• Operator settings actions are intentionally aligned across hosts: copy profile, copy share, rotate share, and logout.

Shared Surface

Primary flow exports:

• HostEntryTile
• HostFlowShell
• StoredProfilesLandingCard
• StepProgress
• CreateFlowTaskBanner
• CreateFlowGenerateCard
• CreateFlowLocalSaveCard
• CreateFlowShareSelection
• CreateFlowProfileSetup
• CreateFlowDistributionCards
• CreateFlowDistributionSection
• DesktopAppShell
• CreateImportPanel
• ManagedProfilesPanel
• OperatorDashboardTabs
• OperatorSignerPanel
• OperatorPermissionsPanel
• OperatorSettingsPanel
• ProfileConfirmationCard
• RecoveryWorkspace

These flows are reusable UI only. Consumers pass data, callbacks, and async actions in through props.

Additional Docs

• CHANGELOG.md
• TESTING.md
• CONTRIBUTING.md