@jmruthers/pace-core 0.4.1 → 0.5.1

package/docs/api/modules.md

@@ -1,6 +1,6 @@
-[@jmruthers/pace-core - v0.4.01](README.md) / Exports
+[@jmruthers/pace-core - v0.5.1](README.md) / Exports
 
-# @jmruthers/pace-core - v0.4.01
+# @jmruthers/pace-core - v0.5.1
 
 **`File`**
 
@@ -32,6 +32,7 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 ### Classes
 
 - [ErrorBoundary](classes/ErrorBoundary.md)
+- [PublicErrorBoundary](classes/PublicErrorBoundary.md)
 
 ### Interfaces
 
@@ -43,7 +44,9 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [DataTableToolbarButton](interfaces/DataTableToolbarButton.md)
 - [AggregateConfig](interfaces/AggregateConfig.md)
 - [EmptyStateConfig](interfaces/EmptyStateConfig.md)
+- [FileUploadProps](interfaces/FileUploadProps.md)
 - [FooterProps](interfaces/FooterProps.md)
+- [InactivityWarningModalProps](interfaces/InactivityWarningModalProps.md)
 - [InputProps](interfaces/InputProps.md)
 - [LabelProps](interfaces/LabelProps.md)
 - [LoginFormProps](interfaces/LoginFormProps.md)
@@ -51,9 +54,23 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [NavigationMenuProps](interfaces/NavigationMenuProps.md)
 - [PaceAppLayoutProps](interfaces/PaceAppLayoutProps.md)
 - [PaceLoginPageProps](interfaces/PaceLoginPageProps.md)
+- [EventLogoProps](interfaces/EventLogoProps.md)
+- [PublicErrorBoundaryProps](interfaces/PublicErrorBoundaryProps.md)
+- [PublicErrorBoundaryState](interfaces/PublicErrorBoundaryState.md)
+- [PublicLoadingSpinnerProps](interfaces/PublicLoadingSpinnerProps.md)
+- [PublicPageFooterProps](interfaces/PublicPageFooterProps.md)
+- [PublicPageHeaderProps](interfaces/PublicPageHeaderProps.md)
+- [PublicPageLayoutProps](interfaces/PublicPageLayoutProps.md)
 - [ToastProps](interfaces/ToastProps.md)
 - [ToastActionElement](interfaces/ToastActionElement.md)
 - [UserMenuProps](interfaces/UserMenuProps.md)
+- [UsePublicEventReturn](interfaces/UsePublicEventReturn.md)
+- [UsePublicEventOptions](interfaces/UsePublicEventOptions.md)
+- [UsePublicEventLogoReturn](interfaces/UsePublicEventLogoReturn.md)
+- [UsePublicEventLogoOptions](interfaces/UsePublicEventLogoOptions.md)
+- [UsePublicRouteParamsReturn](interfaces/UsePublicRouteParamsReturn.md)
+- [UseInactivityTrackerOptions](interfaces/UseInactivityTrackerOptions.md)
+- [UseInactivityTrackerReturn](interfaces/UseInactivityTrackerReturn.md)
 - [EventContextType](interfaces/EventContextType.md)
 - [EventProviderProps](interfaces/EventProviderProps.md)
 - [UserEventAccess](interfaces/UserEventAccess.md)
@@ -69,6 +86,15 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [OrganisationSecurityError](interfaces/OrganisationSecurityError.md)
 - [OrganisationContextType](interfaces/OrganisationContextType.md)
 - [OrganisationProviderProps](interfaces/OrganisationProviderProps.md)
+- [StorageUploadOptions](interfaces/StorageUploadOptions.md)
+- [StorageFileMetadata](interfaces/StorageFileMetadata.md)
+- [StorageUploadResult](interfaces/StorageUploadResult.md)
+- [StorageUrlOptions](interfaces/StorageUrlOptions.md)
+- [StorageListOptions](interfaces/StorageListOptions.md)
+- [StorageFileInfo](interfaces/StorageFileInfo.md)
+- [StorageListResult](interfaces/StorageListResult.md)
+- [FileSizeLimits](interfaces/FileSizeLimits.md)
+- [StorageConfig](interfaces/StorageConfig.md)
 
 ### Type Aliases
 
