Shared component files

Navigation, loading, account and appearance UI plus form primitives. Domain authorization remains outside these components.

System explanation · Choosing checks

Source files

File	Responsibility / entry points
`src/components/account-setup.tsx`	Explains missing/invalid staff account metadata. AccountSetup
`src/components/app-shell.tsx`	Page chrome, busy/loading feedback and desk-layout Home routing. AppShell
`src/components/appearance-control.tsx`	Theme, palette, layout, font, vision and motion controls. AppearanceSettings, AppearanceControl
`src/components/appearance-provider.tsx`	Applies device preferences, observes system mode and coordinates change/sync notifications. subscribeAppearanceChanges, AppearanceProvider, useAppearance
`src/components/auth-frame.tsx`	Shared sign-in/sign-up presentation. AuthFrame
`src/components/auth-loading.tsx`	Authentication loading presentation. AuthLoading
`src/components/brand.tsx`	Iris wordmark and icon components. IrisMark, Brand
`src/components/elapsed-time.tsx`	Displays elapsed time from a timestamp. ElapsedTime
`src/components/header-popover.tsx`	Local header popover behavior, outside-click and Escape handling. HeaderPopover
`src/components/header-search.tsx`	Debounced quick suggestions and navigation to full search. HeaderSearch
`src/components/landing-page.tsx`	Public landing presentation and synthetic application preview. LandingPage
`src/components/loading-preview.tsx`	Inert placeholder wrapper for real-layout loading previews. LoadingPreview
`src/components/navigation-link.tsx`	Disables eager prefetch and routes ordinary clicks through save-before-navigation. NavigationLink
`src/components/notification-bell.tsx`	Notification display, mark-read/clear controls and review navigation. NotificationBell
`src/components/page-skeleton.tsx`	Destination-specific loading content selected from route path. isReviewWorkspace, PageSkeleton
`src/components/queue-pane.tsx`	Desk sidebar queues with scoped cache, paging and periodic refresh. QueuePane
`src/components/site-header.tsx`	Role-filtered navigation and shared toolbar across layouts. SiteNav, SiteToolbar
`src/components/ui/alert.tsx`	Shared alert primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/badge.tsx`	Shared badge primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/button.tsx`	Shared button primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/input.tsx`	Shared input primitive; inspect this wrapper before changing library-level behavior or styling. fieldClass, fieldMultilineClass, FieldCalendarIcon
`src/components/ui/label.tsx`	Shared label primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/popover.tsx`	Shared popover primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/select.tsx`	Shared select primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/sheet.tsx`	Shared sheet primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/switch.tsx`	Shared switch primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/tabs.tsx`	Shared tabs primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/user-control.tsx`	Clerk account menu, review/notification settings, appearance sync and View as. UserControl

Shared component files

Navigation, loading, account and appearance UI plus form primitives. Domain authorization remains outside these components.

System explanation · Choosing checks

Source files

File	Responsibility / entry points
`src/components/account-setup.tsx`	Explains missing/invalid staff account metadata. AccountSetup
`src/components/app-shell.tsx`	Page chrome, busy/loading feedback and desk-layout Home routing. AppShell
`src/components/appearance-control.tsx`	Theme, palette, layout, font, vision and motion controls. AppearanceSettings, AppearanceControl
`src/components/appearance-provider.tsx`	Applies device preferences, observes system mode and coordinates change/sync notifications. subscribeAppearanceChanges, AppearanceProvider, useAppearance
`src/components/auth-frame.tsx`	Shared sign-in/sign-up presentation. AuthFrame
`src/components/auth-loading.tsx`	Authentication loading presentation. AuthLoading
`src/components/brand.tsx`	Iris wordmark and icon components. IrisMark, Brand
`src/components/elapsed-time.tsx`	Displays elapsed time from a timestamp. ElapsedTime
`src/components/header-popover.tsx`	Local header popover behavior, outside-click and Escape handling. HeaderPopover
`src/components/header-search.tsx`	Debounced quick suggestions and navigation to full search. HeaderSearch
`src/components/landing-page.tsx`	Public landing presentation and synthetic application preview. LandingPage
`src/components/loading-preview.tsx`	Inert placeholder wrapper for real-layout loading previews. LoadingPreview
`src/components/navigation-link.tsx`	Disables eager prefetch and routes ordinary clicks through save-before-navigation. NavigationLink
`src/components/notification-bell.tsx`	Notification display, mark-read/clear controls and review navigation. NotificationBell
`src/components/page-skeleton.tsx`	Destination-specific loading content selected from route path. isReviewWorkspace, PageSkeleton
`src/components/queue-pane.tsx`	Desk sidebar queues with scoped cache, paging and periodic refresh. QueuePane
`src/components/site-header.tsx`	Role-filtered navigation and shared toolbar across layouts. SiteNav, SiteToolbar
`src/components/ui/alert.tsx`	Shared alert primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/badge.tsx`	Shared badge primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/button.tsx`	Shared button primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/input.tsx`	Shared input primitive; inspect this wrapper before changing library-level behavior or styling. fieldClass, fieldMultilineClass, FieldCalendarIcon
`src/components/ui/label.tsx`	Shared label primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/popover.tsx`	Shared popover primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/select.tsx`	Shared select primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/sheet.tsx`	Shared sheet primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/switch.tsx`	Shared switch primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/ui/tabs.tsx`	Shared tabs primitive; inspect this wrapper before changing library-level behavior or styling.
`src/components/user-control.tsx`	Clerk account menu, review/notification settings, appearance sync and View as. UserControl