Designing an app · Lesson 4
Two apps with the same data and the same agents can feel like different products. The look comes from a few lines of branding — a palette, two fonts, a button shape, a dark version — and the header; the languages from one list and texts written once per language. The runtime does the rest, and keeps it safe: only colours, plain font names and safe links reach the page.
Use Next, or the ← → keys. Change the colours, switch the device to dark, change the visitor’s language: the preview is styled by the same function the runtime’s layout calls.
palette · paletteDark · theme — four colours (primary, accent, background, foreground), their dark version, light, dark or auto.tokens · tokensDark — optional colours for a closer look: header, band, heading, card, eyebrow, soft.fonts · headingWeight · headingTracking · brandWeight — body, display and mono fonts from Google Fonts; how heavy and tight the titles and the name are.buttonShape · button · ghostButton — pill, rounded or square; which colour the main buttons use; neutral or coloured secondary buttons.logo · wordmark · byline · width — an SVG or image; the name in coloured parts; a line beside it; normal or wide pages.header — for visitors: links to the sections of the home, a call to action, an announcement.metadata.langs · defaultLang · timezone — the languages, the fallback, and the time zone dates are shown in.Colours other than #rrggbb, font names with anything but letters, digits and spaces, links that are not /…, #… or https://…, SVG with scripts: they never reach the page, whatever the manifest says.
Lesson 5 is about the agents: the task they receive, the tools the app gives them, and how their result becomes a record.