Android app UI

Substratal Hub for Android. Material 3 Expressive.

Stack: Jetpack Compose + material3-adaptive
Notifications: FCM (as app_hub)
Reference screens: 18 × light + dark
Screens specified: 75

Platform spec All 75 screens Mockup index Markdown for AI tools

Documents
Reference screens
Theme code
Team handoff
For AI tools

Documents

Platform documents first, then the shared spec in reading order. Every page also has its Markdown source.

Android

Shared spec (all platforms)

What changed (v1.4.0)What changed in this editionCHANGES.md
Product specScope, personas, domains, phases, acceptance criteriaPRODUCT-SPEC.md
Screen specsEvery screen: route, data, elements, actions, statesSCREEN-SPECS.md
Client architectureSessions, requests, Capabilities, push and inbox, billingCLIENT-ARCHITECTURE.md
UX flowsThe 16 end-to-end flowsUX-FLOWS.md
Information architectureNavigation tree, routes, visibility rules, deep linksINFORMATION-ARCHITECTURE.md
ThemesTheme system: roles, palettes, contrast, persistenceTHEMES.md
Logo standardLogo standard and app iconsBRAND.md
ComponentsComponent behavior contracts and native mappingCOMPONENTS.md
Copy & statesLabels, confirmations, empty states, errorsCOPY-AND-STATES.md
AccessibilityAccessibility requirementsACCESSIBILITY.md
Non-functionalPerformance, security, reliabilityNON-FUNCTIONAL.md
Open questionsUnresolved decisionsOPEN-QUESTIONS.md

Reference screens

Rendered in Moss Paper (light) and Forest Floor (dark). Click a screen to compare modes or open the live mockup in your chosen theme.

Android Security — light theme — ACC-04Security Live mockup Spec

Android Security — dark theme — ACC-04Security Live mockup Spec

Android User — Access — light theme — ACX-01/03Access turn off Live mockup Spec

Android User — Access — dark theme — ACX-01/03Access turn off Live mockup Spec

Android Application — Overview — light theme — APL-03Application Live mockup Spec

Android Application — Overview — dark theme — APL-03Application Live mockup Spec

Android Push credentials — light theme — APL-07Push credentials Live mockup Spec

Android Push credentials — dark theme — APL-07Push credentials Live mockup Spec

Android Home — My Apps — light theme — APP-01Home Live mockup Spec

Android Home — My Apps — dark theme — APP-01Home Live mockup Spec

Android Audit log — light theme — AUD-01/02Audit Live mockup Spec

Android Audit log — dark theme — AUD-01/02Audit Live mockup Spec

Android Sign in — light theme — AUTH-01/02Sign in Live mockup Spec

Android Sign in — dark theme — AUTH-01/02Sign in Live mockup Spec

Android My plan — light theme — BIL-01My plan Live mockup Spec

Android My plan — dark theme — BIL-01My plan Live mockup Spec

Android Manage hub — light theme — GLB-02Manage hub Live mockup Spec

Android Manage hub — dark theme — GLB-02Manage hub Live mockup Spec

Android API keys — light theme — KEY-01/03Api keys secret Live mockup Spec

Android API keys — dark theme — KEY-01/03Api keys secret Live mockup Spec

Android Inbox — light theme — NTF-01/02Inbox Live mockup Spec

Android Inbox — dark theme — NTF-01/02Inbox Live mockup Spec

Android Devices & notifications — light theme — NTF-03Devices Live mockup Spec

Android Devices & notifications — dark theme — NTF-03Devices Live mockup Spec

Android Organization — Apps & seats — light theme — ORG-06Org apps seats Live mockup Spec

Android Organization — Apps & seats — dark theme — ORG-06Org apps seats Live mockup Spec

Android Role detail — light theme — ROL-02Role Live mockup Spec

Android Role detail — dark theme — ROL-02Role Live mockup Spec

Android Settings — Global — light theme — SET-01Appearance themes Live mockup Spec

Android Settings — Global — dark theme — SET-01Appearance themes Live mockup Spec

Android Settings — Per app — light theme — SET-02App settings Live mockup Spec

Android Settings — Per app — dark theme — SET-02App settings Live mockup Spec

Android Users — light theme — USR-01Users Live mockup Spec

Android Users — dark theme — USR-01Users Live mockup Spec

Android Webhook — Deliveries — light theme — WHK-03Deliveries Live mockup Spec

Android Webhook — Deliveries — dark theme — WHK-03Deliveries Live mockup Spec

Theme code & brand assets

This platform's native implementation of the 10 themes; rules are in THEMES. App icons and logo files are in android/brand-assets/.

Team handoff

Standard: Material 3 Expressive · Stack: Jetpack Compose + material3-adaptive API: Substratal Apps Platform API v1.4.0 (openapi 1.0.0-draft.3) — https://compositecode.github.io/substratalapps.com/

Reading order

shared/CHANGES.md — what's new in this edition (push notifications, Free/Standard billing)
shared/PRODUCT-SPEC.md — scope, personas, domains, phases, acceptance criteria
PLATFORM-SPEC.md — how this app is built on Android
SCREENS.md — all 75 screens with native containers and controls (the build checklist)
shared/CLIENT-ARCHITECTURE.md — sessions, request conventions, Capabilities, push and inbox (§6), billing hand-off (§9)
shared/UX-FLOWS.md (+ shared/flows/*.svg) — the 16 end-to-end flows
mockups/index.html / screens/ — reference renders in the default light (Moss Paper) and dark (Forest Floor) themes; ?mode=dark&light=<id>&dark=<id> previews any theme
While building: shared/COMPONENTS.md, shared/COPY-AND-STATES.md, shared/ACCESSIBILITY.md, shared/NON-FUNCTIONAL.md, shared/OPEN-QUESTIONS.md, shared/API-SCREEN-MAP.csv

Themes: theme/ has this platform's implementation of the 5 light and 5 dark themes. Rules are in shared/THEMES.md; wiring is in PLATFORM-SPEC.md (Theming section).

Logo & app icon: brand-assets/ has every icon and logo file this app needs. Wiring is in PLATFORM-SPEC.md (Brand & app icon section) and rules in shared/brand/BRAND.md.

Definition of done (per screen)

Elements, data bindings and API calls match SCREENS.md
Reachable by its route / deep link; restores state from the route
Gated by Capabilities per shared/INFORMATION-ARCHITECTURE.md §2
Loading, empty, error (401/403/404/409/422/429/503) and offline states
Idempotency-Key on creates, If-Match on edits, conflict handling
Every gesture/shortcut has a visible equivalent; screen reader and largest text size pass
Copy matches shared/COPY-AND-STATES.md
Correct in both default themes and in every other theme (colours only from theme roles, no literals); high-contrast modes fall back to system colours
Logo and icons come only from brand-assets/ (no redraws), with accessible name "Substratal Apps"
Flag-gated features (notifications, push, billing) hide cleanly on 501

For AI tools (Claude, Codex, Cursor…)

Plain-text entry points with absolute links, so an agent can read this platform's spec without parsing the site.

platforms/android.md — this page as one Markdown file: facts, document links, every reference screen with image and mockup URLs, theme files, then the full handoff, platform spec and screen specs.
llms.txt — index of the whole site · llms-full.txt — the full shared spec in one file.
Raw sources: substratal-application-specs/android/ on GitHub.