Skip to the content

Design system

The look the iOS app set, as tokens and live components for the web and every new product. Everything on this page is drawn from tokens.css.

Revenue

12 480,50 €
10%

Three files, one system

A token changes in all three in the same change. Each platform renders it natively (D15); none is a port of another.

iOS, the source of truth
apps/ios/ERPFlow/DesignSystem/Tokens.swift
Android, parity-tested
apps/android/app/src/main/kotlin/ai/erpflow/app/theme/Tokens.kt
Web, not wired in yet
apps/design-system/tokens.css

Brand

The mark is one wave drawn twice, the copy dropped straight down. It is the app icon, the launch screen, Home's tab icon and the shape drifting behind Home's hero. It is not the logo: the erpflow wordmark stays the logo.

Source: erpflow-ai-marketing/components/marketing/flow-mark.ts (geometry, copied verbatim everywhere), apps/web/src/components/brand/FlowMark.tsx, apps/ios/ERPFlow/Brand/FlowMark.swift, apps/web/src/components/brand/Logo.tsx, design.md D13.

White on brand blue: the app icon and the launch screen.
Brand blue on white: favicons and light surfaces.
White on the navy base: dark surfaces. As a tab icon it is a template image and takes the tab's tint.

Clear space

No written clear-space rule exists. The icons set it in practice: the mark spans 63% of the app icon's width (18.5% free on each side), 62% of the Apple touch icon, 55% of the maskable PWA icon (inside its 80% safe circle) and 25/32 of the favicon disc.

apps/ios/scripts/render-brand.swift markWidthFraction: 0.63; apps/web/scripts/render-pwa-icons.cjs.

Lockup: the mark, then the wordmark

Order
The mark leads, the wordmark follows.
Height
The mark as tall as the ascenders of l and f, 29.1 of the wordmark's 39 units, which is 1.33 times its x-height. It stands on the baseline.
Gap
40% of the mark's height, about half the x-height (shaded).

The wordmark alone is the logo; the mark stands beside it, never inside it. Logo.tsx defines no lockup and no file pairs the two, so the height and gap are this page's recommendation. The mark's own numbers are never retouched: a change starts on the marketing site and is copied to the web, iOS and Android together.

The geometry, verbatim
WAVE      = "M5 49C22 18 41 12 61 26C77 37 94 31 115 9C104 37 84 46 63 38C43 30.4 25 32 5 49Z"
WAVE_Y    = 1.3      vertical stretch, about the wave's top
WAVE_DROP = 24       the copy's drop, before the stretch
WAVE_TOP  = 9
transform = matrix(1 0 0 WAVE_Y 0 WAVE_TOP*(1-WAVE_Y) + drop*WAVE_Y)   drop = 0, then WAVE_DROP
viewBox   = "3 7 114 88"

Brand blue

--ds-brand

White on it . D19 calls it "about 6:1". The launch screen, the app icon, the primary button and the brand mark on white.

The palette at a glance

The gradient's four stops in this appearance, the brighter blue for text on dark, and the eight monogram tints.

top

glow

indigo

base

bright

badge

Colours

Semantic colours, defined for light and dark. On the brand gradient every screen takes the dark column, in both system appearances, because content there is always white on dark glass (D19). The light column is what system sheets use in the light appearance. Ratios are computed on this page from tokens.css, with the arithmetic of the iOS GlassContrastTests.

Source: Tokens.swift DS.Palette; Tokens.kt DS.Palette (parity-tested).

Status colours

As text, a status colour lives on a plain surface or the dark glass, never the bright gradient. On a list, status reads as a chip: white text on a solid status fill, whose ratio holds wherever the glass sits.

Source: apps/ios/ERPFlow/Records/RecordComponents.swift ChipTone.fillSpec; tones from apps/web/src/modules/invoices/components/StatusBadge.tsx.

Monogram tints

An organization or person without a picture gets a tint picked by FNV-1a of the lower-cased name, so a name keeps its colour across launches and platforms. The dark appearance draws white initials on the tint mixed 30% towards black; the light one draws the tint on itself at 16%.

Source: Tokens.swift DS.Palette.tints; apps/ios/ERPFlow/DesignSystem/Avatars.swift MonogramTint. DesignSystemTests pins "Northmark Advisory" to 0 and "Acme Bakery" to 5.

Gradients

Every screen sits on the brand gradient. It is attached to the top of the scrolling content, so it moves with it: brand blue with a violet-blue glow behind the hero, deepening through indigo into the deep navy the rest of the page is, by 70% of the first screen. Pulled down, a block of the top colour shows, never a gap. Dark is the same structure, darker throughout.

