Appearance
The design: the floor and the axes
Every site stands on the same floor and differs on its axes. The floor is how a site is built — the same on every site, never compared, and it never makes two sites alike. The axes are what it looks like — the choices every site makes, each with the variants sites already built took. Choose a variant per axis from the business's own material, or make a new one; nothing here refuses a site for resembling another. The person decides what their site looks like.
The variants below come from the sites Brumy (brumy.ch), jtakeit's maker, built on the platform. They are a catalogue to draw from, and it grows the way it started: a variant enters when a site has built it.
Look at what has been built, first
Before DESIGN.md, look: get_design_catalogue holds the pieces of those sites — heroes, headers, phone menus, galleries, price lists, proof, contact blocks, footers, motifs, whole pages, and pieces with no axis at all — as pictures with their code, what each is, why it suited its business and how another would adapt it. Browse it whole (no arguments), then by a kind, an axis, a site or words, then a few pieces close (ids) with their code. Take ideas and make them the business's own, from its material; never a palette, words or photographs that are another's.
The floor
The scaffold carries it in both looks — the template and the bare one a custom design starts from — as tokens and defaults. Keep it when you rewrite the design; each item is something every visitor feels, whatever the look.
| Rule | Why | |
|---|---|---|
| F1 | The screen's height is --screen, never vh, svh or dvh in a height | the browsers inside Telegram, Instagram and WhatsApp resize the viewport under vh, and the page jumps |
| F2 | Fonts don't jump: the site's own font files, the first screen's faces preloaded, fallbacks with metric overrides (jtk fonts measures a pair); no font from a third-party host, no family named and never loaded | the text reflows when the font arrives, and a family that is never loaded silently falls back |
| F3 | Numbers line up: tabular lining figures wherever money, times and durations are drawn | prices and times are read in columns |
| F4 | Three measures: --measure-read for text and photographs on paper, --measure-object for filled surfaces — a calendar, a form, a card — one width with the header, full bleed for the beginning and the end | the page reads as one system, not a pile of blocks |
| F5 | One family of corners from one --radius; a nested corner is the outer one less the padding | nothing looks borrowed |
| F6 | Phones by rule: a row of up to seven things becomes a swipe with a peek; a long list stays a list; thumbnails share the width, never cropped; a tablet is a large phone, not a narrow desktop | the phone looks designed, not stacked |
| F7 | Data shows only an action: the booking form offers the days and times there are | no crossed-out noise, no dead ends |
| F8 | The first screen answers: the home page's heading and its one action are on the first screen of a phone (390 × 844) and of a desktop (1280 × 800) | a visitor who sees only a picture does not learn what the business does or how to book it |
| F9 | A link lands on its words: a tap on #kontakt puts the section's first words just under the header — scroll-margin-block-start the header's height and a little air, less the section's top padding | a visitor who arrives at empty padding scrolls again, and thinks the link missed |
| F10 | What can be seen whole, is: a section a little taller than a desktop's screen is tightened to fit it; a form with its heading fits one screen | the button of a form is out of sight while it is filled |
| F11 | A wall of pictures ends on a line: rows of one height, one proportion, or a picture spanning two — never columns ending apart | a ragged edge reads as unfinished |
| F12 | «Book» lands at the form: a button to the booking form links to the form's anchor (/services/#book), not the page's top | the visitor who asked to book does not hunt for it |
The kit's lint warns where a site leaves the floor — advice in the build's findings, never a refusal. preflight measures F8–F12 in a browser, in every direction (JTK_W_FIRST_SCREEN, JTK_W_ANCHOR_LANDING, JTK_W_SCREEN_FIT, JTK_W_RAGGED_GALLERY, JTK_W_BOOKING_LINK), and get_built_page says F8 beside a picture of the home page.
The axes
Write the choices in jtk/design.json under axes, one short line per key — what and from where, three words or more, never a tag like split or linen (hero, ground, measures, shape, header, phone_menu, overlap, surfaces, mark, motion, fonts, hook, proof, contact), and the reasons in DESIGN.md.
| Axis | Variants built | Chosen from |
|---|---|---|
| Hero | a portrait dissolving into the words · words and a framed photograph side by side · typography as the image over the business's own film · words over a live product window · a reel of their work · their own 3D model, turned or exploded by scroll · an object that is data — the next night as a ticket · a full-bleed photograph after an intro that draws the monogram · a live material field, no photograph | a strong picture of a person, of a thing they make, or neither |
| Ground | all light · light with one dark band (the ending, the booking) · a dark hero, then light · a dark room with one light object | the business's hours, its room |
| Measures | reading 30–44rem against a shell of 72–94rem | how many objects the business has — a calendar, a menu, a configurator |
| Shape | square, 0–2px · small, 3–12px · a scale 6–34px · soft, 10–28px — pills on top, or not | the material: wood and cloth softer, steel and concrete stricter |
| Header | a strip that becomes a capsule as you scroll · a floating capsule throughout · a strip that hides going down and comes back going up · a bar with menu panels · the wordmark alone, no navigation | the mark, the number of menu items |
| Phone menu | a full-screen wipe · a circle opening from the button in the accent · a dropdown card · a popover · an accordion with a floating action | |
| The overlap — one per page | a sheet over the hero's foot that stands up on scroll · a card over a photograph's edge · chips breaking a photograph's frame · the object over their own poster · a caption over a turning object · none but the header over the hero | what the one action is |
| Surfaces | always from their photographs or their place — linen, walnut and cork off the room; drafting paper and a millimetre grid; the blue of their tiles; lime plaster and walnut | never the template's palette |
| The mark — required | a motif from the business's own material, repeated in the interface: the ring off a logo, drawn; plan annotation and dimension lines; a rail with sleepers; a ticket stub; wood grain; a gloss sheen; a road; a drawer tray; an arch | always this business's, never compared |
| Motion | rises and stands up on scroll · scrubbed by scroll · draws · a sheen · timed cycles · follows the pointer — and how many regions always move | the tempo of the business |
| Fonts | serif and serif · serif and sans · grotesk and grotesk · a wide variable sans and a mono · condensed capitals and a sans · a heavy display and a sans | their voice, their sign |
| The hook | tap where it hurts · a turning product in your colour · a configurator whose price carries into the booking · a price list that adds up · a road of steps with the next free slot · free times on the home page · before and after | the one question a visitor arrives with |
| Proof | references with their places · approvals as plates with their validity · a wall of their own posters · ratings in the hero · a pass rate · the tradition's figures · a client's words | what the business must prove |
| Contact | one portrait, a form and a phone · two people with their own lines beside the form · the brand alone and a ticket · one WhatsApp message · the platform's diary in the page | how they work with a customer |
Two things are recorded but not chosen from a list: the order of the home page's sections, which follows from what the business must prove, and the transition between pages.
Live data is the platform's own advantage. The diary, the events and the shop are on the platform, and a page can draw them: the next free lesson in the hero, the free times on the home page, the next night as the hero itself. Where the business has them, consider it before a static picture.
Directions to choose from
When the person is shown two or three designs before one is built, declare them in jtk/design.json, each with its own axes:
json
"directions": [
{ "key": "a", "name": "Lehm & Leinen", "axes": { "hero": "…", "mark": "…" } },
{ "key": "b", "name": "Salbei", "axes": { "hero": "…", "mark": "…" } }
]The first is the default — the site's own styles are it. Style the others under html[data-direction='b']: the platform writes the attribute on a page asked as ?direction=b by somebody who may see the site (never for the public), keeps the choice for the next page, and offers the directions by name on the preview's badge and in the preview in the chat. get_built_page takes direction for a picture of one. Never a switch of the site's own: nobody can reach it.
A direction is a design, not a palette. Two directions differ on at least three axes, the hero among them — another hero, another shape, other surfaces, another mark. Directions that differ in colour and a typeface are one design recoloured, and the build says so (JTK_W_DIRECTIONS_ALIKE); a custom design that chooses fewer than ten axes or no mark is said too (JTK_W_DESIGN_AXES). Once the person has chosen, make the chosen one the site's own styles, take the others and directions out, and write its choices under axes.
What a model reaches for
A design nobody held to the business's material comes out the same everywhere. Stay away from these unless the business's own material asks for one by name — each is fine once, chosen; together they are a model's site:
- a display serif of the moment (Fraunces, Playfair Display, Cormorant) over Inter;
- cream or linen with terracotta, or sage green, as the palette;
- the photograph in an arch, a radial glow or a blurred blob behind it;
- pill buttons on everything, every section centred, numbered cards;
- icons for ornament, an emoji in a heading, a gradient on the words;
- a hero that is a photograph first and the words under the fold.
Look before the person does
Before the person sees a direction, look at it as a demanding designer would: get_built_page with shot: "review" pictures the first screen of every direction at a phone's width and a desktop's, says what the platform reads of the design — the axes, the mark, the faces, the business's own photographs against the trade's stand-ins, the fold — and asks the questions; answer them against the brief, the axes and the floor — the first screen, the mark, whether it could be any other business's site — and what lies below it: the floor's F9–F12. Fix what that finds, and look again: two rounds.
Ask at the end
A message that shows the person their site ends on one short paragraph, never a report: which direction they like, where there are several; what they would change; and, where you see one, an offer in a sentence — a section to add or take out, a motion, something the platform does that their site does not use yet (the two-week timetable, the shop, a journal).