Reference

Documents

Every document in the specification package, rendered from the Markdown in substratal-application-specs/. 00-shared/ is the source of truth for every team; each platform folder adds its handoff, platform spec and screen-by-screen build checklist.

Start here

Package overviewREADME.md
What changed (v1.4.0)00-shared/CHANGES.md
Product spec00-shared/PRODUCT-SPEC.md
Open questions00-shared/OPEN-QUESTIONS.md

Design system

Themes00-shared/THEMES.md
Logo standard00-shared/brand/BRAND.md
Components00-shared/COMPONENTS.md
Copy & states00-shared/COPY-AND-STATES.md
Accessibility00-shared/ACCESSIBILITY.md

Product & behavior

Screen specs00-shared/SCREEN-SPECS.md
Information architecture00-shared/INFORMATION-ARCHITECTURE.md
UX flows00-shared/UX-FLOWS.md
Client architecture00-shared/CLIENT-ARCHITECTURE.md
Non-functional00-shared/NON-FUNCTIONAL.md

Data

API → screen map00-shared/API-SCREEN-MAP.csv
Theme tokens (CSV)00-shared/themes/themes.csv
Theme tokens (JSON)00-shared/themes/themes.json
Brand tokens (JSON)00-shared/brand/brand-tokens.json
Status semantics (JSON)00-shared/status-semantics.json

Web (PWA)

Team handoffweb/README.md
Platform specweb/PLATFORM-SPEC.md
Screensweb/SCREENS.md

iOS / iPadOS

Team handoffios/README.md
Platform specios/PLATFORM-SPEC.md
Screensios/SCREENS.md
brand-assets/LaunchScreenios/brand-assets/LaunchScreen.md
brand-assets/icon-composer-layersios/brand-assets/icon-composer-layers/README.md

Android

Team handoffandroid/README.md
Platform specandroid/PLATFORM-SPEC.md
Screensandroid/SCREENS.md

Windows

Team handoffwindows/README.md
Platform specwindows/PLATFORM-SPEC.md
Screenswindows/SCREENS.md

Linux (GNOME)

Team handofflinux/README.md
Platform speclinux/PLATFORM-SPEC.md
Screenslinux/SCREENS.md
themelinux/theme/README.md

macOS

Team handoffmacos/README.md
Platform specmacos/PLATFORM-SPEC.md
Screensmacos/SCREENS.md
brand-assets/icon-composer-layersmacos/brand-assets/icon-composer-layers/README.md