Source: apps/ios/ERPFlow/DesignSystem/BrandBackdrop.swift (BrandGradientBackdrop, GradientScroll, BrandGradientFill); Tokens.swift HomePalette; Tokens.kt GradientStops; design.md D19.

Light: the scrolling gradient, first screen at least 600 tall; drawn here at 440.
Dark: the same stops, deeper colours, and the glow at 60%.
Static, light: for a screen that does not scroll (sign-in, search results).
Static, dark.

Status colours never on the bright gradient

A status colour as text on the gradient falls under 4.5:1 where it is bright. On the dark glass, as a chip, it holds. The one exemption is the red notification badge, a platform convention.

Don't

Paid

on the glow

Do

Paid

white on the fill

Glow spot
glow at 70% fading to clear, a circle 34% of the gradient's height, centred 22% down
Overscroll
1200 of the top colour above the gradient
Mark
white 9%, 260 by 200, drifting in the bright part on Home only

Glass

Cards, rows and detail sections sit on dark glass: the gradient's navy base at 34% with a white 14% edge. In lists it is a solid translucent fill, not a live blur, because a blur of a smooth gradient looks the same and costs a pass per row. Only the header and the tab bar, which content really scrolls under, keep a material.

Source: Tokens.swift Glass; apps/ios/ERPFlow/Dashboard/DashboardViews.swift glassCard, homeGlass; Android backdrop/Glass.kt (glassCard, glassBlur); tests ERPFlowTests/BuildFourFixTests.swift GlassContrastTests and Android GlassContrastTest.

Glass over the glow

The worst case: the lightest stop a card can sit on.

Glass over the base

Further down it is the navy itself, edged white 14%.

Measured contrast on the glass

Over the glow stop, in each appearance. Targets from D19: white 8:1, secondary 5.6:1, chips 5:1 or better. Pinned by the iOS and Android contrast tests.

On the glassLightDark

Shadows, radii and spacing

Small scales, each with a job. Glass casts no shadow; shadows belong to plain cards in sheets and to the toast. Radii grow with the size of the thing: a field or row 14, a card 20, Home's cards 24, a sheet 32, and anything you press is a capsule.

Source: Tokens.swift DS.Shadow, DS.Radius, DS.Space; Tokens.kt DS.

Shadows

On a system sheet, in this appearance.

card

black 8%, blur 14, y 6

lifted

black 18%, blur 24, y 12: the toast

Corner radii

sm 10
skeletons

md 14
rows, fields

lg 20
cards

home 24
Home's cards

sheet 32
sheets

capsule
buttons, chips

Spacing

Typography

Web products set the brand's public face, the marketing site's: Inter for body and UI, Inter Tight for titles and figures, Geist Mono for code and token values. The native apps keep the platform's system font, SF Pro on iOS (SF Pro Rounded for titles and figures) and Roboto on Android, as D14 and update-android-pilot A7 decided. Inter is the closest web match to SF Pro, so the scale carries over unchanged. Every style follows the reader's text size, so web sizes are in rem. Amounts use tabular figures, as the apps do.

Source: erpflow-ai-marketing/app/[locale]/layout.tsx and app/globals.css (--mkt-body-family, --mkt-display-family, display tracking); Tokens.swift DS.Font; sizes and line heights as Android's theme/Theme.kt writes them out, Apple's defaults at the Large text size.

Aa

Inter

Body and UI: labels, buttons, rows, amounts in lists. 400, 500, 600 and 700. --ds-font-sans, font-sans.

Aa

Inter Tight

Titles, the hero figure, metric figures, monograms. 600 and 700, tracked tighter as it grows: −0.02em, −0.028em from 30 px, −0.035em from 48 px; Russian takes most of it back. --ds-font-display, font-display.

Aa

Geist Mono

Code, token names and values. 400, tabular. --ds-font-mono, font-mono.

The hero figure

12 480,50 €

56 Inter Tight bold for the whole part. From the decimal comma on, 26 semibold; a whole amount sets only its symbol smaller (4310 €). Both sizes scale with the text size; the figure shrinks to 40% before it truncates.

4310 €

A metric card's figure: 24 Inter Tight bold. Both in tabular figures.

At large text sizes

  • From xxLarge the metric cards go to one column and a figure may drop its symbol to a second line rather than shrink.
  • From xxxLarge the action row goes from four columns to two.
  • At the accessibility sizes, list rows and detail rows stack their label above the value.
  • The welcome tagline caps at xxxLarge so it never collides with the fixed-size mark; everything else scales fully.

