Experience Organization Branding Throughout the App
Each partner organization has its own visual identity. After organization selection, the org branding cache loads the organization's branding assets (logo, primary color, accent color) and applies them via the design token theme system. This creates a sense of organizational ownership of the app without requiring separate app builds. The branding is cached locally so it loads instantly on subsequent sessions. Branding updates pushed from the backend are fetched on session start and cached for offline use.
User Story
Acceptance Criteria
- Given a peer mentor selects their organization, when the home screen loads, then the app header or splash area displays the organization's logo
- Given organization branding is cached, when the peer mentor opens the app in offline mode, then the cached branding is applied without network requests
- Given the organization administrator updates the branding in the backend, when the peer mentor next starts the app with network access, then the updated branding is fetched and the cache is refreshed
- Given branding assets include a primary color, when the design token system applies the organization theme, then interactive elements (buttons, highlights) use the organization's primary color within WCAG contrast ratio requirements
- Given the peer mentor switches organizations, when the new organization context is set, then the branding cache clears and reloads the new organization's assets before the home screen is rendered
Business Value
Organizational branding is a trust and adoption signal, particularly for the pilot rollout phase where peer mentors are evaluating whether the app is a credible tool endorsed by their organization. Workshop participants represent established organizations with strong brand identities (NHF, Blindeforbundet, HLF) — their members expect consistency with existing organizational touchpoints. Applying WCAG-compliant branding also ensures that the accessibility guarantees hold even as themes change.
Components
- Organization Selection Screen ui
- Tenant Context Service service
- Organization Branding Cache data
- Design Token Theme infrastructure
- Design Token Provider data
- Accessible Theme Builder infrastructure
- Contrast-Safe Color Palette Widget ui
- Contrast Ratio Validator Service service