Flakk · Design direction board · 19 November 2026 · Bible 1.1

Quiet Ledger

Paper, ink, one gold rule. Flakk is a hotel's quiet, expensive notebook. Every screen is a context line, one large serif number or date, one sentence that says what matters, and lists drawn with hairlines. The orb is the only thing that glows. Nothing else competes.

What Gummi asked for, and how this answers it

Luxurious, straightforward, complex, but minimalistic.

Luxury ad, not dashboard. A luxury ad has one image, one line, one mark. Each Flakk screen has one hero, one lede and one amber action. Complexity lives in the density of the lists, never in the chrome.

The Flakk yellow, with intent. Amber is the orb, the one primary action, the selected tab, the progress rule and the action lines. Navy carries the dock and the numerals. Green, clay and blue appear only as six-pixel status dots. More colour meaning, less colour area. The 15:03 layout spread amber across hero cards, tiles and count discs; that is what read as "AI and basic".

Motion for every detail. MOTION.md names every transition on every surface: presses, tab switches, sheets that grow out of the orb and return into it, list reflows, success ticks, the key ring, reduced motion.

Haptics that confirm, never chatter. HAPTICS.md: one tick per intention, success felt once from the app's own success path, mapped to the native iOS generators through the Flakk bridge.

Ten principles

the gate checks each one
  1. Paper and ink, one theme.Warm paper, ink text, navy numerals. No dark mode anywhere in the apps. The only dark objects are the dock, the desktop sidebar, the Flakk Key card and the toast.
  2. Rules, not boxes.Hairlines separate content. Cards exist only for physical objects: a key, a stay, a room, a sheet. Never a card around a list, never a tile.
  3. Numbers are the hero.Context line, then one Fraunces line, then one sentence. Ledger numbers are 40 px light serif with a small sans unit.
  4. One amber per region.At most one amber-filled control per screen or column. Otherwise amber is a 3 px rule, a progress fill, the tab disc or the orb. Amber text never sits on paper.
  5. Status is a dot and a word.No pills, chips, badges, count discs or outlined tags anywhere.
  6. Space is the luxury.24 px phone gutter, 40 px desktop gutter, 32 px between sections, 64 px list rows. If a screen feels empty, that is correct.
  7. Symmetry around the orb.Phone: two or four icon-only, equal-width tabs around the centre buckle. No labels, no top bar on the selected tab, never a sub-tab row. Desktop: navy left sidebar with the orb on top.
  8. Everything the AI shows comes out of the orb.Sheets, answers, confirmations and toasts scale and fade from the orb's centre and go back into it.
  9. Motion is short, springy, transform and opacity only.400 ms snappy, 550 ms smooth, 24 ms stagger, press squash 0.96. Reduced motion keeps 120 ms fades.
  10. Haptics are rare and exact.Selection for tabs, medium for the primary action, success once when it actually succeeded, error once when it failed. Never on scroll, never on back.

Colour

tokens 1.2.0 + 1.3.0
paper#FBF8F2
linen#FFFDF9
cream#F3EDE2
cream-2#EEE6D8
ink#16181D
ink-soft#4A4E58
ink-faint#6A6E77
navy#0F2A47
navy-deep#0A1D33
amber#F2A741
amber-rule#E9A33F
amber-ink#8F5710
amber-wash12 % amber
ok#1F8A5B · dot only
warn#C98612 · dot only
bad#C2402F · dot only
info#2F6FB3 · dot only

Type

Fraunces · Geist · Geist Mono · 16 px floor
hero 56 / 300 / opsz 14419 November
large 40 / 300515,300 kr
display-2 30 / 400When will you arrive?
title 19 / 600Needs you
body 16 / 400Hulda leaves with 42,000 kr open. Card declined at 08:12.
mono 16flakk-next · bde3953b · tokens 1.3.0

The screens

9 × phone 390 and desktop 1440

Hotel overview

Owner on a Thursday. The date is the hero; the lede says what the day is; the ledger says the four numbers; Needs you says the two things to do, each with one action line.

Overview, phone
Flakk · phone · owner
Overview, desktop
Flakk console · 1440 · sidebar, ledger, Needs you, Arriving

Inbox

Messages as a ledger of people. Unread is a bold title and an amber dot on the avatar. Desktop: list, thread, and a facts rail with the one action that matters now.

Inbox, phone
Flakk · phone
Inbox, desktop
Flakk console · list 380 · thread · rail 360

Finance

The money is the hero. No chart decoration; a ledger of collected, open, payouts, refunds, then the one person who owes.

Finance, phone
Flakk · phone · Money
Finance, desktop
Flakk console · Money

Calendar

Phone: a seven-day strip with a 3 px amber rule under today, then who arrives and who leaves. Desktop: the booking chart as navy bars on paper, today as an amber wash column.