@@ -78,6 +104,10 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 ### Variables
 
 - [styleConfig](modules.md#styleconfig)
+- [FILE\_SIZE\_LIMITS](modules.md#file_size_limits)
+- [DEFAULT\_FILE\_SIZE\_LIMIT](modules.md#default_file_size_limit)
+- [APP\_PATH\_MAPPING](modules.md#app_path_mapping)
+- [STORAGE\_CONFIG](modules.md#storage_config)
 
 ### Functions
 
@@ -108,25 +138,12 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [DialogFooter](modules.md#dialogfooter)
 - [DialogTitle](modules.md#dialogtitle)
 - [DialogDescription](modules.md#dialogdescription)
-- [DropdownMenu](modules.md#dropdownmenu)
-- [DropdownMenuTrigger](modules.md#dropdownmenutrigger)
-- [DropdownMenuGroup](modules.md#dropdownmenugroup)
-- [DropdownMenuPortal](modules.md#dropdownmenuportal)
-- [DropdownMenuSub](modules.md#dropdownmenusub)
-- [DropdownMenuRadioGroup](modules.md#dropdownmenuradiogroup)
-- [DropdownMenuSubTrigger](modules.md#dropdownmenusubtrigger)
-- [DropdownMenuSubContent](modules.md#dropdownmenusubcontent)
-- [DropdownMenuContent](modules.md#dropdownmenucontent)
-- [DropdownMenuItem](modules.md#dropdownmenuitem)
-- [DropdownMenuCheckboxItem](modules.md#dropdownmenucheckboxitem)
-- [DropdownMenuRadioItem](modules.md#dropdownmenuradioitem)
-- [DropdownMenuLabel](modules.md#dropdownmenulabel)
-- [DropdownMenuSeparator](modules.md#dropdownmenuseparator)
-- [DropdownMenuShortcut](modules.md#dropdownmenushortcut)
 - [EventSelector](modules.md#eventselector)
+- [FileUpload](modules.md#fileupload)
 - [Footer](modules.md#footer)
 - [Form](modules.md#form)
 - [Header](modules.md#header)
+- [InactivityWarningModal](modules.md#inactivitywarningmodal)
 - [Input](modules.md#input)
 - [Label](modules.md#label)
 - [LoadingSpinner](modules.md#loadingspinner)
@@ -138,6 +155,24 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [PasswordChangeForm](modules.md#passwordchangeform)
 - [PasswordResetForm](modules.md#passwordresetform)
 - [Progress](modules.md#progress)
+- [EventLogo](modules.md#eventlogo)
+- [EventLogoCompact](modules.md#eventlogocompact)
+- [EventLogoLarge](modules.md#eventlogolarge)
+- [useErrorBoundary](modules.md#useerrorboundary)
+- [DefaultPublicErrorFallback](modules.md#defaultpublicerrorfallback)
+- [PublicLoadingSpinner](modules.md#publicloadingspinner)
+- [PublicLoadingSpinnerFullPage](modules.md#publicloadingspinnerfullpage)
+- [PublicLoadingSkeleton](modules.md#publicloadingskeleton)
+- [PublicPageContextChecker](modules.md#publicpagecontextchecker)
+- [PublicPageDebugger](modules.md#publicpagedebugger)
+- [PublicPageDiagnostic](modules.md#publicpagediagnostic)
+- [PublicPageFooter](modules.md#publicpagefooter)
+- [PublicPageHeader](modules.md#publicpageheader)
+- [PublicPageLayout](modules.md#publicpagelayout)
+- [usePublicPageContext](modules.md#usepublicpagecontext)
+- [PublicPageProvider](modules.md#publicpageprovider)
+- [usePublicPageProviderContext](modules.md#usepublicpageprovidercontext)
+- [useIsPublicPage](modules.md#useispublicpage)
 - [Select](modules.md#select)
 - [SelectTrigger](modules.md#selecttrigger)
 - [SelectValue](modules.md#selectvalue)
@@ -169,9 +204,22 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [TooltipContent](modules.md#tooltipcontent)
 - [Tooltip](modules.md#tooltip)
 - [UserMenu](modules.md#usermenu)
+- [usePublicEvent](modules.md#usepublicevent)
+- [clearPublicEventCache](modules.md#clearpubliceventcache)
+- [getPublicEventCacheStats](modules.md#getpubliceventcachestats)
+- [usePublicEventLogo](modules.md#usepubliceventlogo)
+- [clearPublicLogoCache](modules.md#clearpubliclogocache)
+- [getPublicLogoCacheStats](modules.md#getpubliclogocachestats)
+- [usePublicRouteParams](modules.md#usepublicrouteparams)
+- [usePublicEventCode](modules.md#usepubliceventcode)
+- [generatePublicRoutePath](modules.md#generatepublicroutepath)
+- [extractEventCodeFromPath](modules.md#extracteventcodefrompath)
 - [useAppConfig](modules.md#useappconfig)
+- [useInactivityTracker](modules.md#useinactivitytracker)
 - [useOrganisationPermissions](modules.md#useorganisationpermissions)
 - [useOrganisationSecurity](modules.md#useorganisationsecurity)
+- [useStorage](modules.md#usestorage)
+- [useFileUpload](modules.md#usefileupload)
 - [useEvents](modules.md#useevents)
 - [EventProvider](modules.md#eventprovider)
 - [OrganisationProvider](modules.md#organisationprovider)
@@ -191,6 +239,18 @@ import { Dialog, NavigationMenu } from '@jmruthers/pace-core/components';
 - [getCurrentAppId](modules.md#getcurrentappid)
 - [cn](modules.md#cn)
 - [createSecureDataAccess](modules.md#createsecuredataaccess)
+- [getFileSizeLimit](modules.md#getfilesizelimit)
+- [validateFileSize](modules.md#validatefilesize)
+- [formatFileSize](modules.md#formatfilesize)
+- [generateFilePath](modules.md#generatefilepath)
+- [generateUniqueFileName](modules.md#generateuniquefilename)
+- [extractFileMetadata](modules.md#extractfilemetadata)
+- [uploadFile](modules.md#uploadfile)
+- [getPublicUrl](modules.md#getpublicurl)
+- [getSignedUrl](modules.md#getsignedurl)
+- [deleteFile](modules.md#deletefile)
+- [listFiles](modules.md#listfiles)
+- [archiveFile](modules.md#archivefile)
 
 ## Type Aliases
 
@@ -247,19 +307,62 @@ Row identifier function type
 
 | Name | Type |
 | :------ | :------ |
-| `base` | \{ `path`: ``"./base.css"`` = './base.css'; `description`: ``"Base styles, fonts, resets, and neutral tokens"`` = 'Base styles, fonts, resets, and neutral tokens' } |
-| `base.path` | ``"./base.css"`` |
-| `base.description` | ``"Base styles, fonts, resets, and neutral tokens"`` |
-| `theme` | \{ `path`: ``"./theme.css"`` = './theme.css'; `description`: ``"Theme mappings for native Tailwind utilities"`` = 'Theme mappings for native Tailwind utilities' } |
-| `theme.path` | ``"./theme.css"`` |
-| `theme.description` | ``"Theme mappings for native Tailwind utilities"`` |
-| `dark` | \{ `path`: ``"./dark.css"`` = './dark.css'; `description`: ``"Dark mode shade remap styles"`` = 'Dark mode shade remap styles' } |
-| `dark.path` | ``"./dark.css"`` |
-| `dark.description` | ``"Dark mode shade remap styles"`` |
+| `core` | \{ `path`: ``"./core.css"`` = './core.css'; `description`: ``"Complete CSS foundation including base styles, theme mappings, fonts, resets, and neutral tokens"`` = 'Complete CSS foundation including base styles, theme mappings, fonts, resets, and neutral tokens' } |
+| `core.path` | ``"./core.css"`` |
+| `core.description` | ``"Complete CSS foundation including base styles, theme mappings, fonts, resets, and neutral tokens"`` |
 
 #### Defined in
 
-[packages/core/src/styles/index.ts:34](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L34)
+[packages/core/src/styles/index.ts:32](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L32)
+
+___
+
+### FILE\_SIZE\_LIMITS
+
+• `Const` **FILE\_SIZE\_LIMITS**: [`FileSizeLimits`](interfaces/FileSizeLimits.md)
+
+File size limits by MIME type (in bytes)
+
+#### Defined in
+
+[packages/core/src/utils/storage/config.ts:10](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L10)
+
+___
+
+### DEFAULT\_FILE\_SIZE\_LIMIT
+
+• `Const` **DEFAULT\_FILE\_SIZE\_LIMIT**: `number`
+
+Default file size limit for unknown MIME types
+
+#### Defined in
+
+[packages/core/src/utils/storage/config.ts:38](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L38)
+
+___
+
+### APP\_PATH\_MAPPING
+
+• `Const` **APP\_PATH\_MAPPING**: `Record`\<`string`, `string`\>
+
+App-specific path mappings for file organization
+Maps app names to their primary category in the organization-first structure
+
+#### Defined in
+
+[packages/core/src/utils/storage/config.ts:44](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L44)
+
+___
+
+### STORAGE\_CONFIG
+
+• `Const` **STORAGE\_CONFIG**: [`StorageConfig`](interfaces/StorageConfig.md)
+
+Storage configuration
+
+#### Defined in
+
+[packages/core/src/utils/storage/config.ts:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L54)
 
 ## Functions
 
@@ -511,7 +614,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `HTMLAttributes`\<`HTMLDivElement`\> & `RefAttributes`\<`HTMLDivElement`\> |
+| `props` | `HTMLAttributes`\<`HTMLElement`\> & `RefAttributes`\<`HTMLElement`\> |
 
 #### Returns
 
@@ -551,7 +654,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `HTMLAttributes`\<`HTMLElement`\> & `RefAttributes`\<`HTMLElement`\> |
+| `props` | `HTMLAttributes`\<`HTMLParagraphElement`\> & `RefAttributes`\<`HTMLParagraphElement`\> |
 
 #### Returns
 
@@ -585,17 +688,17 @@ ___
 
 ### DataTable
 
-▸ **DataTable**\<`TData`\>(`«destructured»`): `Element`
+▸ **DataTable**\<`TData`\>(`props`): `Element`
 
-Enhanced DataTable with comprehensive performance optimizations and full backward compatibility
+Enhanced DataTable with comprehensive performance optimizations
 
 This component automatically detects dataset size and applies appropriate performance optimizations:
-- < 1,000 records: Standard rendering with optional client-side features
-- 1,000 - 10,000 records: Client-side with virtual scrolling and chunking
-- 10,000 - 50,000 records: Hybrid mode with intelligent data management
-- > 50,000 records: Server-side processing with virtualization
+- < 1,000 records: Standard rendering with full feature support
+- 1,000+ records: Automatic virtual scrolling with intelligent memory management
+- 10,000+ records: Enhanced chunking and memory optimization
+- 100,000+ records: Advanced server-side processing with virtualization
 
-All existing DataTable APIs remain fully compatible. Performance features are additive.
+Features are configured through the unified `features` prop for maximum flexibility.
 
 #### Type parameters
 
@@ -607,7 +710,7 @@ All existing DataTable APIs remain fully compatible. Performance features are ad
 
 | Name | Type |
 | :------ | :------ |
-| `«destructured»` | [`DataTableProps`](interfaces/DataTableProps.md)\<`TData`\> |
+| `props` | [`DataTableProps`](interfaces/DataTableProps.md)\<`TData`\> |
 
 #### Returns
 
@@ -615,7 +718,7 @@ All existing DataTable APIs remain fully compatible. Performance features are ad
 
 #### Defined in
 
-[packages/core/src/components/DataTable/DataTable.tsx:382](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/DataTable.tsx#L382)
+[packages/core/src/components/DataTable/DataTable.tsx:420](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DataTable/DataTable.tsx#L420)
 
 ___
 
@@ -636,7 +739,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:248](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L248)
+[packages/core/src/components/Dialog/Dialog.tsx:288](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L288)
 
 ___
 
@@ -656,7 +759,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:249](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L249)
+[packages/core/src/components/Dialog/Dialog.tsx:289](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L289)
 
 ___
 
@@ -677,7 +780,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:250](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L250)
+[packages/core/src/components/Dialog/Dialog.tsx:290](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L290)
 
 ___
 
@@ -697,7 +800,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:251](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L251)
+[packages/core/src/components/Dialog/Dialog.tsx:291](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L291)
 
 ___
 
@@ -717,7 +820,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:254](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L254)
+[packages/core/src/components/Dialog/Dialog.tsx:294](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L294)
 
 ___
 
@@ -760,7 +863,7 @@ JSX.Element - The semantic dialog content with overlay and optional close button
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:397](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L397)
+[packages/core/src/components/Dialog/Dialog.tsx:437](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L437)
 
 ___
 
@@ -794,7 +897,7 @@ JSX.Element - The dialog header container using semantic <header> element
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:517](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L517)
+[packages/core/src/components/Dialog/Dialog.tsx:555](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L555)
 
 ___
 
@@ -804,6 +907,7 @@ ___
 
 DialogBody component
 Semantic main content area for dialog body content with scrollable functionality
+Supports both React children and safe HTML content rendering
 
 #### Parameters
 
@@ -820,17 +924,24 @@ JSX.Element - The scrollable dialog body container using semantic <main> element
 **`Example`**
 
 ```tsx
+// Using React children
 <DialogBody>
   <section className="space-y-4">
     <h4>Content Title</h4>
     <p>Long content that will scroll...</p>
   </section>
 </DialogBody>
+
+// Using HTML content
+<DialogBody 
+  htmlContent="<h2>Import Instructions</h2><p>Upload a CSV file with the following format:</p><ul><li>Required columns: name, email</li><li>Optional columns: phone, address</li></ul>"
+  allowHtml={true}
+/>
 ```
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:550](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L550)
+[packages/core/src/components/Dialog/Dialog.tsx:596](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L596)
 
 ___
 
@@ -864,7 +975,7 @@ JSX.Element - The dialog footer container using semantic <footer> element
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:593](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L593)
+[packages/core/src/components/Dialog/Dialog.tsx:685](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L685)
 
 ___
 
@@ -884,7 +995,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:609](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L609)
+[packages/core/src/components/Dialog/Dialog.tsx:701](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L701)
 
 ___
 
@@ -904,60 +1015,78 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Dialog/Dialog.tsx:624](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L624)
+[packages/core/src/components/Dialog/Dialog.tsx:737](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Dialog/Dialog.tsx#L737)
 
 ___
 
-### DropdownMenu
+### EventSelector
+
+▸ **EventSelector**(`«destructured»`): ``null`` \| `Element`
+
+EventSelector component for selecting events with built-in access control
 
-▸ **DropdownMenu**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+This component provides secure event selection with:
+- Database integration via rbac_event_app_roles table
+- Auto-selection of next upcoming event by date
+- Cross-device sync via Supabase user session metadata
+- localStorage fallback for offline scenarios
+- Comprehensive error handling and user feedback
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | `DropdownMenuProps` | - |
-| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `EventSelectorProps` |
 
 #### Returns
 
-`ReactNode`
+``null`` \| `Element`
+
+**`Component`**
+
+**`Example`**
+
+```ts
+<UnifiedAuthProvider supabaseClient={supabase} appName="PACE">
+  <EventSelector onEventChange={(event) => console.log(event)} />
+</UnifiedAuthProvider>
+```
 
 #### Defined in
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:114](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L114)
+[packages/core/src/components/EventSelector/EventSelector.tsx:130](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/EventSelector/EventSelector.tsx#L130)
 
 ___
 
-### DropdownMenuTrigger
+### FileUpload
 
-▸ **DropdownMenuTrigger**(`props`): `ReactNode`
+▸ **FileUpload**(`«destructured»`): `Element`
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `DropdownMenuTriggerProps` & `RefAttributes`\<`HTMLButtonElement`\> |
+| `«destructured»` | [`FileUploadProps`](interfaces/FileUploadProps.md) |
 
 #### Returns
 
-`ReactNode`
+`Element`
 
 #### Defined in
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:116](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L116)
+[packages/core/src/components/FileUpload/FileUpload.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/FileUpload/FileUpload.tsx#L27)
 
 ___
 
-### DropdownMenuGroup
+### Footer
 
-▸ **DropdownMenuGroup**(`props`): `ReactNode`
+▸ **Footer**(`props`): `ReactNode`
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `DropdownMenuGroupProps` & `RefAttributes`\<`HTMLDivElement`\> |
+| `props` | [`FooterProps`](interfaces/FooterProps.md) |
 
 #### Returns
 
@@ -965,500 +1094,726 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:118](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L118)
+[packages/core/src/components/Footer/Footer.tsx:196](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Footer/Footer.tsx#L196)
 
 ___
 
-### DropdownMenuPortal
+### Form
+
+▸ **Form**\<`TFieldValues`\>(`props`): `Element`
+
+Form component with validation and React Hook Form integration
+
+#### Type parameters
 
-▸ **DropdownMenuPortal**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `TFieldValues` | extends `FieldValues` = `FieldValues` | The type of form field values |
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `DropdownMenuPortalProps` | - |
-| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
+| `props` | `FormProps`\<`TFieldValues`\> | Form configuration and handlers |
 
 #### Returns
 
-`ReactNode`
+`Element`
+
+JSX.Element - The rendered form with FormProvider context
+
+**`Example`**
+
+```tsx
+<Form
+  schema={userSchema}
+  defaultValues={{ name: "", email: "" }}
+  onSubmit={handleSubmit}
+  mode="onBlur"
+>
+  <FormField name="name" label="Name" />
+  <FormField name="email" label="Email" />
+  <Button type="submit">Submit</Button>
+</Form>
+```
 
 #### Defined in
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:120](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L120)
+[packages/core/src/components/Form/Form.tsx:142](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L142)
 
 ___
 
-### DropdownMenuSub
+### Header
+
+▸ **Header**(`props`): `Element`
+
+Header component for application layouts with comprehensive navigation, user management, 
+and customizable branding support.
+
+A flexible header component that supports various configurations including custom logos,
+navigation menus, user authentication, event selection, and custom actions.
 
-▸ **DropdownMenuSub**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+Features:
+- Customizable logo (URL or custom component)
+- Navigation menu integration with highlighting
+- User menu with authentication and password management
+- Event selector for multi-tenant applications
+- Custom actions support
+- Responsive design with mobile considerations
+- Accessibility compliant with proper ARIA attributes
+- Backdrop blur effects for modern UI
+- Flexible layout with configurable sections
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `DropdownMenuSubProps` | - |
-| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
+| `props` | `HeaderProps` | Header configuration including logo, navigation, user settings, and custom content |
 
 #### Returns
 
-`ReactNode`
+`Element`
 
-#### Defined in
+React element with complete header functionality
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:122](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L122)
+**`Example`**
 
-___
+Basic header with logo and navigation:
+```tsx
+import { Header } from '@jmruthers/pace-core';
+import { useNavigate, useLocation } from 'react-router-dom';
 
-### DropdownMenuRadioGroup
+function AppHeader() {
+  const navigate = useNavigate();
+  const location = useLocation();
 
-▸ **DropdownMenuRadioGroup**(`props`): `ReactNode`
+  const navItems = [
+    { id: 'dashboard', label: 'Dashboard', href: '/dashboard' },
+    { id: 'meals', label: 'Meals', href: '/meals' },
+    { id: 'settings', label: 'Settings', href: '/settings' }
+  ];
 
-#### Parameters
+  return (
+    <Header
+      logoUrl="/company-logo.svg"
+      logoAlt="My Company"
+      navItems={navItems}
+      currentPath={location.pathname}
+      onNavigate={(item) => navigate(item.href)}
+      user={currentUser}
+      onSignOut={handleSignOut}
+    />
+  );
+}
+```
 
-| Name | Type |
-| :------ | :------ |
-| `props` | `DropdownMenuRadioGroupProps` & `RefAttributes`\<`HTMLDivElement`\> |
+**`Example`**
 
-#### Returns
+Header with custom actions:
+```tsx
+import { Header, Button } from '@jmruthers/pace-core';
 
-`ReactNode`
+function HeaderWithActions() {
+  const customActions = (
+    <div className="flex items-center gap-2">
+      <Button variant="outline" size="sm">Export</Button>
+      <Button size="sm">New Item</Button>
+    </div>
+  );
+
+  return (
+    <Header
+      logoUrl="/logo.svg"
+      navItems={navigationItems}
+      actions={customActions}
+      user={currentUser}
+      onSignOut={handleSignOut}
+    />
+  );
+}
+```
+
+**`Example`**
+
+Minimal header configuration:
+```tsx
+function MinimalHeader() {
+  return (
+    <Header
+      logoUrl="/simple-logo.svg"
+      logoAlt="Simple App"
+      showEventSelector={false}
+      user={currentUser}
+      onSignOut={handleSignOut}
+    />
+  );
+}
+```
+
+**`Since`**
+
+0.1.0
 
 #### Defined in
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:124](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L124)
+[packages/core/src/components/Header/Header.tsx:219](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Header/Header.tsx#L219)
 
 ___
 
-### DropdownMenuSubTrigger
+### InactivityWarningModal
 
-▸ **DropdownMenuSubTrigger**(`props`): `ReactNode`
+▸ **InactivityWarningModal**(`«destructured»`): `Element`
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `Omit`\<`DropdownMenuSubTriggerProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & \{ `inset?`: `boolean`  } & `RefAttributes`\<`HTMLDivElement`\> |
+| `«destructured»` | [`InactivityWarningModalProps`](interfaces/InactivityWarningModalProps.md) |
 
 #### Returns
 
-`ReactNode`
+`Element`
 
 #### Defined in
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:126](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L126)
+[packages/core/src/components/InactivityWarningModal/InactivityWarningModal.tsx:71](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/InactivityWarningModal/InactivityWarningModal.tsx#L71)
 
 ___
 
-### DropdownMenuSubContent
+### Input
 
-▸ **DropdownMenuSubContent**(`props`): `ReactNode`
+▸ **Input**(`props`): `ReactNode`
 
-DropdownMenuSubContent component
-The content container for dropdown menu sub-items
+Input component
+A flexible, accessible input component with multiple variants and sizes
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `Omit`\<`DropdownMenuSubContentProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> | Content configuration and styling |
+| `props` | [`InputProps`](interfaces/InputProps.md) & `RefAttributes`\<`HTMLInputElement`\> | Input configuration and styling |
 
 #### Returns
 
 `ReactNode`
 
-JSX.Element - The dropdown menu sub-content container
+JSX.Element - The rendered input element
 
 **`Example`**
 
 ```tsx
-<DropdownMenuSubContent>
-  <DropdownMenuItem>Option 1</DropdownMenuItem>
-  <DropdownMenuItem>Option 2</DropdownMenuItem>
-</DropdownMenuSubContent>
+// Basic input
+<Input placeholder="Enter your name" />
+
+// Input with error state
+<Input 
+  placeholder="Email" 
+  type="email" 
+  error={true}
+/>
+
+// Large input with destructive variant
+<Input 
+  variant="destructive" 
+  size="lg" 
+  placeholder="Error input" 
+/>
 ```
 
 #### Defined in
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:163](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L163)
+[packages/core/src/components/Input/Input.tsx:104](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Input/Input.tsx#L104)
 
 ___
 
-### DropdownMenuContent
+### Label
 
-▸ **DropdownMenuContent**(`props`): `ReactNode`
+▸ **Label**(`props`): `ReactNode`
 
-DropdownMenuContent component
-The main content container for dropdown menu items
+Label component
+An accessible label with helper text and error state support
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `Omit`\<`DropdownMenuContentProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> | Content configuration and styling |
+| `props` | [`LabelProps`](interfaces/LabelProps.md) & `RefAttributes`\<`HTMLLabelElement`\> | Label configuration and styling |
 
 #### Returns
 
 `ReactNode`
 
-JSX.Element - The dropdown menu content container
+JSX.Element - The rendered label with optional helper text and errors
 
 **`Example`**
 
 ```tsx
-<DropdownMenuContent>
-  <DropdownMenuItem>Profile</DropdownMenuItem>
-  <DropdownMenuItem>Settings</DropdownMenuItem>
-</DropdownMenuContent>
+<Label htmlFor="email" required helperText="We'll never share your email">
+  Email Address
+</Label>
 ```
 
 #### Defined in
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:194](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L194)
+[packages/core/src/components/Label/Label.tsx:120](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Label/Label.tsx#L120)
 
 ___
 
-### DropdownMenuItem
+### LoadingSpinner
 
-▸ **DropdownMenuItem**(`props`): `ReactNode`
+▸ **LoadingSpinner**(`props`, `deprecatedLegacyContext?`): `ReactNode`
 
-DropdownMenuItem component
-Individual menu item within the dropdown
+LoadingSpinner component
+A simple, accessible loading spinner for indicating loading states
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `Omit`\<`DropdownMenuItemProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & \{ `inset?`: `boolean`  } & `RefAttributes`\<`HTMLDivElement`\> | Item configuration and styling |
+| `props` | `LoadingSpinnerProps` | Spinner configuration and styling |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
 
 #### Returns
 
 `ReactNode`
 
-JSX.Element - The dropdown menu item
+JSX.Element - The rendered loading spinner
 
 **`Example`**
 
 ```tsx
-<DropdownMenuItem onClick={() => console.log('clicked')}>
-  Profile
-</DropdownMenuItem>
+<LoadingSpinner size="lg" className="text-main-500" />
 ```
 
 #### Defined in
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:227](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L227)
+[packages/core/src/components/LoadingSpinner/LoadingSpinner.tsx:83](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/LoadingSpinner/LoadingSpinner.tsx#L83)
 
 ___
 
-### DropdownMenuCheckboxItem
+### LoginForm
+
+▸ **LoginForm**(`props`): `ReactNode`
 
-▸ **DropdownMenuCheckboxItem**(`props`): `ReactNode`
+LoginForm component that provides a ready-to-use authentication form for user sign-in.
+It supports validation, loading state, error handling, and can be customized via props.
+Now includes performance optimizations and onSignUp support.
 
 #### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `props` | `Omit`\<`DropdownMenuCheckboxItemProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`LoginFormProps`](interfaces/LoginFormProps.md) | Login form configuration and handlers |
 
 #### Returns
 
 `ReactNode`
 
-#### Defined in
-
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:245](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L245)
-
-___
-
-### DropdownMenuRadioItem
-
-▸ **DropdownMenuRadioItem**(`props`): `ReactNode`
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `props` | `Omit`\<`DropdownMenuRadioItemProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> |
+JSX.Element - The rendered login form
 
-#### Returns
+**`Example`**
 
-`ReactNode`
+```tsx
+<LoginForm
+  onSignIn={handleSignIn}
+  onSuccess={() => navigate('/dashboard')}
+  onError={(error) => toast.error(error.message)}
+  isLoading={isAuthenticating}
+/>
+```
 
 #### Defined in
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:268](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L268)
+[packages/core/src/components/LoginForm/LoginForm.tsx:150](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/LoginForm/LoginForm.tsx#L150)
 
 ___
 
-### DropdownMenuLabel
-
-▸ **DropdownMenuLabel**(`props`): `ReactNode`
-
-#### Parameters
-
-| Name | Type |
-| :------ | :------ |
-| `props` | `Omit`\<`DropdownMenuLabelProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & \{ `inset?`: `boolean`  } & `RefAttributes`\<`HTMLDivElement`\> |
-
-#### Returns
-
-`ReactNode`
-
-#### Defined in
+### NavigationMenu
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:290](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L290)
+▸ **NavigationMenu**(`props`): `ReactNode`
 
-___
+Unified NavigationMenu component that supports both dropdown and hierarchical navigation modes.
 
-### DropdownMenuSeparator
+A flexible navigation menu component with support for icons, current page highlighting,
+keyboard navigation, and nested menu items.
 
-▸ **DropdownMenuSeparator**(`props`): `ReactNode`
+Features:
+- Dropdown mode: Menu button that opens a dropdown list
+- Hierarchical mode: Expandable tree navigation with nested items
+- Icon support for navigation items
+- Current page highlighting
+- Keyboard navigation support (Enter, Space, Escape)
+- Accessible design with proper ARIA attributes
+- Click outside to close (dropdown mode)
+- Recursive rendering for nested items (hierarchical mode)
 
 #### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `props` | `Omit`\<`DropdownMenuSeparatorProps` & `RefAttributes`\<`HTMLDivElement`\>, ``"ref"``\> & `RefAttributes`\<`HTMLDivElement`\> |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`NavigationMenuProps`](interfaces/NavigationMenuProps.md) & `RefAttributes`\<`HTMLDivElement`\> | NavigationMenu component props including items, mode, navigation handlers, and styling options |
 
 #### Returns
 
 `ReactNode`
 
-#### Defined in
-
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:308](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L308)
+React element with navigation menu functionality
 
-___
+**`Example`**
 
-### DropdownMenuShortcut
+Basic dropdown navigation (most common use case):
+```tsx
+import { NavigationMenu } from '@jmruthers/pace-core';
+import { useNavigate, useLocation } from 'react-router-dom';
 
-▸ **DropdownMenuShortcut**(`«destructured»`): `Element`
+function AppNavigation() {
+  const navigate = useNavigate();
+  const location = useLocation();
 
-#### Parameters
+  const navItems = [
+    { id: 'home', label: 'Home', href: '/', icon: 'Home' },
+    { id: 'dashboard', label: 'Dashboard', href: '/dashboard', icon: 'LayoutDashboard' },
+    { id: 'reports', label: 'Reports', href: '/reports', icon: 'FileText' },
+    { id: 'settings', label: 'Settings', href: '/settings', icon: 'Settings' }
+  ];
 
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | `HTMLAttributes`\<`HTMLSpanElement`\> |
+  return (
+    <NavigationMenu 
+      items={navItems}
+      mode="dropdown"
+      currentPath={location.pathname}
+      onNavigate={(item) => navigate(item.href)}
+      buttonText="Main Menu"
+      showIcons={true}
+    />
+  );
+}
+```
 
-#### Returns
+**`Example`**
 
-`Element`
+Hierarchical navigation with nested items:
+```tsx
+import { NavigationMenu } from '@jmruthers/pace-core';
 
-#### Defined in
+function SidebarNavigation() {
+  const hierarchicalItems = [
+    { 
+      id: 'user-management', 
+      label: 'User Management',
+      icon: 'Users',
+      children: [
+        { id: 'users-list', label: 'All Users', href: '/users' },
+        { id: 'users-create', label: 'Create User', href: '/users/create' },
+        { id: 'user-roles', label: 'User Roles', href: '/users/roles' }
+      ]
+    },
+    { 
+      id: 'reports', 
+      label: 'Reports',
+      icon: 'BarChart',
+      children: [
+        { id: 'sales-reports', label: 'Sales Reports', href: '/reports/sales' },
+        { id: 'user-reports', label: 'User Reports', href: '/reports/users' }
+      ]
+    },
+    { id: 'settings', label: 'Settings', href: '/settings', icon: 'Settings' }
+  ];
 
-[packages/core/src/components/DropdownMenu/DropdownMenu.tsx:320](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/DropdownMenu/DropdownMenu.tsx#L320)
+  return (
+    <NavigationMenu 
+      items={hierarchicalItems}
+      mode="hierarchical"
+      currentPath={window.location.pathname}
+      onNavigate={(item) => {
+        if (item.href) {
+          window.location.href = item.href;
+        }
+      }}
+      className="w-64 bg-sec-50 p-4"
+    />
+  );
+}
+```
 
-___
+**`Example`**
 
-### EventSelector
+Integration with React Router and authentication:
+```tsx
+import { NavigationMenu } from '@jmruthers/pace-core';
+import { useNavigate, useLocation } from 'react-router-dom';
+import { useUnifiedAuth } from '@jmruthers/pace-core/providers';
 
-▸ **EventSelector**(`«destructured»`): ``null`` \| `Element`
+function AuthenticatedNavigation() {
+  const navigate = useNavigate();
+  const location = useLocation();
+  const { hasRole, hasPermission } = useUnifiedAuth();
 
-EventSelector component for selecting events with built-in access control
+  // Build navigation items with permission requirements
+  const navItems = [
+    { 
+      id: 'dashboard', 
+      label: 'Dashboard', 
+      href: '/dashboard', 
+      icon: 'LayoutDashboard',
+      permissions: ['dashboard:read']
+    },
+    { 
+      id: 'meals', 
+      label: 'Meals', 
+      href: '/meals', 
+      icon: 'UtensilsCrossed',
+      permissions: ['meals:read']
+    },
+    { 
+      id: 'admin', 
+      label: 'Admin Panel', 
+      href: '/admin', 
+      icon: 'Shield',
+      roles: ['admin', 'super_admin']
+    },
+    { 
+      id: 'profile', 
+      label: 'Profile', 
+      href: '/profile', 
+      icon: 'User'
+    }
+  ];
 
-This component provides secure event selection with:
-- Database integration via rbac_event_app_roles table
-- Auto-selection of next upcoming event by date
-- Cross-device sync via Supabase user session metadata
-- localStorage fallback for offline scenarios
-- Comprehensive error handling and user feedback
+  return (
+    <NavigationMenu 
+      items={navItems}
+      mode="dropdown"
+      currentPath={location.pathname}
+      onNavigate={(item) => navigate(item.href)}
+      buttonText="Navigation"
+      navigationLabel="Main application navigation"
+      filterByPermissions={true}
+      auditLog={true}
+    />
+  );
+}
+```
 
-#### Parameters
+**`Example`**
 
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | `EventSelectorProps` |
+Custom navigation with external links and actions:
+```tsx
+import { NavigationMenu } from '@jmruthers/pace-core';
 
-#### Returns
+function CustomNavigation() {
+  const handleNavigation = (item) => {
+    if (item.id === 'logout') {
+      // Handle logout action
+      handleLogout();
+    } else if (item.href?.startsWith('http')) {
+      // Handle external links
+      window.open(item.href, '_blank');
+    } else if (item.href) {
+      // Handle internal navigation
+      navigate(item.href);
+    }
+  };
 
-``null`` \| `Element`
+  const navItems = [
+    { id: 'home', label: 'Home', href: '/', icon: 'Home' },
+    { id: 'help', label: 'Help Center', href: 'https://help.example.com', icon: 'HelpCircle' },
+    { id: 'logout', label: 'Sign Out', icon: 'LogOut' } // No href for actions
+  ];
 
-**`Component`**
+  return (
+    <NavigationMenu 
+      items={navItems}
+      mode="dropdown"
+      onNavigate={handleNavigation}
+      buttonText="Menu"
+      disabled={false}
+    />
+  );
+}
+```
 
-**`Example`**
+**`Since`**
 
-```ts
-<UnifiedAuthProvider supabaseClient={supabase} appName="PACE">
-  <EventSelector onEventChange={(event) => console.log(event)} />
-</UnifiedAuthProvider>
-```
+0.1.0
 
 #### Defined in
 
-[packages/core/src/components/EventSelector/EventSelector.tsx:129](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/EventSelector/EventSelector.tsx#L129)
+[packages/core/src/components/NavigationMenu/NavigationMenu.tsx:394](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/NavigationMenu/NavigationMenu.tsx#L394)
 
 ___
 
-### Footer
+### OrganisationSelector
 
-▸ **Footer**(`props`): `ReactNode`
+▸ **OrganisationSelector**(`«destructured»`): ``null`` \| `Element`
+
+OrganisationSelector component for secure organisation switching
+
+This component provides secure organisation selection with:
+- User membership validation
+- Role-based access display
+- Security error handling
+- Real-time organisation switching
+- Accessible interface design
+
+Security: Only shows organisations the user has valid access to
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `props` | [`FooterProps`](interfaces/FooterProps.md) |
+| `«destructured»` | `OrganisationSelectorProps` |
 
 #### Returns
 
-`ReactNode`
+``null`` \| `Element`
 
 #### Defined in
 
-[packages/core/src/components/Footer/Footer.tsx:196](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Footer/Footer.tsx#L196)
+[packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx:96](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx#L96)
 
 ___
 
-### Form
+### PaceAppLayout
 
-▸ **Form**\<`TFieldValues`\>(`props`): `Element`
+▸ **PaceAppLayout**(`props`): `Element`
 
-Form component with validation and React Hook Form integration
+A consistent layout component for all PACE suite applications that provides a standard
+structure with header, main content area, and footer.
 
-#### Type parameters
-
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `TFieldValues` | extends `FieldValues` = `FieldValues` | The type of form field values |
-
-#### Parameters
-
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | `FormProps`\<`TFieldValues`\> | Form configuration and handlers |
-
-#### Returns
-
-`Element`
-
-JSX.Element - The rendered form with FormProvider context
-
-**`Example`**
-
-```tsx
-<Form
-  schema={userSchema}
-  defaultValues={{ name: "", email: "" }}
-  onSubmit={handleSubmit}
-  mode="onBlur"
->
-  <FormField name="name" label="Name" />
-  <FormField name="email" label="Email" />
-  <Button type="submit">Submit</Button>
-</Form>
-```
-
-#### Defined in
-
-[packages/core/src/components/Form/Form.tsx:142](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Form/Form.tsx#L142)
-
-___
-
-### Header
-
-▸ **Header**(`props`): `Element`
-
-Header component for application layouts with comprehensive navigation, user management, 
-and customizable branding support.
+NEW: This component now includes layout-level permission enforcement to ensure
+consuming apps can't forget to implement permission checks on individual pages.
 
-A flexible header component that supports various configurations including custom logos,
-navigation menus, user authentication, event selection, and custom actions.
+This component is designed to work with React Router's nested routing pattern using
+Outlet to render child routes. It provides integrated authentication, navigation,
+and user management functionality.
 
 Features:
-- Customizable logo (URL or custom component)
-- Navigation menu integration with highlighting
-- User menu with authentication and password management
-- Event selector for multi-tenant applications
-- Custom actions support
-- Responsive design with mobile considerations
-- Accessibility compliant with proper ARIA attributes
-- Backdrop blur effects for modern UI
-- Flexible layout with configurable sections
+- React Router v6 integration with nested routing
+- Unified authentication integration
+- Consistent header with navigation and user menu
+- Flexible main content area with Outlet
+- Footer with application branding
+- User sign-out and password change functionality
+- Responsive design and accessibility compliant
+- Layout-level permission enforcement
+- Permission-based navigation filtering
+- Automatic page permission validation
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `HeaderProps` | Header configuration including logo, navigation, user settings, and custom content |
+| `props` | [`PaceAppLayoutProps`](interfaces/PaceAppLayoutProps.md) | Layout configuration including app name for branding and permission settings |
 
 #### Returns
 
 `Element`
 
-React element with complete header functionality
+React element with complete application layout structure and permission enforcement
 
 **`Example`**
 
-Basic header with logo and navigation:
+Basic React Router setup with permission enforcement (RECOMMENDED):
 ```tsx
-import { Header } from '@jmruthers/pace-core';
-import { useNavigate, useLocation } from 'react-router-dom';
-
-function AppHeader() {
-  const navigate = useNavigate();
-  const location = useLocation();
-
-  const navItems = [
-    { id: 'dashboard', label: 'Dashboard', href: '/dashboard' },
-    { id: 'meals', label: 'Meals', href: '/meals' },
-    { id: 'settings', label: 'Settings', href: '/settings' }
-  ];
+import { BrowserRouter as Router, Routes, Route } from 'react-router-dom';
+import { UnifiedAuthProvider } from '@jmruthers/pace-core/providers';
+import { PaceAppLayout, PaceLoginPage } from '@jmruthers/pace-core';
 
+function App() {
   return (
-    <Header
-      logoUrl="/company-logo.svg"
-      logoAlt="My Company"
-      navItems={navItems}
-      currentPath={location.pathname}
-      onNavigate={(item) => navigate(item.href)}
-      user={currentUser}
-      onSignOut={handleSignOut}
-    />
+    <UnifiedAuthProvider supabaseClient={supabase} appName="My App">
+      <Router>
+        <Routes>
+          <Route path="/login" element={<PaceLoginPage appName="My App" />} />
+          <Route path="/" element={
+            <PaceAppLayout 
+              appName="My Application"
+              enforcePermissions={true}
+              defaultPermission="read"
+            />
+          }>
+            <Route index element={<HomePage />} />
+            <Route path="dashboard" element={<DashboardPage />} />
+            <Route path="meals" element={<MealsPage />} />
+          </Route>
+        </Routes>
+      </Router>
+    </UnifiedAuthProvider>
   );
 }
 ```
 
 **`Example`**
 
-Header with custom actions:
+Custom navigation items with permission filtering:
 ```tsx
-import { Header, Button } from '@jmruthers/pace-core';
+import { NavigationItem } from '@jmruthers/pace-core';
 
-function HeaderWithActions() {
-  const customActions = (
-    <div className="flex items-center gap-2">
-      <Button variant="outline" size="sm">Export</Button>
-      <Button size="sm">New Item</Button>
-    </div>
-  );
+function App() {
+  const customNavItems: NavigationItem[] = [
+    { id: 'components', label: 'Components', href: '/components', icon: 'Component' },
+    { id: 'styles', label: 'Styles', href: '/styles', icon: 'Palette' },
+    { id: 'meals', label: 'Meals', href: '/meals', icon: 'UtensilsCrossed' }
+  ];
 
   return (
-    <Header
-      logoUrl="/logo.svg"
-      navItems={navigationItems}
-      actions={customActions}
-      user={currentUser}
-      onSignOut={handleSignOut}
-    />
+    <Router>
+      <Routes>
+        <Route path="/" element={
+          <PaceAppLayout 
+            appName="My Custom App" 
+            navItems={customNavItems}
+            enforcePermissions={true}
+            filterNavigationByPermissions={true}
+            routePermissions={{
+              '/components': 'read',
+              '/styles': 'read',
+              '/meals': 'read'
+            }}
+          />
+        }>
+          <Route path="components" element={<ComponentsPage />} />
+          <Route path="styles" element={<StylesPage />} />
+          <Route path="meals" element={<MealsPage />} />
+        </Route>
+      </Routes>
+    </Router>
   );
 }
 ```
 
 **`Example`**
 
-Minimal header configuration:
+Route-specific permissions with custom page IDs:
 ```tsx
-function MinimalHeader() {
+function AdminApp() {
   return (
-    <Header
-      logoUrl="/simple-logo.svg"
-      logoAlt="Simple App"
-      showEventSelector={false}
-      user={currentUser}
-      onSignOut={handleSignOut}
-    />
+    <Router>
+      <Routes>
+        <Route path="/" element={
+          <PaceAppLayout 
+            appName="Admin Panel"
+            enforcePermissions={true}
+            routePermissions={{
+              '/dashboard': 'read',
+              '/user-management': 'read',
+              '/system-settings': 'update'
+            }}
+            pageIdMapping={{
+              '/dashboard': 'dashboard',
+              '/user-management': 'user-management',
+              '/system-settings': 'system-admin'
+            }}
+            permissionFallback={<AccessDeniedPage />}
+          />
+        }>
+          <Route path="dashboard" element={<DashboardPage />} />
+          <Route path="user-management" element={<UserManagementPage />} />
+          <Route path="system-settings" element={<SystemSettingsPage />} />
+        </Route>
+      </Routes>
+    </Router>
   );
 }
 ```
@@ -1469,372 +1824,327 @@ function MinimalHeader() {
 
 #### Defined in
 
-[packages/core/src/components/Header/Header.tsx:219](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Header/Header.tsx#L219)
+[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:320](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L320)
 
 ___
 
-### Input
+### PaceLoginPage
 
-▸ **Input**(`props`): `ReactNode`
+▸ **PaceLoginPage**(`props`, `deprecatedLegacyContext?`): `ReactNode`
 
-Input component
-A flexible, accessible input component with multiple variants and sizes
+A consistent, reusable login page for all PACE suite applications.
+It handles the sign-in logic with role-based automatic redirection for admin users,
+enhanced error handling, and dual loading state management.
+
+Recent enhancements:
+- Role-based redirection: Admin users are automatically redirected
+- Enhanced error handling with navigation error recovery
+- Dual loading states: auth loading + form submission loading
+- Error persistence: Auth errors are displayed below the form
+- Navigation safety: Try-catch blocks prevent navigation errors
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | [`InputProps`](interfaces/InputProps.md) & `RefAttributes`\<`HTMLInputElement`\> | Input configuration and styling |
+| `props` | [`PaceLoginPageProps`](interfaces/PaceLoginPageProps.md) | Login page configuration including app name and redirect path |
+| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
 
 #### Returns
 
 `ReactNode`
 
-JSX.Element - The rendered input element
+JSX.Element - The rendered login page with enhanced functionality
 
 **`Example`**
 
 ```tsx
-// Basic input
-<Input placeholder="Enter your name" />
-
-// Input with error state
-<Input 
-  placeholder="Email" 
-  type="email" 
-  error={true}
-/>
-
-// Large input with destructive variant
-<Input 
-  variant="destructive" 
-  size="lg" 
-  placeholder="Error input" 
+<PaceLoginPage 
+  appName="My Application" 
+  onSuccessRedirectPath="/dashboard" 
 />
 ```
 
 #### Defined in
 
-[packages/core/src/components/Input/Input.tsx:104](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Input/Input.tsx#L104)
+[packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx:160](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx#L160)
 
 ___
 
-### Label
-
-▸ **Label**(`props`): `ReactNode`
+### PasswordChangeForm
 
-Label component
-An accessible label with helper text and error state support
+▸ **PasswordChangeForm**(`«destructured»`): `Element`
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | [`LabelProps`](interfaces/LabelProps.md) & `RefAttributes`\<`HTMLLabelElement`\> | Label configuration and styling |
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `PasswordChangeFormProps` |
 
 #### Returns
 
-`ReactNode`
+`Element`
 
-JSX.Element - The rendered label with optional helper text and errors
+#### Defined in
 
-**`Example`**
+[packages/core/src/components/PasswordReset/PasswordChangeForm.tsx:116](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PasswordReset/PasswordChangeForm.tsx#L116)
 
-```tsx
-<Label htmlFor="email" required helperText="We'll never share your email">
-  Email Address
-</Label>
-```
+___
+
+### PasswordResetForm
+
+▸ **PasswordResetForm**(`«destructured»`): `Element`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `PasswordResetFormProps` |
+
+#### Returns
+
+`Element`
 
 #### Defined in
 
-[packages/core/src/components/Label/Label.tsx:120](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Label/Label.tsx#L120)
+[packages/core/src/components/PasswordReset/PasswordResetForm.tsx:94](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PasswordReset/PasswordResetForm.tsx#L94)
 
 ___
 
-### LoadingSpinner
+### Progress
 
-▸ **LoadingSpinner**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+▸ **Progress**(`props`): `ReactNode`
 
-LoadingSpinner component
-A simple, accessible loading spinner for indicating loading states
+Progress component
+An accessible progress bar with smooth animations
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | `LoadingSpinnerProps` | Spinner configuration and styling |
-| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
+| `props` | `ProgressProps` & `RefAttributes`\<`HTMLDivElement`\> | Progress configuration and styling |
 
 #### Returns
 
 `ReactNode`
 
-JSX.Element - The rendered loading spinner
+JSX.Element - The rendered progress bar
 
 **`Example`**
 
 ```tsx
-<LoadingSpinner size="lg" className="text-app-main-500" />
+<Progress value={75} max={100} />
 ```
 
 #### Defined in
 
-[packages/core/src/components/LoadingSpinner/LoadingSpinner.tsx:83](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/LoadingSpinner/LoadingSpinner.tsx#L83)
+[packages/core/src/components/Progress/Progress.tsx:90](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Progress/Progress.tsx#L90)
 
 ___
 
-### LoginForm
+### EventLogo
 
-▸ **LoginForm**(`props`): `ReactNode`
+▸ **EventLogo**(`props`): ``null`` \| `Element`
 
-LoginForm component that provides a ready-to-use authentication form for user sign-in.
-It supports validation, loading state, error handling, and can be customized via props.
-Now includes performance optimizations and onSignUp support.
+Component for displaying event logos with fallback to initials
+
+This component is context-aware and automatically detects whether it's being used
+in a public or authenticated context. It fetches and displays event logos from storage,
+with automatic fallback to event initials if no logo is available.
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | [`LoginFormProps`](interfaces/LoginFormProps.md) | Login form configuration and handlers |
+| `props` | [`EventLogoProps`](interfaces/EventLogoProps.md) | Logo configuration and styling |
 
 #### Returns
 
-`ReactNode`
+``null`` \| `Element`
 
-JSX.Element - The rendered login form
+React element with event logo or fallback
 
-**`Example`**
+#### Defined in
 
-```tsx
-<LoginForm
-  onSignIn={handleSignIn}
-  onSuccess={() => navigate('/dashboard')}
-  onError={(error) => toast.error(error.message)}
-  isLoading={isAuthenticating}
-/>
-```
+[packages/core/src/components/PublicLayout/EventLogo.tsx:111](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L111)
+
+___
+
+### EventLogoCompact
+
+▸ **EventLogoCompact**(`props`): `Element`
+
+Compact event logo for small spaces
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | [`EventLogoProps`](interfaces/EventLogoProps.md) |
+
+#### Returns
+
+`Element`
 
 #### Defined in
 
-[packages/core/src/components/LoginForm/LoginForm.tsx:150](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/LoginForm/LoginForm.tsx#L150)
+[packages/core/src/components/PublicLayout/EventLogo.tsx:266](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L266)
 
 ___
 
-### NavigationMenu
+### EventLogoLarge
 
-▸ **NavigationMenu**(`props`): `ReactNode`
+▸ **EventLogoLarge**(`props`): `Element`
 
-Unified NavigationMenu component that supports both dropdown and hierarchical navigation modes.
+Large event logo for prominent display
 
-A flexible navigation menu component with support for icons, current page highlighting,
-keyboard navigation, and nested menu items.
+#### Parameters
 
-Features:
-- Dropdown mode: Menu button that opens a dropdown list
-- Hierarchical mode: Expandable tree navigation with nested items
-- Icon support for navigation items
-- Current page highlighting
-- Keyboard navigation support (Enter, Space, Escape)
-- Accessible design with proper ARIA attributes
-- Click outside to close (dropdown mode)
-- Recursive rendering for nested items (hierarchical mode)
+| Name | Type |
+| :------ | :------ |
+| `props` | [`EventLogoProps`](interfaces/EventLogoProps.md) |
+
+#### Returns
+
+`Element`
+
+#### Defined in
+
+[packages/core/src/components/PublicLayout/EventLogo.tsx:279](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/EventLogo.tsx#L279)
+
+___
+
+### useErrorBoundary
+
+▸ **useErrorBoundary**(): `Object`
+
+Hook for accessing error boundary state
+Useful for components that need to know if they're inside an error boundary
+
+#### Returns
+
+`Object`
+
+| Name | Type |
+| :------ | :------ |
+| `captureError` | (`error`: `Error`) => `void` |
+| `resetError` | () => `void` |
+
+#### Defined in
+
+[packages/core/src/components/PublicLayout/PublicErrorBoundary.tsx:216](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicErrorBoundary.tsx#L216)
+
+___
+
+### DefaultPublicErrorFallback
+
+▸ **DefaultPublicErrorFallback**(`«destructured»`): `Element`
+
+Default error fallback component
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | [`NavigationMenuProps`](interfaces/NavigationMenuProps.md) & `RefAttributes`\<`HTMLDivElement`\> | NavigationMenu component props including items, mode, navigation handlers, and styling options |
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | [`PublicErrorBoundaryState`](interfaces/PublicErrorBoundaryState.md) |
 
 #### Returns
 
-`ReactNode`
+`Element`
 
-React element with navigation menu functionality
+#### Defined in
 
-**`Example`**
+[packages/core/src/components/PublicLayout/PublicErrorBoundary.tsx:239](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicErrorBoundary.tsx#L239)
 
-Basic dropdown navigation (most common use case):
-```tsx
-import { NavigationMenu } from '@jmruthers/pace-core';
-import { useNavigate, useLocation } from 'react-router-dom';
+___
 
-function AppNavigation() {
-  const navigate = useNavigate();
-  const location = useLocation();
+### PublicLoadingSpinner
 
-  const navItems = [
-    { id: 'home', label: 'Home', href: '/', icon: 'Home' },
-    { id: 'dashboard', label: 'Dashboard', href: '/dashboard', icon: 'LayoutDashboard' },
-    { id: 'reports', label: 'Reports', href: '/reports', icon: 'FileText' },
-    { id: 'settings', label: 'Settings', href: '/settings', icon: 'Settings' }
-  ];
+▸ **PublicLoadingSpinner**(`props`): `Element`
 
-  return (
-    <NavigationMenu 
-      items={navItems}
-      mode="dropdown"
-      currentPath={location.pathname}
-      onNavigate={(item) => navigate(item.href)}
-      buttonText="Main Menu"
-      showIcons={true}
-    />
-  );
-}
-```
+Loading spinner component for public pages
 
-**`Example`**
+This component displays a consistent loading state with optional
+branding and messaging for public pages.
 
-Hierarchical navigation with nested items:
-```tsx
-import { NavigationMenu } from '@jmruthers/pace-core';
+#### Parameters
 
-function SidebarNavigation() {
-  const hierarchicalItems = [
-    { 
-      id: 'user-management', 
-      label: 'User Management',
-      icon: 'Users',
-      children: [
-        { id: 'users-list', label: 'All Users', href: '/users' },
-        { id: 'users-create', label: 'Create User', href: '/users/create' },
-        { id: 'user-roles', label: 'User Roles', href: '/users/roles' }
-      ]
-    },
-    { 
-      id: 'reports', 
-      label: 'Reports',
-      icon: 'BarChart',
-      children: [
-        { id: 'sales-reports', label: 'Sales Reports', href: '/reports/sales' },
-        { id: 'user-reports', label: 'User Reports', href: '/reports/users' }
-      ]
-    },
-    { id: 'settings', label: 'Settings', href: '/settings', icon: 'Settings' }
-  ];
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`PublicLoadingSpinnerProps`](interfaces/PublicLoadingSpinnerProps.md) | Spinner configuration and styling |
 
-  return (
-    <NavigationMenu 
-      items={hierarchicalItems}
-      mode="hierarchical"
-      currentPath={window.location.pathname}
-      onNavigate={(item) => {
-        if (item.href) {
-          window.location.href = item.href;
-        }
-      }}
-      className="w-64 bg-gray-50 p-4"
-    />
-  );
-}
-```
+#### Returns
 
-**`Example`**
+`Element`
 
-Integration with React Router and authentication:
-```tsx
-import { NavigationMenu } from '@jmruthers/pace-core';
-import { useNavigate, useLocation } from 'react-router-dom';
-import { useUnifiedAuth } from '@jmruthers/pace-core/providers';
+React element with loading spinner
 
-function AuthenticatedNavigation() {
-  const navigate = useNavigate();
-  const location = useLocation();
-  const { hasRole, hasPermission } = useUnifiedAuth();
+#### Defined in
 
-  // Build navigation items based on user permissions
-  const navItems = [
-    { id: 'dashboard', label: 'Dashboard', href: '/dashboard', icon: 'LayoutDashboard' },
-    ...(hasPermission('meals:read') ? [
-      { id: 'meals', label: 'Meals', href: '/meals', icon: 'UtensilsCrossed' }
-    ] : []),
-    ...(hasRole('admin') ? [
-      { id: 'admin', label: 'Admin Panel', href: '/admin', icon: 'Shield' }
-    ] : []),
-    { id: 'profile', label: 'Profile', href: '/profile', icon: 'User' }
-  ];
+[packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx:75](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx#L75)
 
-  return (
-    <NavigationMenu 
-      items={navItems}
-      mode="dropdown"
-      currentPath={location.pathname}
-      onNavigate={(item) => navigate(item.href)}
-      buttonText="Navigation"
-      navigationLabel="Main application navigation"
-    />
-  );
-}
-```
+___
 
-**`Example`**
+### PublicLoadingSpinnerFullPage
 
-Custom navigation with external links and actions:
-```tsx
-import { NavigationMenu } from '@jmruthers/pace-core';
+▸ **PublicLoadingSpinnerFullPage**(`«destructured»`): `Element`
 
-function CustomNavigation() {
-  const handleNavigation = (item) => {
-    if (item.id === 'logout') {
-      // Handle logout action
-      handleLogout();
-    } else if (item.href?.startsWith('http')) {
-      // Handle external links
-      window.open(item.href, '_blank');
-    } else if (item.href) {
-      // Handle internal navigation
-      navigate(item.href);
-    }
-  };
+Full page loading spinner with event branding
 
-  const navItems = [
-    { id: 'home', label: 'Home', href: '/', icon: 'Home' },
-    { id: 'help', label: 'Help Center', href: 'https://help.example.com', icon: 'HelpCircle' },
-    { id: 'logout', label: 'Sign Out', icon: 'LogOut' } // No href for actions
-  ];
+#### Parameters
 
-  return (
-    <NavigationMenu 
-      items={navItems}
-      mode="dropdown"
-      onNavigate={handleNavigation}
-      buttonText="Menu"
-      disabled={false}
-    />
-  );
-}
-```
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `Pick`\<[`PublicLoadingSpinnerProps`](interfaces/PublicLoadingSpinnerProps.md), ``"message"`` \| ``"className"``\> & \{ `eventName?`: `string`  } |
 
-**`Since`**
+#### Returns
 
-0.1.0
+`Element`
 
 #### Defined in
 
-[packages/core/src/components/NavigationMenu/NavigationMenu.tsx:377](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/NavigationMenu/NavigationMenu.tsx#L377)
+[packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx:135](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx#L135)
 
 ___
 
-### OrganisationSelector
+### PublicLoadingSkeleton
 
-▸ **OrganisationSelector**(`«destructured»`): ``null`` \| `Element`
+▸ **PublicLoadingSkeleton**(`«destructured»`): `Element`
 
-OrganisationSelector component for secure organisation switching
+Skeleton loading component for content placeholders
 
-This component provides secure organisation selection with:
-- User membership validation
-- Role-based access display
-- Security error handling
-- Real-time organisation switching
-- Accessible interface design
+#### Parameters
 
-Security: Only shows organisations the user has valid access to
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `«destructured»` | `Object` | `undefined` |
+| › `lines?` | `number` | `3` |
+| › `className?` | `string` | `''` |
+
+#### Returns
+
+`Element`
+
+#### Defined in
+
+[packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx:189](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicLoadingSpinner.tsx#L189)
+
+___
+
+### PublicPageContextChecker
+
+▸ **PublicPageContextChecker**(`«destructured»`): ``null`` \| `Element`
+
+Context checker component that immediately identifies authentication context issues
+
+This component will immediately log to console if authentication context
+is being triggered in a public page.
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `«destructured»` | `OrganisationSelectorProps` |
+| `«destructured»` | `PublicPageContextCheckerProps` |
 
 #### Returns
 
@@ -1842,236 +2152,189 @@ Security: Only shows organisations the user has valid access to
 
 #### Defined in
 
-[packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx:96](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/OrganisationSelector/OrganisationSelector.tsx#L96)
+[packages/core/src/components/PublicLayout/PublicPageContextChecker.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageContextChecker.tsx#L27)
 
 ___
 
-### PaceAppLayout
+### PublicPageDebugger
 
-▸ **PaceAppLayout**(`props`): `Element`
+▸ **PublicPageDebugger**(`«destructured»`): ``null`` \| `Element`
 
-A consistent layout component for all PACE suite applications that provides a standard
-structure with header, main content area, and footer.
+Debugger component that logs context information
 
-NEW: This component now includes layout-level permission enforcement to ensure
-consuming apps can't forget to implement permission checks on individual pages.
-
-This component is designed to work with React Router's nested routing pattern using
-Outlet to render child routes. It provides integrated authentication, navigation,
-and user management functionality.
-
-Features:
-- React Router v6 integration with nested routing
-- Unified authentication integration
-- Consistent header with navigation and user menu
-- Flexible main content area with Outlet
-- Footer with application branding
-- User sign-out and password change functionality
-- Responsive design and accessibility compliant
-- Layout-level permission enforcement
-- Permission-based navigation filtering
-- Automatic page permission validation
+This component helps identify why authentication context
+is being triggered in public pages.
 
 #### Parameters
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | [`PaceAppLayoutProps`](interfaces/PaceAppLayoutProps.md) | Layout configuration including app name for branding and permission settings |
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `PublicPageDebuggerProps` |
 
 #### Returns
 
-`Element`
+``null`` \| `Element`
 
-React element with complete application layout structure and permission enforcement
+#### Defined in
 
-**`Example`**
+[packages/core/src/components/PublicLayout/PublicPageDebugger.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageDebugger.tsx#L27)
 
-Basic React Router setup with permission enforcement:
-```tsx
-import { BrowserRouter as Router, Routes, Route } from 'react-router-dom';
-import { UnifiedAuthProvider } from '@jmruthers/pace-core/providers';
-import { PaceAppLayout, PaceLoginPage } from '@jmruthers/pace-core';
+___
 
-function App() {
-  return (
-    <UnifiedAuthProvider supabaseClient={supabase} appName="My App">
-      <Router>
-        <Routes>
-          <Route path="/login" element={<PaceLoginPage appName="My App" />} />
-          <Route path="/" element={
-            <PaceAppLayout 
-              appName="My Application"
-              enforcePermissions={true}
-              defaultPermission="read"
-            />
-          }>
-            <Route index element={<HomePage />} />
-            <Route path="dashboard" element={<DashboardPage />} />
-            <Route path="meals" element={<MealsPage />} />
-          </Route>
-        </Routes>
-      </Router>
-    </UnifiedAuthProvider>
-  );
-}
-```
+### PublicPageDiagnostic
 
-**`Example`**
+▸ **PublicPageDiagnostic**(`«destructured»`): ``null`` \| `Element`
 
-Custom navigation items with permission filtering:
-```tsx
-import { NavigationItem } from '@jmruthers/pace-core';
+Diagnostic component that identifies authentication context issues
 
-function App() {
-  const customNavItems: NavigationItem[] = [
-    { id: 'components', label: 'Components', href: '/components', icon: 'Component' },
-    { id: 'styles', label: 'Styles', href: '/styles', icon: 'Palette' },
-    { id: 'meals', label: 'Meals', href: '/meals', icon: 'UtensilsCrossed' }
-  ];
+This component will help you identify exactly where the problem is
+in your public page implementation.
 
-  return (
-    <Router>
-      <Routes>
-        <Route path="/" element={
-          <PaceAppLayout 
-            appName="My Custom App" 
-            navItems={customNavItems}
-            enforcePermissions={true}
-            filterNavigationByPermissions={true}
-            routePermissions={{
-              '/components': 'read',
-              '/styles': 'read',
-              '/meals': 'read'
-            }}
-          />
-        }>
-          <Route path="components" element={<ComponentsPage />} />
-          <Route path="styles" element={<StylesPage />} />
-          <Route path="meals" element={<MealsPage />} />
-        </Route>
-      </Routes>
-    </Router>
-  );
-}
-```
+#### Parameters
 
-**`Example`**
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `PublicPageDiagnosticProps` |
 
-Route-specific permissions with custom page IDs:
-```tsx
-function AdminApp() {
-  return (
-    <Router>
-      <Routes>
-        <Route path="/" element={
-          <PaceAppLayout 
-            appName="Admin Panel"
-            enforcePermissions={true}
-            routePermissions={{
-              '/dashboard': 'read',
-              '/user-management': 'read',
-              '/system-settings': 'update'
-            }}
-            pageIdMapping={{
-              '/dashboard': 'dashboard',
-              '/user-management': 'user-management',
-              '/system-settings': 'system-admin'
-            }}
-            permissionFallback={<AccessDeniedPage />}
-          />
-        }>
-          <Route path="dashboard" element={<DashboardPage />} />
-          <Route path="user-management" element={<UserManagementPage />} />
-          <Route path="system-settings" element={<SystemSettingsPage />} />
-        </Route>
-      </Routes>
-    </Router>
-  );
-}
-```
+#### Returns
+
+``null`` \| `Element`
+
+#### Defined in
+
+[packages/core/src/components/PublicLayout/PublicPageDiagnostic.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageDiagnostic.tsx#L27)
+
+___
+
+### PublicPageFooter
+
+▸ **PublicPageFooter**(`props`): `Element`
+
+Footer component for public pages that matches the normal Footer exactly
+
+This component uses the same styling and structure as the main Footer component
+to ensure consistency across the application.
+
+#### Parameters
 
-**`Since`**
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`PublicPageFooterProps`](interfaces/PublicPageFooterProps.md) | Footer configuration and content |
 
-0.1.0
+#### Returns
+
+`Element`
+
+React element with public page footer
 
 #### Defined in
 
-[packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx:331](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceAppLayout/PaceAppLayout.tsx#L331)
+[packages/core/src/components/PublicLayout/PublicPageFooter.tsx:79](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageFooter.tsx#L79)
 
 ___
 
-### PaceLoginPage
+### PublicPageHeader
 
-▸ **PaceLoginPage**(`props`, `deprecatedLegacyContext?`): `ReactNode`
+▸ **PublicPageHeader**(`props`): `Element`
 
-A consistent, reusable login page for all PACE suite applications.
-It handles the sign-in logic with role-based automatic redirection for admin users,
-enhanced error handling, and dual loading state management.
+Header component for public pages with event-specific branding
 
-Recent enhancements:
-- Role-based redirection: Admin users are automatically redirected
-- Enhanced error handling with navigation error recovery
-- Dual loading states: auth loading + form submission loading
-- Error persistence: Auth errors are displayed below the form
-- Navigation safety: Try-catch blocks prevent navigation errors
+This component displays the app logo, event logo, and event information
+in a clean, accessible layout suitable for public pages.
 
 #### Parameters
 
 | Name | Type | Description |
 | :------ | :------ | :------ |
-| `props` | [`PaceLoginPageProps`](interfaces/PaceLoginPageProps.md) | Login page configuration including app name and redirect path |
-| `deprecatedLegacyContext?` | `any` | **`See`** [React Docs](https://legacy.reactjs.org/docs/legacy-context.html#referencing-context-in-lifecycle-methods) |
+| `props` | [`PublicPageHeaderProps`](interfaces/PublicPageHeaderProps.md) | Header configuration and content |
 
 #### Returns
 
-`ReactNode`
-
-JSX.Element - The rendered login page with enhanced functionality
-
-**`Example`**
+`Element`
 
-```tsx
-<PaceLoginPage 
-  appName="My Application" 
-  onSuccessRedirectPath="/dashboard" 
-/>
-```
+React element with public page header
 
 #### Defined in
 
-[packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx:160](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PaceLoginPage/PaceLoginPage.tsx#L160)
+[packages/core/src/components/PublicLayout/PublicPageHeader.tsx:85](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageHeader.tsx#L85)
 
 ___
 
-### PasswordChangeForm
+### PublicPageLayout
 
-▸ **PasswordChangeForm**(`«destructured»`): `Element`
+▸ **PublicPageLayout**(`props`): `Element`
+
+Layout component for public pages that don't require authentication
+
+This component provides a consistent structure for public event pages
+with event-specific branding, error handling, and loading states.
 
 #### Parameters
 
-| Name | Type |
-| :------ | :------ |
-| `«destructured»` | `PasswordChangeFormProps` |
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `props` | [`PublicPageLayoutProps`](interfaces/PublicPageLayoutProps.md) | Layout configuration and content |
 
 #### Returns
 
 `Element`
 
+React element with complete public page layout
+
 #### Defined in
 
-[packages/core/src/components/PasswordReset/PasswordChangeForm.tsx:116](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PasswordReset/PasswordChangeForm.tsx#L116)
+[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:101](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L101)
 
 ___
 
-### PasswordResetForm
+### usePublicPageContext
 
-▸ **PasswordResetForm**(`«destructured»`): `Element`
+▸ **usePublicPageContext**(): `Object`
+
+Hook for accessing public page context
+Provides access to event data and layout state within public pages
+
+ This hook is no longer needed as PublicPageLayout no longer
+automatically fetches event data. Use usePublicRouteParams and usePublicEvent
+directly in your components instead.
+
+#### Returns
+
+`Object`
+
+| Name | Type |
+| :------ | :------ |
+| `eventCode` | ``null`` |
+| `eventId` | ``null`` |
+| `event` | ``null`` |
+| `isLoading` | `boolean` |
+| `error` | ``null`` |
+| `refetch` | () => `Promise`\<`void`\> |
+| `isPublicPage` | `boolean` |
+
+#### Defined in
+
+[packages/core/src/components/PublicLayout/PublicPageLayout.tsx:221](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageLayout.tsx#L221)
+
+___
+
+### PublicPageProvider
+
+▸ **PublicPageProvider**(`«destructured»`): `Element`
+
+Provider for public pages that completely isolates them from authentication context
+
+This provider:
+- Does not initialize any authentication providers
+- Provides environment variables for public data access
+- Includes error boundary for graceful error handling
+- Is completely separate from the main app context
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `«destructured»` | `PasswordResetFormProps` |
+| `«destructured»` | `PublicPageProviderProps` |
 
 #### Returns
 
@@ -2079,38 +2342,43 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/PasswordReset/PasswordResetForm.tsx:94](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PasswordReset/PasswordResetForm.tsx#L94)
+[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:64](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L64)
 
 ___
 
-### Progress
+### usePublicPageProviderContext
 
-▸ **Progress**(`props`): `ReactNode`
+▸ **usePublicPageProviderContext**(): `PublicPageContextType`
 
-Progress component
-An accessible progress bar with smooth animations
+Hook to access public page context
 
-#### Parameters
+#### Returns
 
-| Name | Type | Description |
-| :------ | :------ | :------ |
-| `props` | `ProgressProps` & `RefAttributes`\<`HTMLDivElement`\> | Progress configuration and styling |
+`PublicPageContextType`
 
-#### Returns
+Public page context with environment variables
 
-`ReactNode`
+#### Defined in
 
-JSX.Element - The rendered progress bar
+[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:119](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L119)
 
-**`Example`**
+___
 
-```tsx
-<Progress value={75} max={100} />
-```
+### useIsPublicPage
+
+▸ **useIsPublicPage**(): `boolean`
+
+Hook to check if we're in a public page context
+
+#### Returns
+
+`boolean`
+
+True if we're in a public page context
 
 #### Defined in
 
-[packages/core/src/components/Progress/Progress.tsx:90](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Progress/Progress.tsx#L90)
+[packages/core/src/components/PublicLayout/PublicPageProvider.tsx:134](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/PublicLayout/PublicPageProvider.tsx#L134)
 
 ___
 
@@ -2122,7 +2390,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `SelectProps` & `RefAttributes`\<`HTMLDivElement`\> |
+| `props` | `SelectProps` & `RefAttributes`\<`HTMLFormElement`\> |
 
 #### Returns
 
@@ -2130,7 +2398,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:94](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L94)
+[packages/core/src/components/Select/Select.tsx:96](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L96)
 
 ___
 
@@ -2150,7 +2418,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:160](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L160)
+[packages/core/src/components/Select/Select.tsx:275](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L275)
 
 ___
 
@@ -2162,7 +2430,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `SelectValueProps` & `RefAttributes`\<`HTMLDivElement`\> |
+| `props` | `SelectValueProps` & `RefAttributes`\<`HTMLSpanElement`\> |
 
 #### Returns
 
@@ -2170,7 +2438,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:234](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L234)
+[packages/core/src/components/Select/Select.tsx:398](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L398)
 
 ___
 
@@ -2182,7 +2450,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `SelectContentProps` & `RefAttributes`\<`HTMLDivElement`\> |
+| `props` | `SelectContentProps` & `RefAttributes`\<`HTMLUListElement`\> |
 
 #### Returns
 
@@ -2190,7 +2458,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:270](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L270)
+[packages/core/src/components/Select/Select.tsx:415](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L415)
 
 ___
 
@@ -2202,7 +2470,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `props` | `SelectItemProps` & `RefAttributes`\<`HTMLDivElement`\> |
+| `props` | `SelectItemProps` & `RefAttributes`\<`HTMLLIElement`\> |
 
 #### Returns
 
@@ -2210,7 +2478,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:470](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L470)
+[packages/core/src/components/Select/Select.tsx:542](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L542)
 
 ___
 
@@ -2230,7 +2498,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:538](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L538)
+[packages/core/src/components/Select/Select.tsx:627](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L627)
 
 ___
 
@@ -2250,7 +2518,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:547](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L547)
+[packages/core/src/components/Select/Select.tsx:638](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L638)
 
 ___
 
@@ -2270,7 +2538,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/components/Select/Select.tsx:560](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L560)
+[packages/core/src/components/Select/Select.tsx:649](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/Select/Select.tsx#L649)
 
 ___
 
@@ -2809,7 +3077,7 @@ JSX.Element - The tooltip content container
 **`Example`**
 
 ```tsx
-<TooltipContent side="top" className="bg-app-main-500">
+<TooltipContent side="top" className="bg-main-500">
   Custom tooltip content
 </TooltipContent>
 ```
@@ -2853,23 +3121,258 @@ JSX.Element - The tooltip with trigger and content
 
 ___
 
-### UserMenu
+### UserMenu
+
+▸ **UserMenu**(`props`): `ReactNode`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `props` | [`UserMenuProps`](interfaces/UserMenuProps.md) |
+
+#### Returns
+
+`ReactNode`
+
+#### Defined in
+
+[packages/core/src/components/UserMenu/UserMenu.tsx:136](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L136)
+
+___
+
+### usePublicEvent
+
+▸ **usePublicEvent**(`eventCode`, `options?`): [`UsePublicEventReturn`](interfaces/UsePublicEventReturn.md)
+
+Hook for accessing public event data by event_code
+
+This hook provides access to public event information without requiring
+authentication. It includes caching, error handling, and loading states.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `eventCode` | `string` | The event code to look up |
+| `options` | [`UsePublicEventOptions`](interfaces/UsePublicEventOptions.md) | Configuration options for caching and behavior |
+
+#### Returns
+
+[`UsePublicEventReturn`](interfaces/UsePublicEventReturn.md)
+
+Object containing event data, loading state, error, and refetch function
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicEvent.ts:99](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEvent.ts#L99)
+
+___
+
+### clearPublicEventCache
+
+▸ **clearPublicEventCache**(): `void`
+
+Clear all cached public event data
+Useful for testing or when you need to force refresh all data
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicEvent.ts:244](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEvent.ts#L244)
+
+___
+
+### getPublicEventCacheStats
+
+▸ **getPublicEventCacheStats**(): `Object`
+
+Get cache statistics for debugging
+
+#### Returns
+
+`Object`
+
+| Name | Type |
+| :------ | :------ |
+| `size` | `number` |
+| `keys` | `string`[] |
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicEvent.ts:255](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEvent.ts#L255)
+
+___
+
+### usePublicEventLogo
+
+▸ **usePublicEventLogo**(`eventId`, `eventName`, `organisationId`, `options`): [`UsePublicEventLogoReturn`](interfaces/UsePublicEventLogoReturn.md)
+
+Hook for accessing public event logo URLs
+
+This hook provides access to event logo URLs without requiring
+authentication. It includes fallback handling and image validation.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `eventId` | `undefined` \| `string` | The event ID to fetch logo for |
+| `eventName` | `undefined` \| `string` | The event name for fallback text generation |
+| `organisationId` | `undefined` \| `string` | The organisation ID for storage path |
+| `options` | [`UsePublicEventLogoOptions`](interfaces/UsePublicEventLogoOptions.md) | Configuration options for caching and behavior |
+
+#### Returns
+
+[`UsePublicEventLogoReturn`](interfaces/UsePublicEventLogoReturn.md)
+
+Object containing logo URL, fallback text, loading state, error, and refetch function
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicEventLogo.ts:125](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEventLogo.ts#L125)
+
+___
+
+### clearPublicLogoCache
+
+▸ **clearPublicLogoCache**(): `void`
+
+Clear all cached public logo data
+Useful for testing or when you need to force refresh all data
+
+#### Returns
+
+`void`
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicEventLogo.ts:268](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEventLogo.ts#L268)
+
+___
+
+### getPublicLogoCacheStats
+
+▸ **getPublicLogoCacheStats**(): `Object`
+
+Get cache statistics for debugging
+
+#### Returns
+
+`Object`
+
+| Name | Type |
+| :------ | :------ |
+| `size` | `number` |
+| `keys` | `string`[] |
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicEventLogo.ts:279](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicEventLogo.ts#L279)
+
+___
+
+### usePublicRouteParams
+
+▸ **usePublicRouteParams**(`options?`): [`UsePublicRouteParamsReturn`](interfaces/UsePublicRouteParamsReturn.md)
+
+Hook for extracting and validating public route parameters
+
+This hook extracts event codes from URL parameters and optionally
+fetches the corresponding event data. It provides validation and
+error handling for public routes.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `options` | `UsePublicRouteParamsOptions` | Configuration options for behavior |
+
+#### Returns
+
+[`UsePublicRouteParamsReturn`](interfaces/UsePublicRouteParamsReturn.md)
+
+Object containing route parameters, event data, loading state, error, and refetch function
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicRouteParams.ts:111](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicRouteParams.ts#L111)
+
+___
+
+### usePublicEventCode
+
+▸ **usePublicEventCode**(`eventCodeParam?`): `Object`
+
+Hook for extracting just the event code without fetching event data
+Useful when you only need the event code and will fetch data separately
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `eventCodeParam` | `string` | `'eventCode'` |
+
+#### Returns
+
+`Object`
+
+| Name | Type |
+| :------ | :------ |
+| `eventCode` | `string` \| ``null`` |
+| `error` | `Error` \| ``null`` |
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicRouteParams.ts:206](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicRouteParams.ts#L206)
+
+___
+
+### generatePublicRoutePath
+
+▸ **generatePublicRoutePath**(`eventCode`, `pageName?`): `string`
+
+Utility function to generate public route paths
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `eventCode` | `string` | `undefined` |
+| `pageName` | `string` | `'index'` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/hooks/public/usePublicRouteParams.ts:242](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicRouteParams.ts#L242)
+
+___
+
+### extractEventCodeFromPath
 
-▸ **UserMenu**(`props`): `ReactNode`
+▸ **extractEventCodeFromPath**(`path`): `string` \| ``null``
+
+Utility function to extract event code from a public route path
 
 #### Parameters
 
 | Name | Type |
 | :------ | :------ |
-| `props` | [`UserMenuProps`](interfaces/UserMenuProps.md) |
+| `path` | `string` |
 
 #### Returns
 
-`ReactNode`
+`string` \| ``null``
 
 #### Defined in
 
-[packages/core/src/components/UserMenu/UserMenu.tsx:135](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/components/UserMenu/UserMenu.tsx#L135)
+[packages/core/src/hooks/public/usePublicRouteParams.ts:256](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/public/usePublicRouteParams.ts#L256)
 
 ___
 
@@ -2878,6 +3381,7 @@ ___
 ▸ **useAppConfig**(): `UseAppConfigReturn`
 
 Hook to access app configuration
+Works in both authenticated and public contexts
 
 #### Returns
 
@@ -2887,7 +3391,27 @@ App configuration and loading state
 
 #### Defined in
 
-[packages/core/src/hooks/useAppConfig.ts:44](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useAppConfig.ts#L44)
+[packages/core/src/hooks/useAppConfig.ts:46](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useAppConfig.ts#L46)
+
+___
+
+### useInactivityTracker
+
+▸ **useInactivityTracker**(`«destructured»?`): [`UseInactivityTrackerReturn`](interfaces/UseInactivityTrackerReturn.md)
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | [`UseInactivityTrackerOptions`](interfaces/UseInactivityTrackerOptions.md) |
+
+#### Returns
+
+[`UseInactivityTrackerReturn`](interfaces/UseInactivityTrackerReturn.md)
+
+#### Defined in
+
+[packages/core/src/hooks/useInactivityTracker.ts:127](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useInactivityTracker.ts#L127)
 
 ___
 
@@ -2929,6 +3453,57 @@ ___
 
 ___
 
+### useStorage
+
+▸ **useStorage**(`«destructured»`): `UseStorageReturn`
+
+Hook for storage operations with app and organisation context
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `UseStorageOptions` |
+
+#### Returns
+
+`UseStorageReturn`
+
+#### Defined in
+
+[packages/core/src/hooks/useStorage.ts:57](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useStorage.ts#L57)
+
+___
+
+### useFileUpload
+
+▸ **useFileUpload**(`«destructured»`): `Object`
+
+Hook for file upload with progress tracking
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `«destructured»` | `UseStorageOptions` |
+
+#### Returns
+
+`Object`
+
+| Name | Type |
+| :------ | :------ |
+| `uploadWithProgress` | (`file`: `File`, `options`: `Partial`\<[`StorageUploadOptions`](interfaces/StorageUploadOptions.md)\>) => `Promise`\<[`StorageUploadResult`](interfaces/StorageUploadResult.md)\> |
+| `uploadProgress` | `number` |
+| `isUploading` | `boolean` |
+| `uploadError` | ``null`` \| `string` |
+
+#### Defined in
+
+[packages/core/src/hooks/useStorage.ts:219](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/hooks/useStorage.ts#L219)
+
+___
+
 ### useEvents
 
 ▸ **useEvents**(): [`EventContextType`](interfaces/EventContextType.md)
@@ -2939,7 +3514,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/providers/EventProvider.tsx:27](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/EventProvider.tsx#L27)
+[packages/core/src/providers/EventProvider.tsx:29](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/EventProvider.tsx#L29)
 
 ___
 
@@ -2959,7 +3534,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/providers/EventProvider.tsx:66](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/EventProvider.tsx#L66)
+[packages/core/src/providers/EventProvider.tsx:68](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/EventProvider.tsx#L68)
 
 ___
 
@@ -2991,7 +3566,7 @@ SECURITY: No children are rendered without valid organisation context
 
 #### Defined in
 
-[packages/core/src/providers/OrganisationProvider.tsx:101](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/OrganisationProvider.tsx#L101)
+[packages/core/src/providers/OrganisationProvider.tsx:103](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/OrganisationProvider.tsx#L103)
 
 ___
 
@@ -3013,7 +3588,7 @@ If used outside OrganisationProvider
 
 #### Defined in
 
-[packages/core/src/providers/OrganisationProvider.tsx:539](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/OrganisationProvider.tsx#L539)
+[packages/core/src/providers/OrganisationProvider.tsx:574](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/OrganisationProvider.tsx#L574)
 
 ___
 
@@ -3027,7 +3602,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/providers/UnifiedAuthProvider.tsx:231](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/UnifiedAuthProvider.tsx#L231)
+[packages/core/src/providers/UnifiedAuthProvider.tsx:177](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/UnifiedAuthProvider.tsx#L177)
 
 ___
 
@@ -3047,7 +3622,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/providers/UnifiedAuthProvider.tsx:338](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/UnifiedAuthProvider.tsx#L338)
+[packages/core/src/providers/UnifiedAuthProvider.tsx:294](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/providers/UnifiedAuthProvider.tsx#L294)
 
 ___
 
@@ -3059,7 +3634,7 @@ ___
 
 | Name | Type |
 | :------ | :------ |
-| `style` | ``"base"`` \| ``"dark"`` \| ``"theme"`` |
+| `style` | ``"core"`` |
 
 #### Returns
 
@@ -3067,7 +3642,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/styles/index.ts:50](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L50)
+[packages/core/src/styles/index.ts:40](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L40)
 
 ___
 
@@ -3081,7 +3656,7 @@ ___
 
 #### Defined in
 
-[packages/core/src/styles/index.ts:55](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L55)
+[packages/core/src/styles/index.ts:45](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/styles/index.ts#L45)
 
 ___
 
@@ -3120,7 +3695,7 @@ Removes the dynamic theme block, returning to app-defined CSS values.
 
 #### Defined in
 
-[packages/core/src/theming/runtime.ts:84](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L84)
+[packages/core/src/theming/runtime.ts:86](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L86)
 
 ___
 
@@ -3143,7 +3718,7 @@ Use this in your SSR setup to avoid FOUC
 
 #### Defined in
 
-[packages/core/src/theming/runtime.ts:139](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L139)
+[packages/core/src/theming/runtime.ts:154](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L154)
 
 ___
 
@@ -3159,7 +3734,7 @@ Checks if dynamic theming is currently active
 
 #### Defined in
 
-[packages/core/src/theming/runtime.ts:146](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L146)
+[packages/core/src/theming/runtime.ts:161](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L161)
 
 ___
 
@@ -3176,7 +3751,7 @@ Useful for debugging or persistence
 
 #### Defined in
 
-[packages/core/src/theming/runtime.ts:158](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L158)
+[packages/core/src/theming/runtime.ts:173](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/theming/runtime.ts#L173)
 
 ___
 
@@ -3280,7 +3855,7 @@ Create a secure data access instance
 
 | Name | Type | Default value | Description |
 | :------ | :------ | :------ | :------ |
-| `supabase` | `default`\<`any`, ``"public"``, `any`\> | `undefined` | Supabase client instance |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> | `undefined` | Supabase client instance |
 | `organisationId` | `string` | `undefined` | Current organisation context |
 | `isSuperAdmin` | `boolean` | `false` | Whether user has super admin privileges |
 
@@ -3293,3 +3868,286 @@ Secure data access utilities
 #### Defined in
 
 [packages/core/src/utils/secureDataAccess.ts:66](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/secureDataAccess.ts#L66)
+
+___
+
+### getFileSizeLimit
+
+▸ **getFileSizeLimit**(`mimeType`): `number`
+
+Get the file size limit for a given MIME type
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `mimeType` | `string` |
+
+#### Returns
+
+`number`
+
+#### Defined in
+
+[packages/core/src/utils/storage/config.ts:63](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L63)
+
+___
+
+### validateFileSize
+
+▸ **validateFileSize**(`file`): `Object`
+
+Validate file size against limits
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `file` | `File` |
+
+#### Returns
+
+`Object`
+
+| Name | Type |
+| :------ | :------ |
+| `isValid` | `boolean` |
+| `error?` | `string` |
+
+#### Defined in
+
+[packages/core/src/utils/storage/config.ts:70](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L70)
+
+___
+
+### formatFileSize
+
+▸ **formatFileSize**(`bytes`): `string`
+
+Get human-readable file size
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `bytes` | `number` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/storage/config.ts:88](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/config.ts#L88)
+
+___
+
+### generateFilePath
+
+▸ **generateFilePath**(`options`, `fileName`): `string`
+
+Generate a file path based on app-first structure
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `options` | [`StorageUploadOptions`](interfaces/StorageUploadOptions.md) |
+| `fileName` | `string` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/storage/helpers.ts:20](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L20)
+
+___
+
+### generateUniqueFileName
+
+▸ **generateUniqueFileName**(`originalName`): `string`
+
+Generate a unique filename with timestamp and UUID
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `originalName` | `string` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/storage/helpers.ts:54](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L54)
+
+___
+
+### extractFileMetadata
+
+▸ **extractFileMetadata**(`file`, `options`, `uploadedBy`): `Promise`\<[`StorageFileMetadata`](interfaces/StorageFileMetadata.md)\>
+
+Extract file metadata from a File object
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `file` | `File` |
+| `options` | [`StorageUploadOptions`](interfaces/StorageUploadOptions.md) |
+| `uploadedBy` | `string` |
+
+#### Returns
+
+`Promise`\<[`StorageFileMetadata`](interfaces/StorageFileMetadata.md)\>
+
+#### Defined in
+
+[packages/core/src/utils/storage/helpers.ts:66](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L66)
+
+___
+
+### uploadFile
+
+▸ **uploadFile**(`supabase`, `file`, `options`): `Promise`\<[`StorageUploadResult`](interfaces/StorageUploadResult.md)\>
+
+Upload a file to Supabase storage with app segregation
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
+| `file` | `File` |
+| `options` | [`StorageUploadOptions`](interfaces/StorageUploadOptions.md) |
+
+#### Returns
+
+`Promise`\<[`StorageUploadResult`](interfaces/StorageUploadResult.md)\>
+
+#### Defined in
+
+[packages/core/src/utils/storage/helpers.ts:140](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L140)
+
+___
+
+### getPublicUrl
+
+▸ **getPublicUrl**(`supabase`, `path`): `string`
+
+Get a public URL for a file
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
+| `path` | `string` |
+
+#### Returns
+
+`string`
+
+#### Defined in
+
+[packages/core/src/utils/storage/helpers.ts:205](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L205)
+
+___
+
+### getSignedUrl
+
+▸ **getSignedUrl**(`supabase`, `path`, `options`): `Promise`\<\{ `url`: `string` ; `expiresAt`: `string`  } \| ``null``\>
+
+Get a signed URL for a protected file
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
+| `path` | `string` |
+| `options` | [`StorageUrlOptions`](interfaces/StorageUrlOptions.md) |
+
+#### Returns
+
+`Promise`\<\{ `url`: `string` ; `expiresAt`: `string`  } \| ``null``\>
+
+#### Defined in
+
+[packages/core/src/utils/storage/helpers.ts:216](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L216)
+
+___
+
+### deleteFile
+
+▸ **deleteFile**(`supabase`, `path`): `Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\>
+
+Delete a file from storage
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
+| `path` | `string` |
+
+#### Returns
+
+`Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\>
+
+#### Defined in
+
+[packages/core/src/utils/storage/helpers.ts:244](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L244)
+
+___
+
+### listFiles
+
+▸ **listFiles**(`supabase`, `options`): `Promise`\<[`StorageListResult`](interfaces/StorageListResult.md)\>
+
+List files in an organization scope
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
+| `options` | [`StorageListOptions`](interfaces/StorageListOptions.md) |
+
+#### Returns
+
+`Promise`\<[`StorageListResult`](interfaces/StorageListResult.md)\>
+
+#### Defined in
+
+[packages/core/src/utils/storage/helpers.ts:272](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L272)
+
+___
+
+### archiveFile
+
+▸ **archiveFile**(`supabase`, `path`, `options`): `Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\>
+
+Move a file to archived location (soft delete)
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `supabase` | `default`\<`any`, ``"public"``, ``"public"``, `any`, `any`\> |
+| `path` | `string` |
+| `options` | `Object` |
+| `options.appName` | `string` |
+| `options.orgId` | `string` |
+
+#### Returns
+
+`Promise`\<\{ `success`: `boolean` ; `error?`: `string`  }\>
+
+#### Defined in
+
+[packages/core/src/utils/storage/helpers.ts:325](https://github.com/jmruthers/pace-core/blob/main/packages/core/src/utils/storage/helpers.ts#L325)