# Substratal Hub Application Specifications

> Build specifications, UI design, themes and the logo standard for the six Substratal Hub apps — Web (PWA), iOS/iPadOS, Android, Windows, Linux (GNOME) and macOS — against the Substratal Apps Platform API v1.4.0 (118 operations, 75 screens).

The `00-shared/` spec is the source of truth for behavior, data and copy on every platform. Each app has one page and one Markdown bundle with its platform spec, native screen mapping, reference screens and theme code. All Markdown sources are served as-is under `/spec/`.

## Apps (one UI spec per app)

- [Web app UI](https://compositecode.github.io/substratalapps-applications-specs/platforms/web.md): Substratal Hub for Web (PWA); TypeScript, React, React Aria, TanStack, Workbox. HTML: https://compositecode.github.io/substratalapps-applications-specs/platforms/web.html
- [iOS app UI](https://compositecode.github.io/substratalapps-applications-specs/platforms/ios.md): Substratal Hub for iOS / iPadOS; SwiftUI (min iOS 17). HTML: https://compositecode.github.io/substratalapps-applications-specs/platforms/ios.html
- [Android app UI](https://compositecode.github.io/substratalapps-applications-specs/platforms/android.md): Substratal Hub for Android; Jetpack Compose + material3-adaptive. HTML: https://compositecode.github.io/substratalapps-applications-specs/platforms/android.html
- [Windows app UI](https://compositecode.github.io/substratalapps-applications-specs/platforms/windows.md): Substratal Hub for Windows; WinUI 3 / Windows App SDK, C#. HTML: https://compositecode.github.io/substratalapps-applications-specs/platforms/windows.html
- [Linux app UI](https://compositecode.github.io/substratalapps-applications-specs/platforms/linux.md): Substratal Hub for Linux (GNOME); GTK 4 + libadwaita, Flatpak. HTML: https://compositecode.github.io/substratalapps-applications-specs/platforms/linux.html
- [macOS app UI](https://compositecode.github.io/substratalapps-applications-specs/platforms/macos.md): Substratal Hub for macOS; SwiftUI (min macOS 15). HTML: https://compositecode.github.io/substratalapps-applications-specs/platforms/macos.html

## Shared spec

- [What changed (v1.4.0)](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/CHANGES.md): What changed in this edition
- [Product spec](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/PRODUCT-SPEC.md): Scope, personas, domains, phases, acceptance criteria
- [Screen specs](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/SCREEN-SPECS.md): Every screen: route, data, elements, actions, states
- [Client architecture](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/CLIENT-ARCHITECTURE.md): Sessions, requests, Capabilities, push and inbox, billing
- [UX flows](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/UX-FLOWS.md): The 16 end-to-end flows
- [Information architecture](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/INFORMATION-ARCHITECTURE.md): Navigation tree, routes, visibility rules, deep links
- [Themes](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/THEMES.md): Theme system: roles, palettes, contrast, persistence
- [Logo standard](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/brand/BRAND.md): Logo standard and app icons
- [Components](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/COMPONENTS.md): Component behavior contracts and native mapping
- [Copy & states](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/COPY-AND-STATES.md): Labels, confirmations, empty states, errors
- [Accessibility](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/ACCESSIBILITY.md): Accessibility requirements
- [Non-functional](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/NON-FUNCTIONAL.md): Performance, security, reliability
- [Open questions](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/OPEN-QUESTIONS.md): Unresolved decisions
- [Package README](https://compositecode.github.io/substratalapps-applications-specs/spec/README.md): layout of the specification package

## Design system

- [Themes gallery](https://compositecode.github.io/substratalapps-applications-specs/themes.html): 10 palettes with tokens and contrast; data in https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/themes/themes.json
- [Brand](https://compositecode.github.io/substratalapps-applications-specs/brand.html): logo variants and colours; data in https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/brand/brand-tokens.json
- [Reference screens](https://compositecode.github.io/substratalapps-applications-specs/screens.html): every reference render across platforms
- [UX flows](https://compositecode.github.io/substratalapps-applications-specs/flows.html): 16 flow diagrams (SVG in https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/flows/)

## Data

- [API → screen map](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/API-SCREEN-MAP.csv): CSV, method,path,summary,screens
- [Theme tokens](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/themes/themes.csv): CSV, one row per theme
- [Status semantics](https://compositecode.github.io/substratalapps-applications-specs/spec/00-shared/status-semantics.json): status → label, role, icons per platform

## Optional

- [llms-full.txt](https://compositecode.github.io/substratalapps-applications-specs/llms-full.txt): the complete shared spec concatenated into one file
- [Source repository](https://github.com/CompositeCode/substratalapps-applications-specs)