DashboardViews.swift, HomeView.swift, RecordComponents.swift AdaptiveRow, design.md D14.

Patterns

Three brand moments, each small. The mark drifts faintly behind Home's hero. On the welcome screen the two waves bob on the brand blue. Finishing setup, or creating an organization, ends in confetti and a success toast. Under Reduce Motion the mark stands still and the confetti is skipped; the toast stays.

Source: BrandBackdrop.swift; apps/ios/ERPFlow/Brand/BrandStage.swift FlowMarkView; apps/ios/ERPFlow/Dashboard/Confetti.swift; apps/ios/ERPFlow/Organization/HomeView.swift; design.md D12.

The drifting mark: white 9%, 260 by 200, turning between 3° and −4° and sliding 26 across and 18 down over 9 s, there and back.
The welcome waves: the mark at 160 wide, each wave bobbing ±3 across and ±4 down with a 2% stretch, a 3.6 s period, the lower wave a quarter period behind, easing in over 1.5 s.

Plays once, when the last setup step is done or an organization is created.

Confetti: 90 pieces from the upper middle, 6 to 12 wide, a quarter round, falling under gravity for 2.6 s and fading over the last 0.7 s, with a success toast for 3 s. It never takes a tap.

Motion

Instant feedback, visible progress and small celebrations, never anything that dramatises the figures themselves. Presses spring, figures count up, cards rise in turn, the setup ring fills, and the month slides from the side it came from. Nothing delays data or blocks a tap; transitions stay under about 400 ms and only the celebrations run longer.

Source: Tokens.swift Motion; Tokens.kt Motion, SpringToken; apps/ios/ERPFlow/Dashboard/CountUp.swift; apps/ios/ERPFlow/Setup/SetupViews.swift; design.md D12.

Preview with Reduce Motion

The demos below follow this switch or the system setting, whichever is on.

Tokens

iOS springs are (response, damping fraction); the web gets a linear() curve sampled from the same spring.

Press

Hold it: 97% on the press spring. Header glass goes to 94%.

Count-up

0.9 s ease-out, whole numbers on the way, the exact value at the end.

Staggered entrance

Rise 22 and fade in, 70 ms apart, on the stagger spring.

Ring fill

Fills from empty after 300 ms, 0.9 s ease-out. Full at once under Reduce Motion.

Month slide and shake

The hero at the top of this page steps months: the new month slides 36 in from the side it came from on the smooth spring, fading from 60%. A field that fails validation shakes three times, 9 either way, in 0.4 s. Under Reduce Motion both become a cross-fade.

Reduce Motion

  • Movement becomes a 0.2 s ease-in-out cross-fade.
  • No count-ups: figures show their value at once.
  • No confetti; the success toast still shows.
  • No stagger, slide, bob, shimmer, shake or badge pop.
  • The drifting mark settles and stands still.
  • Screen readers always get the final value, never the counting.

Components

Built here in HTML from the tokens, as the app draws them. First the shell together, as one screen; then each part with its states.

Source: apps/ios/ERPFlow/DesignSystem/ (Buttons.swift, Surfaces.swift, Avatars.swift, FormField.swift), apps/ios/ERPFlow/Records/RecordComponents.swift, RecordRows.swift, apps/ios/ERPFlow/Dashboard/, apps/ios/ERPFlow/Shell/GlassHeader.swift, MainTabView.swift; design.md D17, D18.

The shell: one glass header pinned over Home, Customers, Invoices and Expenses, content scrolling under it from 12 below, and the floating tab bar. iOS draws the tab bar itself (Liquid Glass, minimising on scroll); its size and selected pill here are measured from the iOS 26 reference, not tokens.

Buttons

Primary is filled, secondary is the outlined capsule, the text link is the tertiary. Pressed springs to 97%; loading keeps the width and swaps the label for a spinner; disabled is 45%.

On the brand blue (welcome) the fill inverts: white with brand-blue text, and a white 70% outline.

Round glass actions

60 circles, white 20% with a white 18% edge, 22 icons, the label below. The module tabs until the create flows exist.

Month control

As the web's month navigator. Previous dims to 35% at the month of the first record; next is never disabled. The month opens a picker sheet.

Status chips

Paid Issued Overdue Partially paid Overpaid Draft Void

Sentence case, 13 semibold. Overdue wins, then partially paid, then overpaid, then the stored status. Void is struck through.

Change chips