Calendar, phone
Flakk · phone · Bookings
Calendar, desktop
Flakk console · 14-day chart

Cleaning checklist

Housekeeping, room 304, Kenji arrives 16:30. Done is an amber disc with a navy tick and the label fades. Room ready stays disabled until the list is complete; then it is the one amber control.

Cleaning, phone
Flakk · phone · housekeeping
Cleaning, desktop
Flakk console · rooms by status, checklist in the rail

Flakk Guest · home

Orb first. The orb greets the guest by name; the key card and the stay card are the only two objects. Two tabs around the orb: Stay and Key.

Guest home, phone
Flakk Guest · phone
Guest home, desktop
Flakk Guest · desktop · centred column

Flakk Guest · check-in

One question per screen. Choice rows, one amber Continue, text Back, the orb alone at the bottom. The dock is hidden for the flow.

Check-in, phone
Flakk Guest · step 2 of 4
Check-in, desktop
Flakk Guest · desktop

Flakk Guest · Flakk Key

Room 104 until Saturday 11:00. Hold the ring 600 ms: medium tick at hold start, heavy at full, success when the door reports open. Doors as rows with status dots. Access ends at the exact check-out minute.

Flakk Key, phone
Flakk Guest · Key · ring at 70 %
Flakk Key, desktop
Flakk Guest · desktop

Developer

Same language for the developer role: lanes as rows with a status dot and a short hash, the log in mono, nothing that looks like a terminal theme.

Developer, phone
Flakk · phone · developer
Developer, desktop
Flakk console · developer

Before and after

why the 15:03 direction was retired
Rejected: Amber Concierge desktop
Retired · Amber Concierge (bsfa, 15:03). Pill row for sub-navigation, coloured tiles, count discs, amber hero card, labelled tabs, dark-mode support. Reads as a generic admin tool.
Adopted: Quiet Ledger desktop
Adopted · Quiet Ledger. Sidebar with the orb, the date as the hero, a ledger drawn with rules, one amber button, one action line per need.
vj4u reference phone
Reference · vj4u target (16:00). Right paper-and-ink base; its labelled dock and segment row are removed in the bible.
Adopted phone
Adopted · phone. Icon-only equal tabs, symmetric around the orb, no header bar, no segment row.

Motion, in one table

full spec in MOTION.md
DetailWhat movesTime and curve
Pressscale .96 (.94 on big objects), springs back90 ms in, 400 ms snappy out, peak 1.4 %
Tab switchcontent host only; out −24 px, in +32 px, first six blocks stagger140 ms out, 550 ms smooth in, 24 ms stagger
Sheet presentgrows from the orb centre, scale .82 → 1, scrim fades, belt tucks, orb morphs550 ms smooth; dismiss 400 ms toward the orb
Dock belthalves retract toward the orb with translate + scaleX + opacity, right half 30 ms behind480 ms; orb 1 → 1.3 gentle 880 ms
List changeneighbours FLIP; removed row fades + .96; new row from −8 px400 ms; never a height animation
Successbutton label cross-fades, 14 px tick draws, button turns navy, row updates after 1.2 s160 + 260 ms; haptic success at tick start
Key ringarc draws on hold, fills amber at 100 %, icon springs 1.06 → 1600 ms linear; rewind at 2× on release
Reduced motionloops stop, travel becomes 0, state changes keep a fade120 ms

Haptics, in one table

full spec in HAPTICS.md
IntentionKindiOS nativeWeb fallback
Tab, switch, radioselectionUISelectionFeedbackGenerator6 ms
Tap a secondary controllightUIImpactFeedbackGenerator .light8 ms
Primary action, hold start, drag pick-upmedium.medium14 ms
Hold completeheavy.heavy24 ms
Orb activatesoft.soft8 ms
Confirmed by the appsuccessUINotificationFeedbackGenerator .success10 · 60 · 18 ms
Destructive sheet, blocked fieldwarning.warning18 · 90 · 18 ms
Failed by the apperror.error24 · 50 · 24 · 50 · 24 ms
Scroll, back, toast, reflow, skeletonnone

Review gate

nothing ships unreviewed

1 · Builder submits

Screenshots at 390 and 1440 plus 1.3× text scale, motion recordings both directions, a reduced-motion pair, the haptic map with file:line, the checker report, the security line, file hashes.

2 · Director checks

Hard fails first (header bar, pills, labels, dark mode, tiles, small text), then structure, type and colour, components and states, motion, haptics, copy, security.

3 · Verdict

DESIGN-PASS or DESIGN-FAIL with a numbered fix list, sent back as a decision handoff. gwvf ships a wave only when every screen has a pass newer than its last change.

Documents

E:\Flakk\Design