Substratal Apps Substratal Apps Hub specs
GitHub

Specification · Platform API v1.4.0

The Substratal Hub, designed for six platforms.

Build specifications, UI design, themes and the logo standard for the Substratal Hub — the dashboard client for the Substratal Apps Platform — on macOS, Windows, iOS/iPadOS, Android, Linux and the Web.

Browse the screens Explore the themes Read the product spec →
Platforms
6
Screens specified
75
API operations mapped
118
Themes
10
UX flows
16
Reference renders
292

macOS · Home — My Apps. Switch appearance with the palette button in the header.

Platforms

One self-contained folder per team: handoff, platform spec, all 75 screens with native controls, theme code, brand assets and reference renders.

Web (PWA)TypeScript, React, React Aria, TanStack, Workbox59 reference screens iOS / iPadOSSwiftUI (min iOS 17)18 reference screens AndroidJetpack Compose + material3-adaptive18 reference screens WindowsWinUI 3 / Windows App SDK, C#17 reference screens Linux (GNOME)GTK 4 + libadwaita, Flatpak17 reference screens macOSSwiftUI (min macOS 15)17 reference screens

Ten themes, one token system

Five light and five dark palettes share the same roles on every platform. Defaults are Moss Paper and Forest Floor. Pick one to repaint this site.

See every palette, token and contrast ratio →

Design system

Logo standard

The interlined root-twist mark, wordmark, lockups and app icons for every platform.

Themes

Token roles, ten palettes, WCAG 2.2 AA contrast, persistence and native mapping.

UX flows

16 end-to-end flows, from first run to push-notification support.

Components

Behavior contracts with the native control on all six platforms.

Copy & states

Labels, confirmations, empty states, upsells and error messages.

Accessibility

WCAG 2.2 AA requirements, high-contrast modes and assistive tech.

Push notifications at a glance

Every app shows the same unified Inbox of all apps' notifications plus Substratal's security and account alerts.

AppStackHow notifications arrive
Web (PWA)TypeScript, React, React Aria, TanStack, WorkboxWeb Push (VAPID)
iOS / iPadOSSwiftUI (min iOS 17)APNs (as app_hub)
AndroidJetpack Compose + material3-adaptiveFCM (as app_hub)
WindowsWinUI 3 / Windows App SDK, C#Polling + local notifications
Linux (GNOME)GTK 4 + libadwaita, FlatpakPolling + local notifications
macOSSwiftUI (min macOS 15)APNs (as app_hub)

Where to start

  1. What changed — push notifications, Free/Standard billing, the logo standard and themes.
  2. Product spec — scope, personas, 13 domains → 75 screens, phases and acceptance criteria.
  3. Your platform's handoff and platform spec.
  4. Screen specs and the API → screen map while building.