10% 12% 24% 0% 999%+ —

Green when the move is good news, red when bad: fewer expenses is green. Flat is grey; no base to compare is "—"; beyond ±999 it caps with a plus. On the gradient it sits on black 34% instead of its own tint.

Glass metric cards

Expenses

4310 €

9 expenses

10%

Other income

640 €

2 entries

8%

Outstanding

7124,50 €

3 invoices

Overdue

1234,50 €

1 invoice

Home's glass at radius 24, padding 16. Change chips on Revenue, Expenses and Other income only. Overdue turns red while anything is overdue.

Setup progress

A 60 ring, stroke 12% of its size, brand at 16% under the brighter blue, round caps from the top. It does not follow the month.

Header and badge

Search 99+
1 12

Controls are 44 circles. The badge is a red capsule that grows with its text (a circle for one digit, a pill for "12" and "99+"), ringed in the colour behind it, hidden at 0. It pops once when the count rises.

Avatars and organization logos

Always circles. An organization's square logo fills the circle; a wide logo is fitted whole on a white disc, never cropped; without either, a one-letter monogram on its tint. A person gets two initials.

Form field

Enter a valid email address.

54 tall on the glass. The edge is the separator at rest, a 2 brighter-blue ring in focus, a 2 red ring with the error under it.

Banner and toast

Its tint at 12%, edged at 35%. As a toast it drops in from the top with the lifted shadow and leaves after 3 s.

Empty, error, no access and loading

No invoices yet

Create your first invoice on the web and it will show up here.

Something went wrong

Can't load your figures right now.

No access

Your role can't view invoices. Ask an owner or admin if you need them.

Every network call has a loading, an empty and an error state. An empty state invites the next step; an error says what failed and offers Try again; no access names the role and never calls the API.

Content rules

The same figures, dates and words on every platform.

Source: apps/web/src/lib/money.ts formatMoney; apps/ios/ERPFlow/Money/Money.swift; apps/web/src/lib/format-date.ts; design.md D9, D10, D16.

Money, exactly as the web's formatMoney

Estonian shape in every language: a narrow no-break space (U+202F) between thousands, grouping only from five digits, a decimal comma, ,00 dropped, the symbol after. On screen in lists and details the gap before the symbol is an ordinary no-break space (U+00A0), because the narrow one closes up at app sizes. This table runs the web's function in your browser.

Amount and currencyOn screen

Dates

A calendar date is ISO 8601 in every language: 2026-10-12, as the API sends it. Month labels are the language's own, capitalised, with no era marker.

"Organization"

US spelling, as the web. Never "workspace". Estonian "organisatsioon", Russian "организация". Code identifiers follow the same word.

No prices or upgrade prompts in the apps

Billing stays on the web (D9). A plan-locked item shows a lock and reads neutrally, with no plan name, price or upgrade link.

OrdersNot on your current plan

A gated organization reads "this organization's account isn't active right now", with no Retry and no plan wording.

Accessibility

The quality bar every screen meets: both appearances, every text size, screen-reader labels and traits on every control, and targets you can hit.

Source: design.md D14, D18, D19; Tokens.swift DS.Space.tap; Tokens.kt Space.tap; the row and chip summary and spokenText in RecordRows.swift, DashboardData.swift.

4.5:1

Contrast

Text at 4.5:1 or more, in both appearances, measured over the lightest backdrop it can sit on. 3:1 is only for large text (24, or 18.7 bold) and for non-text edges.

4448

Targets

44 pt on iOS, 48 dp on Android, and 44 px on the web (--ds-tap). A small icon gets a bigger hit area, not a bigger icon.

Aa Aa

Text scaling

Every style follows Dynamic Type, Android's font scale and the browser's text size. Layouts reflow at large sizes rather than truncate.

Labels

  • "Notifications, 3 unread"
  • "Organization: Northmark Advisory"
  • "Invoice 2026-014, Acme OÜ, 1234,50 €, Overdue, due 2026-10-12"
  • "up 10 percent vs last month"
  • A counting figure reads its final value.

On the watch list

Pairs the iOS app draws today that fall under 4.5:1, measured where they sit. All are in the light appearance over the bright part of the gradient, or monograms on some tints. None is pinned by a test yet; fix them in the token files before the web copies them.

Web gap

Where apps/web differs from this system today: the checklist for bringing the web in line. Web values are from apps/web/src/index.css, components/ui/data/Badge.tsx and components/ui/primitives/Button.tsx (Tailwind 4.3); oklch values converted to hex.