Styleguide
The defaults every app starts with. Each piece below is drawn by the starter's own stylesheet, with the classes that draw it, its markup and its CSS ready to copy. Change a variable and every piece follows.
There is no component library to install. Every rule on this page lives in one file in your app, web/app/globals.css: the variables and the classes shown here. AutoTable and AutoForm from the SDK are drawn with the same classes, so a table you add looks like the one on this page.
This is the Inference Bureau look. It ships with web apps and with Shopify apps created with the Inference Bureau look. Shopify apps created with Polaris use Shopify's components instead, and storefront blocks take the theme's styles. The same guide ships into each app on this look as the look-and-feel agent skill, so an agent building a page follows it too.
What everything is built from
Color
Near-black surfaces in four steps, two line weights, four greys of text, and signal colors in OKLCH. A signal appears as a tile with its own tint, never as a wash over a surface.
:rootcolor-scheme: darkCSS
:root { --bg: #0a0a0a; --side: #070707; --raised: #0d0d0d; --hover: #1a1a1a; --line: #1f1f1f; --line-input: #2e2e2e; --text: #ededed; --text-2: #a1a1a1; --muted: #8f8f8f; --faint: #6e6e6e; --ok: oklch(0.78 0.14 155); --ok-bg: oklch(0.78 0.14 155 / 0.16); --info: oklch(0.8 0.1 240); --info-bg: oklch(0.78 0.1 240 / 0.18); --warn: oklch(0.8 0.14 80); --warn-bg: oklch(0.8 0.14 80 / 0.16); --ai: oklch(0.78 0.12 300); --sans: var(--font-sans), system-ui, sans-serif; --mono: var(--font-mono), ui-monospace, Menlo, monospace; color-scheme: dark; }
Put a signal color on a small tile beside words, with its tint behind it. The words carry the meaning; the color confirms it.
Tint a whole card or row, add a left border stripe, or use a signal color for text alone. Only the error banner fills.
Type
Geist for everything readable, Geist Mono for anything a machine wrote: file names, commands, counts and eyebrows. Seven sizes, tight tracking on the display size only.
--sans--monoh1.page-head h1.lede.eyebrowcodeCSS
body { margin: 0; background: var(--bg); color: var(--text); font: 14px/1.5 var(--sans); -webkit-font-smoothing: antialiased; } h1 { margin: 0; } h1 { font-size: 44px; line-height: 1.08; font-weight: 600; letter-spacing: -0.035em; } @media (max-width: 640px) { h1 { font-size: 32px; } } .page-head h1 { font-size: 28px; line-height: 1.15; font-weight: 600; letter-spacing: -0.025em; } .lede { max-width: 560px; font-size: 16px; color: var(--text-2); } .eyebrow { font-size: 12px; color: var(--muted); letter-spacing: 0.02em; } code { font-family: var(--mono); font-size: 0.92em; color: var(--text-2); } @media (max-width: 640px) { .top .btn { display: none; } } @media (max-width: 640px) { .main { padding-top: 36px; gap: 36px; } }
Space and radius
Containers are 12, controls are 9, small things are 8 and under. Heights come in five steps. Gaps grow from 6 inside a control to 48 between sections.
.wrapmax-width: 1040pxpadding: 0 24pxCSS
.wrap { width: 100%; max-width: 1040px; margin: 0 auto; padding: 0 24px; } .main { flex: 1; padding-top: 56px; padding-bottom: 64px; display: flex; flex-direction: column; gap: 48px; } @media (max-width: 640px) { .main { padding-top: 36px; gap: 36px; } } .main.page { padding-top: 28px; padding-bottom: 36px; gap: 24px; }
Icons
Hand-drawn strokes on a 12-unit grid, 1.3 wide, in the current text color. No icon font and no fills. At 24px and up the stroke stays the same, so icons read light.
viewBox="0 0 12 12"stroke="currentColor"stroke-width="1.3"aria-hidden="true"Markup
<svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M2.5 6.2l2.3 2.3 4.7-5" stroke-linecap="round" stroke-linejoin="round"></path></svg>
The pieces, as they ship
Buttons
White on black for the one thing to do, an outline for everything else. Forty-four tall with an icon on the right when it leads somewhere. The small size is for toolbars and headers.
.btn.primary.ghost.danger.sm:disabledMarkup
<button class="btn primary" type="button">Edit this page<svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.4" aria-hidden="true"><path d="M4.5 3l3 3-3 3"></path></svg></button> <a class="btn ghost" href="https://inferencebureau.com/app">Open in Inference Bureau<svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M4.5 2.5h5v5M9.5 2.5L3 9"></path></svg></a> <button class="btn danger" type="button">Delete record</button> <button class="btn primary" type="button" disabled>Saving</button> <button class="btn primary sm" type="button">New record</button> <button class="btn ghost sm" type="button">Export CSV</button>
CSS
.btn { display: inline-flex; align-items: center; gap: 8px; height: 44px; padding: 0 18px; border-radius: 9px; font-weight: 500; } .btn { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .btn.sm { height: 32px; padding: 0 12px; border-radius: 8px; font-size: 13px; font-weight: 400; } .btn.primary { background: var(--text); color: var(--bg); } .btn.primary:hover { background: #ffffff; } .btn.ghost { border: 1px solid var(--line-input); color: var(--text-2); } .btn.ghost:hover { color: var(--text); border-color: #3a3a3a; } .btn.danger { background: oklch(0.63 0.2 25); color: #fff; } .btn:disabled { opacity: 0.6; cursor: default; }
One primary button per view. Ghost for the rest. Danger only when something is deleted, and never as the primary.
Add a brand color, a gradient or a shadow. A button is the text color inverted, nothing else.
Badges
A state is a tinted icon tile plus words, in an outlined box. The icon says what kind of state, the words say which. Four tones.
.badge.ok.info.warn.dim--t · --t-bgMarkup
<span class="badge ok"><i><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M2.5 6.2l2.3 2.3 4.7-5" stroke-linecap="round" stroke-linejoin="round"></path></svg></i>Signed in</span> <span class="badge info"><i><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M6 2.5v7M2.5 6h7" stroke-linecap="round"></path></svg></i>Ready to add</span> <span class="badge warn"><i><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M6 2.5v4M6 9v.5" stroke-linecap="round"></path></svg></i>Email not connected</span> <span class="badge dim"><i><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M2 2.5h8M2 5h8M2 7.5h5M2 10h6"></path></svg></i>Logging</span> <span class="badge"><i><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><circle cx="6" cy="6" r="4.5"></circle><path d="M6 3.5v3l2 1.2" stroke-linecap="round"></path></svg></i>Queued</span>
CSS
.badge { align-self: flex-start; display: inline-flex; align-items: center; gap: 8px; font-size: 13px; border: 1px solid var(--line-input); border-radius: 8px; padding: 2px 10px 2px 2px; --t: var(--muted); --t-bg: var(--hover); } .badge i { width: 22px; height: 22px; border-radius: 6px; background: var(--t-bg); color: var(--t); display: inline-flex; align-items: center; justify-content: center; } .badge.ok { --t: var(--ok); --t-bg: var(--ok-bg); } .badge.info { --t: var(--info); --t-bg: var(--info-bg); } .badge.warn { --t: var(--warn); --t-bg: var(--warn-bg); color: var(--text-2); } .badge.dim { color: var(--text-2); }
Name the state in words the reader would use: Signed in, Ready to add, Email not connected.
Use a colored pill with no icon and no border. The color alone has to be decoded, and it fails for the colorblind.
Environment tag
A smaller badge that says which environment a page is served from. Branch and blue for development, globe and green for production. It sits in the header beside the app's name.
.env.development.productionMarkup
<span class="env development"><i><svg width="10" height="10" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><circle cx="3.5" cy="2.8" r="1.3"></circle><circle cx="3.5" cy="9.2" r="1.3"></circle><circle cx="8.5" cy="4.6" r="1.3"></circle><path d="M3.5 4.1v3.8M8.5 5.9c0 1.6-1.4 2-3.4 2.4"></path></svg></i>development</span> <span class="env production"><i><svg width="10" height="10" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><circle cx="6" cy="6" r="4.5"></circle><path d="M1.5 6h9M6 1.5c1.5 1.4 1.5 7.6 0 9M6 1.5c-1.5 1.4-1.5 7.6 0 9"></path></svg></i>production</span> <span class="env development"><i><svg width="10" height="10" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><circle cx="3.5" cy="2.8" r="1.3"></circle><circle cx="3.5" cy="9.2" r="1.3"></circle><circle cx="8.5" cy="4.6" r="1.3"></circle><path d="M3.5 4.1v3.8M8.5 5.9c0 1.6-1.4 2-3.4 2.4"></path></svg></i>feature-x</span>
CSS
.env { display: inline-flex; align-items: center; gap: 6px; font-size: 12px; color: var(--text-2); border: 1px solid var(--line-input); border-radius: 7px; padding: 2px 8px 2px 2px; --t: var(--info); --t-bg: var(--info-bg); } .env.development { --t: var(--info); --t-bg: var(--info-bg); } .env.production { --t: var(--ok); --t-bg: var(--ok-bg); } .env i { width: 18px; height: 18px; border-radius: 5px; background: var(--t-bg); color: var(--t); display: inline-flex; align-items: center; justify-content: center; }
Cards
A raised panel with a thin line, a badge for its state, a bold title and one line of muted copy. Cards fill a grid of at least 240px each and never link as a whole; a link inside is a link.
.cards.cardminmax(240px, 1fr)Markup
<div class="cards"> <div class="card"><span class="badge ok"><i><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M2.5 6.2l2.3 2.3 4.7-5" stroke-linecap="round" stroke-linejoin="round"></path></svg></i>Signed in</span><strong>Your first account</strong><p>The signUp action saves each person as a <code>user</code> record.</p></div> <div class="card"><span class="badge info"><i><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M6 2.5v7M2.5 6h7" stroke-linecap="round"></path></svg></i>Ready to add</span><strong>A members-only page</strong><p>Add a page under <code>web/app/(signed-in)/</code> and only signed-in people see it.</p></div> <div class="card"><span class="badge dim"><i><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M2 2.5h8M2 5h8M2 7.5h5M2 10h6"></path></svg></i>Logging</span><strong>Every request, on record</strong><p>Requests, jobs and actions land in the event log.</p></div> </div>
CSS
.cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); gap: 12px; } .card { border: 1px solid var(--line); border-radius: 12px; background: var(--raised); padding: 18px; display: flex; flex-direction: column; gap: 12px; } .card strong { font-weight: 500; } .card p { color: var(--muted); font-size: 13px; }
Fact list
A definition list for one record's fields: a muted term column of 140px and a value column, each row divided by a line. On a phone the term sits above its value.
.factsdl · dt · ddMarkup
<dl class="facts"> <dt>Team</dt><dd>inferencebureau</dd> <dt>Domain</dt><dd>inferencebureau.app</dd> <dt>Created</dt><dd>8 Nov 2026, 09:14</dd> <dt>Roles</dt><dd><code>signed-in</code> <code>admin</code></dd> <dt>Email</dt><dd>ops@inferencebureau.app</dd> </dl>
CSS
.facts { margin: 0; display: grid; grid-template-columns: 140px minmax(0, 1fr); border: 1px solid var(--line); border-radius: 12px; overflow: hidden; max-width: 640px; } .facts dt { margin: 0; padding: 14px 18px; border-top: 1px solid var(--line); } .facts dd { margin: 0; padding: 14px 18px; border-top: 1px solid var(--line); } .facts dt { color: var(--muted); font-size: 13px; } .facts dd { overflow-wrap: anywhere; } .facts dt:first-of-type { border-top: 0; } .facts dt:first-of-type + dd { border-top: 0; }
Form fields
The label is small and secondary, above the control. Sign-in fields are 44 tall on a raised surface; AutoForm fields are 36 tall on the page color, so a long form stays light. Focus is a lighter border, no ring.
.form.field.error.switch.auto-form.auto-field.invalid.inlineMarkup
<form class="form"> <label class="field">Email<input type="email" placeholder="you@inferencebureau.app" value="jay@inferencebureau.app"></label> <label class="field">Password<input type="password" value="••••••••••"></label> <span class="error">That password doesn't match this email.</span> <button class="btn primary" type="submit">Sign in</button> <span class="switch">New here? <a href="/sign-up">Create an account</a></span> </form> <form class="auto-form"> <label class="auto-field">Title <span class="auto-required">required</span><input type="text" value="Linen shirt"></label> <label class="auto-field">Status<select><option>Active</option><option>Draft</option></select></label> <label class="auto-field invalid">Price<input type="text" value="−4.00"><span class="auto-error">Must be zero or more.</span></label> <label class="auto-field inline">Verified purchase only<input type="checkbox" checked></label> <div class="auto-actions"><button class="btn primary sm" type="submit">Save</button><button class="btn ghost sm" type="button">Cancel</button><span class="auto-saved">Saved</span></div> </form>
CSS
.field { display: flex; flex-direction: column; gap: 6px; font-size: 13px; color: var(--text-2); } .field input { height: 44px; padding: 0 12px; border: 1px solid var(--line-input); border-radius: 9px; background: var(--raised); color: var(--text); font: 14px var(--sans); } .field input:focus { outline: none; border-color: #4d4d4d; } .error { font-size: 13px; color: oklch(0.7 0.17 25); } .switch { font-size: 13px; color: var(--muted); } .auto-form { display: flex; flex-direction: column; gap: 16px; max-width: 560px; } .auto-field { display: flex; flex-direction: column; gap: 6px; font-size: 13px; color: var(--text-2); } .auto-field.inline { flex-direction: row-reverse; justify-content: flex-end; align-items: center; gap: 10px; } .auto-search { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .auto-form select { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .auto-form textarea { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .auto-search { width: 100%; min-height: 36px; padding: 7px 10px; border: 1px solid var(--line-input); border-radius: 8px; background: var(--bg); color: var(--text); font: inherit; font-size: 13px; } .auto-form input:not([type=checkbox]):not([type=color]):not([type=file]):not(.dtp input) { width: 100%; min-height: 36px; padding: 7px 10px; border: 1px solid var(--line-input); border-radius: 8px; background: var(--bg); color: var(--text); font: inherit; font-size: 13px; } .auto-form select { width: 100%; min-height: 36px; padding: 7px 10px; border: 1px solid var(--line-input); border-radius: 8px; background: var(--bg); color: var(--text); font: inherit; font-size: 13px; } .auto-form textarea { width: 100%; min-height: 36px; padding: 7px 10px; border: 1px solid var(--line-input); border-radius: 8px; background: var(--bg); color: var(--text); font: inherit; font-size: 13px; } .auto-search { max-width: 320px; } .auto-form select { appearance: none; padding-right: 32px; background: var(--bg) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12' fill='none' stroke='%238f8f8f' stroke-width='1.5'%3E%3Cpath d='M3 4.5 6 7.5 9 4.5'/%3E%3C/svg%3E") no-repeat right 11px center; } .auto-form .auto-field.invalid :is(input, select, textarea) { border-color: oklch(0.63 0.2 25); } .auto-error { color: oklch(0.75 0.15 25); font-size: 12px; } .auto-actions { display: flex; align-items: center; gap: 12px; } .auto-saved { font-size: 13px; color: var(--ok); }
Date and time picker
A typed field with the picker beside it, in place of the browser's own pop-up. The month on the left, two time fields and a few common times on the right; the picked day is filled, today is a ring, other months are faint and still. Values are the native inputs' strings (YYYY-MM-DD, HH:MM, YYYY-MM-DDTHH:MM), so nothing that read a date input changes.
.dtp.dtp-field.dtp-zone.dtp-ic.dtp-pop.dtp-cal.dtp-d.today.sel.dtp-time.dtp-hm.dtp-presets.time-only.staticDateTimePicker from @inferencebureau/apps-sdk/react draws it, with kind date, time or datetime, and AutoForm uses it for every dateTime field. The time pane alone (.time-only) is a time field; the month alone is a date field, which closes on the pick.Markup
<form class="auto-form"> <div class="auto-field"> <label for="published-at">Published at</label> <div class="dtp static"> <div class="dtp-field"><input id="published-at" type="text" inputmode="numeric" placeholder="YYYY-MM-DD HH:MM" value="2026-11-13 02:18"><span class="dtp-zone">UTC</span><button class="dtp-ic" type="button" aria-label="Pick a date and time" aria-haspopup="dialog" aria-expanded="true"><svg width="14" height="14" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><rect x="1.5" y="2.5" width="9" height="8" rx="1.5"></rect><path d="M1.5 5h9M4 1.5v2M8 1.5v2" stroke-linecap="round"></path></svg></button></div> <div class="dtp-pop" role="dialog" aria-label="Date and time"> <div class="dtp-cal"> <div class="dtp-head"><span class="dtp-month">November 2026</span><span class="dtp-nav"><button type="button" aria-label="Previous month"><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M7.5 3l-3 3 3 3"></path></svg></button><button type="button" aria-label="Next month"><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M4.5 3l3 3-3 3"></path></svg></button></span></div> <div class="dtp-wd" aria-hidden="true"><span>SU</span><span>MO</span><span>TU</span><span>WE</span><span>TH</span><span>FR</span><span>SA</span></div> <div class="dtp-grid" role="group" aria-label="Days"> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">1</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">2</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">3</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">4</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">5</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">6</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">7</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">8</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">9</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">10</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">11</button> <button class="dtp-d today" type="button" aria-pressed="false" tabindex="-1">12</button> <button class="dtp-d sel" type="button" aria-pressed="true" tabindex="0">13</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">14</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">15</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">16</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">17</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">18</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">19</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">20</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">21</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">22</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">23</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">24</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">25</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">26</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">27</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">28</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">29</button> <button class="dtp-d" type="button" aria-pressed="false" tabindex="-1">30</button> <button class="dtp-d out" type="button" disabled tabindex="-1">1</button> <button class="dtp-d out" type="button" disabled tabindex="-1">2</button> <button class="dtp-d out" type="button" disabled tabindex="-1">3</button> <button class="dtp-d out" type="button" disabled tabindex="-1">4</button> <button class="dtp-d out" type="button" disabled tabindex="-1">5</button> <button class="dtp-d out" type="button" disabled tabindex="-1">6</button> <button class="dtp-d out" type="button" disabled tabindex="-1">7</button> <button class="dtp-d out" type="button" disabled tabindex="-1">8</button> <button class="dtp-d out" type="button" disabled tabindex="-1">9</button> <button class="dtp-d out" type="button" disabled tabindex="-1">10</button> <button class="dtp-d out" type="button" disabled tabindex="-1">11</button> <button class="dtp-d out" type="button" disabled tabindex="-1">12</button> </div> <div class="dtp-foot"><button class="dtp-link" type="button">Clear</button><button class="dtp-link" type="button">Today</button></div> </div> <div class="dtp-time"> <span class="dtp-k">Time · 24-hour</span> <div class="dtp-hm"><input type="text" inputmode="numeric" aria-label="Hour" value="02"><span class="colon" aria-hidden="true">:</span><input type="text" inputmode="numeric" aria-label="Minute" value="18"><span class="dtp-zone">UTC</span></div> <div class="dtp-presets" role="group" aria-label="Common times"> <button type="button"><span>Now</span><span class="t">02:18</span></button> <button type="button"><span>Start of day</span><span class="t">00:00</span></button> <button type="button"><span>Noon</span><span class="t">12:00</span></button> <button type="button"><span>End of day</span><span class="t">23:59</span></button> </div> <div class="dtp-out"><span class="v">Fri, 13 Nov 2026 · 02:18 UTC</span><button class="dtp-done" type="button">Done</button></div> </div> </div> </div> </div> </form>
CSS
.dtp-field { display: flex; align-items: center; min-height: 36px; padding: 0 4px 0 10px; gap: 6px; border: 1px solid var(--line-input); border-radius: 8px; background: var(--bg); } .dtp-field:focus-within { border-color: var(--text-2); } .dtp-field input { flex: 1; min-width: 0; width: auto; height: 100%; border: 0; background: transparent; padding: 0; font: 13px var(--mono); font-variant-numeric: tabular-nums; color: var(--text); outline: none; } .dtp-pop { position: absolute; z-index: 30; top: calc(100% + 4px); left: 0; display: flex; background: var(--raised); border: 1px solid var(--line-input); border-radius: 12px; box-shadow: 0 12px 32px rgb(0 0 0 / 0.5); } @media (max-width: 600px) { .dtp-pop { flex-direction: column; } } .dtp-cal { width: 296px; padding: 16px; display: flex; flex-direction: column; gap: 8px; } .dtp-d { width: 36px; height: 36px; border: 1px solid transparent; border-radius: 8px; color: var(--text-2); font-size: 13px; font-variant-numeric: tabular-nums; } .dtp-d:hover { background: var(--hover); color: var(--text); } .dtp-d.today { border-color: #3a3a3a; color: var(--text); } .dtp-d.sel { background: var(--text); color: var(--bg); border-color: var(--text); font-weight: 500; } .dtp-d.sel:hover { background: var(--text); color: var(--bg); border-color: var(--text); font-weight: 500; } .dtp-d.out { background: transparent; color: #4d4d4d; cursor: default; } .dtp-d:disabled { background: transparent; color: #4d4d4d; cursor: default; } .dtp-d:disabled:hover { background: transparent; color: #4d4d4d; cursor: default; } .dtp-time { border-left: 1px solid var(--line); padding: 16px; display: flex; flex-direction: column; gap: 12px; min-width: 220px; } @media (max-width: 600px) { .dtp-time { border-left: 0; border-top: 1px solid var(--line); } } .dtp-hm input { width: 56px; height: 36px; padding: 0; text-align: center; background: var(--bg); border: 1px solid var(--line-input); border-radius: 8px; font: 14px var(--mono); font-variant-numeric: tabular-nums; color: var(--text); outline: none; } .dtp-presets button { width: 100%; height: 32px; padding: 0 10px; border-radius: 6px; color: var(--text-2); font-size: 13px; display: flex; align-items: center; justify-content: space-between; gap: 12px; } .dtp-presets button[aria-pressed=true] { background: #1f1f1f; color: var(--text); }
Keep the field typeable and the picker a shortcut beside it; label the zone when the value is UTC.
Don't tint the picked day a color or add spinner arrows to the time fields; the look is monochrome and still.
Tables
AutoTable's shape: a toolbar with search and a count, light-weight muted headers, 48px rows, numbers right-aligned and tabular, tags for lists, mono for ids, a pager at the foot. The sorted column's header is brighter.
.auto-table.auto-toolbar.num.auto-tag.auto-mono.auto-pagerDrawn by AutoTable from @inferencebureau/apps-sdk/react; the same classes by hand for a table of your own.Markup
<div class="auto-table"> <div class="auto-toolbar"><input class="auto-search" type="search" placeholder="Search posts" aria-label="Search posts"><span class="auto-count">24 posts</span><button class="btn primary sm" type="button">New post</button></div> <div class="auto-scroll"> <table> <thead><tr><th class="auto-check"><input type="checkbox" aria-label="Select all"></th><th>Title</th><th aria-sort="descending">Views ↓</th><th>Status</th><th>Author</th><th class="num">Comments</th><th>Id</th></tr></thead> <tbody> <tr class="clickable"><td class="auto-check"><input type="checkbox" aria-label="Select row"></td><td>Welcome to inferencebureau</td><td class="num">1,204</td><td><span class="auto-tags"><span class="auto-tag on">published</span><span class="auto-tag">featured</span></span></td><td>jay@inferencebureau.app</td><td class="num">12</td><td><span class="auto-mono">post_8f2a</span></td></tr> <tr class="clickable selected"><td class="auto-check"><input type="checkbox" checked aria-label="Select row"></td><td>What we shipped this week</td><td class="num">418</td><td><span class="auto-tags"><span class="auto-tag">draft</span></span></td><td>ops@inferencebureau.app</td><td class="num">3</td><td><span class="auto-mono">post_8f29</span></td></tr> <tr class="clickable"><td class="auto-check"><input type="checkbox" aria-label="Select row"></td><td>Pricing from 1 December</td><td class="num">0</td><td><span class="auto-tags"><span class="auto-tag">scheduled</span></span></td><td><span class="auto-empty">—</span></td><td class="num">0</td><td><span class="auto-mono">post_8f21</span></td></tr> </tbody> </table> </div> <div class="auto-pager"><span>1–3 of 24</span><button class="btn ghost sm" type="button" disabled>Previous</button><button class="btn ghost sm" type="button">Next</button></div> </div>
CSS
.auto-table { display: flex; flex-direction: column; border: 1px solid var(--line); border-radius: 12px; background: var(--raised); overflow: hidden; } .auto-toolbar { min-height: 52px; display: flex; align-items: center; gap: 10px; padding: 10px 12px; border-bottom: 1px solid var(--line); } .auto-table th { height: 40px; padding: 0 14px; text-align: left; font-weight: 400; color: var(--muted); white-space: nowrap; border-bottom: 1px solid var(--line); } .auto-table td { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .auto-table td { height: 48px; padding: 8px 14px; border-bottom: 1px solid var(--line); vertical-align: middle; } .auto-table tr.clickable:hover td { background: var(--hover); } .auto-table tr.selected td { background: var(--hover); } .auto-table .num { text-align: right; font-variant-numeric: tabular-nums; } .auto-tag { display: inline-flex; align-items: center; height: 22px; padding: 0 8px; border-radius: 6px; background: var(--hover); color: var(--text-2); font-size: 12px; } .auto-tag.on { background: var(--ok-bg); color: var(--ok); } .auto-mono { font-family: var(--mono); font-size: 12px; color: var(--text-2); } .auto-pager { display: flex; align-items: center; justify-content: flex-end; gap: 10px; padding: 10px 12px; border-top: 1px solid var(--line); font-size: 13px; color: var(--muted); }
Empty state
What a list shows before it has anything in it: a dashed box, a bordered icon tile, a title that names the thing, one line on how it gets there, and the same primary action the full page has. Inside AutoTable the built-in .auto-none row says the same in one line.
.empty-state.auto-noneMarkup
<div class="empty-state"> <i><svg width="16" height="16" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M2 2.5h8M2 5h8M2 7.5h5M2 10h6"></path></svg></i> <strong>No posts yet</strong> <p>Posts you write appear here. The first one is usually a welcome.</p> <button class="btn primary sm" type="button">New post</button> </div>
CSS
.empty-state { border: 1px dashed var(--line-input); border-radius: 12px; padding: 40px 24px; display: flex; flex-direction: column; align-items: center; text-align: center; gap: 10px; } .empty-state i { width: 36px; height: 36px; border-radius: 10px; background: var(--raised); border: 1px solid var(--line-input); display: inline-flex; align-items: center; justify-content: center; color: var(--text-2); margin-bottom: 4px; } .empty-state strong { font-weight: 500; } .empty-state p { font-size: 13px; color: var(--muted); max-width: 360px; } .empty-state .btn { margin-top: 8px; } .auto-none td { height: 96px; text-align: center; color: var(--muted); }
Terminal
A window on the darkest surface with a 36px head. Lines are 24px apart in 12.5px mono. The gutter holds one glyph: a prompt, a green dot for a live state, or a blue arrow for a sync.
.term.term-head.line.g.hi.dotMarkup
<div class="term" aria-label="Terminal"> <div class="term-head"><svg width="13" height="13" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.2" aria-hidden="true"><rect x="1.2" y="2" width="9.6" height="8" rx="1"></rect><path d="M3.2 4.6l1.6 1.4-1.6 1.4M6 7.6h2.6"></path></svg>Terminal</div> <div class="term-body"> <div class="line"><span class="g faint">$</span><span class="hi">ib-apps dev</span></div> <div class="line"><span class="g"><span class="dot"></span></span><span>synced with development</span></div> <div class="line"><span class="g"></span><span class="faint">watching ./ for changes</span></div> <div class="line"><span class="g info"><svg width="10" height="10" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="M6 10V2M2.5 5.5L6 2l3.5 3.5" stroke-linecap="round" stroke-linejoin="round"></path></svg></span><span>web/app/page.tsx</span><span class="faint">· live</span></div> </div> </div>
CSS
.term { flex: 1 1 300px; min-width: 0; border: 1px solid var(--line); border-radius: 12px; background: var(--side); overflow: hidden; } .term-head { height: 36px; border-bottom: 1px solid var(--line); display: flex; align-items: center; gap: 8px; padding: 0 12px; font: 12px var(--mono); color: var(--muted); } .term-body { padding: 16px 18px; font: 12.5px/24px var(--mono); color: var(--text-2); } .line { display: flex; align-items: center; gap: 10px; } .line .g { width: 14px; flex: none; display: inline-flex; justify-content: center; } .line .hi { color: var(--text); } .line .info { color: var(--info); } .dot { width: 6px; height: 6px; border-radius: 999px; background: var(--ok); }
Numbered list
Steps or next moves: a faint two-digit mono number, a bold title and a muted mono file name that wraps under the title on a phone. Rows are 56px and divided by lines inside one rounded box.
.next.num.titleMarkup
<div class="next"> <h2>Where to go next</h2> <ol> <li><span class="num">01</span><span class="title">Give users their own fields</span><code>api/models/user/schema.ib.ts</code></li> <li><span class="num">02</span><span class="title">Shape what people see</span><code>web/app/page.tsx</code></li> <li><span class="num">03</span><span class="title">Decide who can read and write what</span><code>accessControl/permissions.ib.ts</code></li> <li><span class="num">04</span><span class="title">Ship it to production</span><code>ib-apps deploy</code></li> </ol> </div>
CSS
.next { display: flex; flex-direction: column; gap: 14px; } .next h2 { font-size: 15px; font-weight: 500; } .next ol { list-style: none; margin: 0; padding: 0; border: 1px solid var(--line); border-radius: 12px; overflow: hidden; } .next li { display: flex; flex-wrap: wrap; align-items: center; gap: 6px 16px; min-height: 56px; padding: 12px 18px; } .next li + li { border-top: 1px solid var(--line); } .next .num { width: 20px; font: 12px var(--mono); color: var(--faint); } .next .title { flex: 1 1 220px; font-weight: 500; } .next code { min-width: 0; font-size: 12.5px; color: var(--muted); overflow-wrap: anywhere; }
Notes and banners
Three ways to say something aside. A note is plain secondary text with underlined links. A preview is dashed, for things that would happen in production. The error banner is the one filled surface in the system.
.note.preview.auto-bannerMarkup
<div class="note"><span>Check your inbox. The link signs you in on this device and expires in 15 minutes. <a href="/sign-in">Send it again</a></span></div> <div class="preview">In development, email is not sent. This is what production would send to <a href="/account">jay@inferencebureau.app</a>.</div> <div class="auto-banner">The record couldn't be saved: price must be zero or more.</div>
CSS
.note { display: flex; flex-direction: column; gap: 10px; font-size: 14px; color: var(--text-2); } .note a { color: var(--text); text-decoration: underline; text-underline-offset: 3px; } .preview a { color: var(--text); text-decoration: underline; text-underline-offset: 3px; } .preview { font-size: 13px; color: var(--muted); border: 1px dashed var(--line-input); border-radius: 9px; padding: 10px 12px; } .auto-banner { padding: 10px 14px; border-radius: 9px; background: oklch(0.63 0.2 25 / 0.14); color: oklch(0.8 0.12 25); font-size: 13px; }
Header and footer
The app's frame: a 56px header on the darkest surface with the mark in a bordered tile, the app's name, its environment and one small ghost button pushed right. The footer credits the host and names the config file.
.shell.wrap.top.mark.name.foot.brandMarkup
<div class="shell"> <header class="top"> <div class="wrap top-row"> <span class="mark"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5.203 8.6A7.6 7.6 0 0 1 18.797 8.6ZM5.203 15.4A7.6 7.6 0 0 0 18.797 15.4ZM0 10.4H24V13.6H0Z" transform="rotate(-24 12 12)" /></svg></span> <span class="name">inferencebureau</span> <span class="env development"><i><svg width="10" height="10" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><circle cx="3.5" cy="2.8" r="1.3"></circle><circle cx="3.5" cy="9.2" r="1.3"></circle><circle cx="8.5" cy="4.6" r="1.3"></circle><path d="M3.5 4.1v3.8M8.5 5.9c0 1.6-1.4 2-3.4 2.4"></path></svg></i>development</span> <a class="btn ghost sm" href="https://inferencebureau.com/app" target="_blank" rel="noreferrer">Open in Inference Bureau<svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M4.5 2.5h5v5M9.5 2.5L3 9"></path></svg></a> </div> </header> <main class="wrap main page"></main> <footer class="foot"> <div class="wrap foot-row"> <span>Built and hosted by <span class="brand"><svg width="15" height="15" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5.203 8.6A7.6 7.6 0 0 1 18.797 8.6ZM5.203 15.4A7.6 7.6 0 0 0 18.797 15.4ZM0 10.4H24V13.6H0Z" transform="rotate(-24 12 12)" /></svg>inference bureau</span></span> <code class="faint">settings.ib.ts · built-in config</code> </div> </footer> </div>
CSS
.shell { min-height: 100vh; display: flex; flex-direction: column; } .wrap { width: 100%; max-width: 1040px; margin: 0 auto; padding: 0 24px; } .top { background: var(--side); border-bottom: 1px solid var(--line); } .top-row { height: 56px; display: flex; align-items: center; gap: 12px; } .mark { width: 28px; height: 28px; flex: none; border-radius: 8px; background: var(--raised); border: 1px solid var(--line-input); display: inline-flex; align-items: center; justify-content: center; } .name { font-weight: 500; font-size: 15px; letter-spacing: -0.01em; } .top .btn { margin-left: auto; } @media (max-width: 640px) { .top .btn { display: none; } } .foot { border-top: 1px solid var(--line); } .foot-row { padding-top: 18px; padding-bottom: 18px; display: flex; flex-wrap: wrap; align-items: center; gap: 8px 16px; font-size: 13px; color: var(--muted); } .foot-row > span { display: inline-flex; align-items: center; gap: 8px; } .brand { display: inline-flex; align-items: center; gap: 6px; color: var(--text); font-weight: 500; letter-spacing: -0.035em; }
States
Every control has four states and they are all quiet: hover brightens, focus draws a 2px ring in the secondary text color, disabled fades to 60%, busy fades a whole table body. There is no pressed style. A change eases over 120ms on color and border, 200ms on opacity.
:hover:focus-visible:disabledtr.clickabletr.selected[aria-busy=true]CSS
.btn.primary:hover { background: #ffffff; } .btn.ghost:hover { color: var(--text); border-color: #3a3a3a; } :focus-visible { outline: 2px solid var(--text-2); outline-offset: 2px; } .btn:disabled { opacity: 0.6; cursor: default; } .auto-search:focus { outline: none; border-color: var(--text-2); } .auto-form :is(input, select, textarea):focus { outline: none; border-color: var(--text-2); } .auto-table tr.clickable:hover td { background: var(--hover); } .auto-table tr.selected td { background: var(--hover); } .auto-table table[aria-busy=true] tbody { opacity: 0.6; } .btn { display: inline-flex; align-items: center; gap: 8px; height: 44px; padding: 0 18px; border-radius: 9px; font-weight: 500; } .btn { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .auto-search { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .auto-form input { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .auto-form select { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .auto-form textarea { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .auto-table td { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .auto-table tbody { transition: color .12s, border-color .12s, background-color .12s, opacity .2s; } .auto-search { width: 100%; min-height: 36px; padding: 7px 10px; border: 1px solid var(--line-input); border-radius: 8px; background: var(--bg); color: var(--text); font: inherit; font-size: 13px; } .auto-form select { width: 100%; min-height: 36px; padding: 7px 10px; border: 1px solid var(--line-input); border-radius: 8px; background: var(--bg); color: var(--text); font: inherit; font-size: 13px; } .auto-form textarea { width: 100%; min-height: 36px; padding: 7px 10px; border: 1px solid var(--line-input); border-radius: 8px; background: var(--bg); color: var(--text); font: inherit; font-size: 13px; } .auto-search { max-width: 320px; } .auto-form select { appearance: none; padding-right: 32px; background: var(--bg) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12' fill='none' stroke='%238f8f8f' stroke-width='1.5'%3E%3Cpath d='M3 4.5 6 7.5 9 4.5'/%3E%3C/svg%3E") no-repeat right 11px center; } .auto-table td { height: 48px; padding: 8px 14px; border-bottom: 1px solid var(--line); vertical-align: middle; }
Changes of state, live
Press Save to watch the button go through Saving and come back with a Saved mark that fades after a moment. Press Reload to see a busy table. Click a row to select it.
Change one property per state: a shade on hover, a border on focus, opacity when disabled or busy. Say what is happening in words: Saving, Saved, Reloading.
Scale, bounce, spin or slide on hover. No spinners where words would do: a busy table fades, a busy button reads Saving.
Loading and motion
Two kinds of motion: waiting and arriving. Waiting is a repeated, quiet motion in the muted greys, or in the assistant's purple when the assistant is the one working. Arriving is one short ease, 160 to 420ms, from slightly below or slightly small. Never both at once, never a spinner where words would do.
--ai.sk.ar-typing.as-pulse.as-spin.as-bar.as-caret.as-in.as-tileMarkup
<!-- Skeleton --> <div class="sk-stack"><span class="sk" style="width: 70%"></span><span class="sk" style="width: 45%"></span><span class="sk" style="width: 85%"></span></div> <!-- Typing --> <div class="ar-typing" aria-label="Writing"><span></span><span></span><span></span></div> <!-- Thinking --> <div class="as-thinking"><span class="as-pulse" aria-hidden="true"></span><span>Reading your schema</span><span class="as-elapsed">0:12</span></div> <!-- Working --> <span class="as-spin" aria-hidden="true"></span><span>Running <code>signUp</code> in development</span> <!-- Pill at work --> <div class="as-pill" data-tone="work"><span class="t live">Adding a comments model</span><span class="as-bar" aria-hidden="true"></span></div> <!-- Streaming --> <span>The signUp action saves each person as a<span class="as-caret" aria-hidden="true"></span></span> <!-- Live --> <span class="ar-dot live" aria-hidden="true"></span><span>development <span class="faint">· live</span></span> <!-- Busy table --> <div class="auto-table"><table aria-busy="true"><tbody><tr><td>Welcome to inferencebureau</td></tr></tbody></table></div> <!-- Rise --> <div class="as-in"><span class="as-tile ok"><svg width="10" height="10" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="M2.5 6.2l2.3 2.3 4.7-5" stroke-linecap="round" stroke-linejoin="round"></path></svg></span><span>Added the comments model</span></div> <!-- Pop --> <span class="as-tile ok"><svg width="10" height="10" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><path d="M2.5 6.2l2.3 2.3 4.7-5" stroke-linecap="round" stroke-linejoin="round"></path></svg></span><span>A state tile when a step finishes</span> <!-- Nudge --> <div class="as-pill" data-tone="need"><span>Where do comments belong?</span></div> <!-- Send --> <div class="as-me sending">Add a comments model</div>
CSS
.sk { display: block; height: 10px; border-radius: 4px; background: linear-gradient(90deg, #1a1a1a, #262626, #1a1a1a); background-size: 200% 100%; animation: ops-shim 1.2s linear infinite; } @media (prefers-reduced-motion: reduce) { .sk { animation: none; transition: none; } } @keyframes ops-shim { to { background-position: -200% 0; } } .sk-stack { display: flex; flex-direction: column; gap: 10px; width: 100%; } .ar-typing { display: flex; gap: 4px; padding: 6px 0; } .ar-typing span { width: 6px; height: 6px; border-radius: 50%; background: var(--faint); animation: ar-bounce 1.2s infinite; } @media (prefers-reduced-motion: reduce) { .ar-typing span { animation: none; transition: none; } } .ar-typing span:nth-child(2) { animation-delay: .2s; } .ar-typing span:nth-child(3) { animation-delay: .4s; } @keyframes ar-bounce { 0%, 60%, 100% { transform: translateY(0); opacity: .5; } 30% { transform: translateY(-4px); opacity: 1; } } .as-thinking { display: flex; align-items: center; gap: 10px; font-size: 13px; color: var(--text-2); } .as-pulse { width: 8px; height: 8px; border-radius: 9px; background: var(--ai); flex: none; animation: as-ping 1.4s ease-out infinite; } @media (prefers-reduced-motion: reduce) { .as-pulse { animation: none; transition: none; } } .as-elapsed { margin-left: auto; font: 12px var(--mono); color: var(--muted); font-variant-numeric: tabular-nums; } @keyframes as-ping { 0% { box-shadow: 0 0 0 0 oklch(0.78 0.12 300 / 0.55); } 100% { box-shadow: 0 0 0 7px oklch(0.78 0.12 300 / 0); } } .as-spin { width: 13px; height: 13px; flex: none; border-radius: 99px; border: 1.5px solid var(--ai); border-right-color: transparent; animation: as-spin .9s linear infinite; } @media (prefers-reduced-motion: reduce) { .as-spin { animation: none; transition: none; } } @keyframes as-spin { to { transform: rotate(360deg); } } .as-pill { position: relative; width: 100%; max-width: 560px; height: 36px; border: 1px solid var(--line-input); background: var(--raised); border-radius: 8px; display: flex; align-items: center; padding: 0 12px; overflow: hidden; font-size: 13.5px; transition: border-color .32s ease, background-color .32s ease; } @media (prefers-reduced-motion: reduce) { .as-pill { animation: none; transition: none; } } .as-pill > span { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; } .as-pill[data-tone=work] { border-color: oklch(0.78 0.12 300 / 0.45); background: oklch(0.78 0.12 300 / 0.08); } .as-pill[data-tone=need] { border-color: oklch(0.8 0.14 80 / 0.55); background: oklch(0.8 0.14 80 / 0.07); animation: as-nudge .5s ease; } .as-bar { position: absolute; left: 0; bottom: 0; height: 2px; width: 30%; border-radius: 2px; background: var(--ai); animation: as-slide 1.6s cubic-bezier(.4,0,.2,1) infinite; } @media (prefers-reduced-motion: reduce) { .as-bar { animation: none; transition: none; } } @keyframes as-slide { 0% { left: -30%; } 100% { left: 100%; } } @keyframes as-nudge { 0%, 100% { transform: none; } 30% { transform: scale(1.03); } 60% { transform: scale(.995); } } .t.live { background: linear-gradient(90deg, var(--muted) 40%, var(--text) 50%, var(--muted) 60%) 0 0 / 200% 100%; -webkit-background-clip: text; background-clip: text; color: transparent; animation: as-shimmer 2.2s linear infinite; font-weight: 500; } @media (prefers-reduced-motion: reduce) { .t.live { animation: none; transition: none; } } @media (prefers-reduced-motion: reduce) { .t.live { background: none; color: var(--text-2); } } @keyframes as-shimmer { from { background-position: 200% 0; } to { background-position: -200% 0; } } .as-caret { display: inline-block; width: 7px; height: 15px; margin-left: 2px; vertical-align: -2px; background: var(--ai); animation: as-caret 1s steps(1) infinite; } @media (prefers-reduced-motion: reduce) { .as-caret { animation: none; transition: none; } } @keyframes as-caret { 0%, 49% { opacity: 1; } 50%, 100% { opacity: 0; } } .ar-dot { width: 8px; height: 8px; border-radius: 99px; background: var(--faint); flex: none; display: inline-block; vertical-align: middle; margin-right: 8px; } .ar-dot.live { background: var(--warn); animation: ar-pulse 1.6s ease-out infinite; } @media (prefers-reduced-motion: reduce) { .ar-dot.live { animation: none; transition: none; } } @keyframes ar-pulse { 0% { box-shadow: 0 0 0 0 oklch(0.8 0.14 80 / 0.45); } 100% { box-shadow: 0 0 0 8px oklch(0.8 0.14 80 / 0); } } .as-in { display: flex; align-items: center; gap: 10px; animation: as-rise .28s cubic-bezier(.2,.8,.2,1) both; } @media (prefers-reduced-motion: reduce) { .as-in { animation: none; transition: none; } } @keyframes as-rise { from { opacity: 0; transform: translateY(6px); } to { opacity: 1; transform: none; } } .as-tile { width: 16px; height: 16px; border-radius: 4px; display: inline-flex; align-items: center; justify-content: center; flex: none; animation: as-pop .42s cubic-bezier(.3,1.4,.5,1) both; } @media (prefers-reduced-motion: reduce) { .as-tile { animation: none; transition: none; } } .as-tile.ok { background: var(--ok-bg); color: var(--ok); } @keyframes as-pop { 0% { opacity: 0; transform: scale(.4); } 70% { transform: scale(1.18); } 100% { opacity: 1; transform: scale(1); } } .as-me { align-self: flex-end; max-width: 88%; background: var(--hover); border: 1px solid var(--line-input); border-radius: 10px 10px 2px 10px; padding: 9px 12px; font-size: 13.5px; line-height: 1.5; } .as-me.sending { opacity: .75; animation: as-send-in .16s ease-out; } @media (prefers-reduced-motion: reduce) { .as-me.sending { animation: none; transition: none; } } @keyframes as-send-in { from { transform: translateY(6px); opacity: 0; } }
Pick by who is waiting for whom. A skeleton while the page loads, a shimmer or spinner while a job runs, the purple pulse and caret only when the assistant is thinking or writing. Always say what is happening next to it.
Run two waiting motions in view at once, animate on hover, or let anything arrive from further than 24px away. Every rule here turns off under prefers-reduced-motion.
How the pieces go together
Four shapes cover almost every page in an app. Each one is the header, a page head and one main block, 24px apart, in the .wrap column of 1040px that the home page already uses. Start from the one that fits and change the words.
List page
One model, many records. The page head names the model in the plural with the count under it and the one primary action on the right. The table carries search, sort and paging. Empty, it shows the empty state instead of the table.
.shell.wrap.main.page.page-head.auto-table.empty-stateMarkup
<div class="shell"> <header class="top"> <div class="wrap top-row"> <span class="mark"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5.203 8.6A7.6 7.6 0 0 1 18.797 8.6ZM5.203 15.4A7.6 7.6 0 0 0 18.797 15.4ZM0 10.4H24V13.6H0Z" transform="rotate(-24 12 12)" /></svg></span> <span class="name">inferencebureau</span> <span class="env development"><i><svg width="10" height="10" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><circle cx="3.5" cy="2.8" r="1.3"></circle><circle cx="3.5" cy="9.2" r="1.3"></circle><circle cx="8.5" cy="4.6" r="1.3"></circle><path d="M3.5 4.1v3.8M8.5 5.9c0 1.6-1.4 2-3.4 2.4"></path></svg></i>development</span> <span class="who"><span class="who-email">jay@inferencebureau.app</span><button class="btn ghost sm" type="button">Sign out</button></span> </div> </header> <main class="wrap main page"> <div class="page-head"><div class="row"><h1>Posts</h1><a class="btn primary sm" href="/posts/new">New post</a></div><span class="sub">24 posts, 3 drafts</span></div> <div class="auto-table"> <div class="auto-toolbar"><input class="auto-search" type="search" placeholder="Search posts" aria-label="Search posts"><span class="auto-count">24 posts</span></div> <div class="auto-scroll"><table> <thead><tr><th>Title</th><th aria-sort="descending">Published ↓</th><th>Status</th><th class="num">Views</th></tr></thead> <tbody> <tr class="clickable"><td>Welcome to inferencebureau</td><td>8 Nov 2026</td><td><span class="auto-tags"><span class="auto-tag on">published</span></span></td><td class="num">1,204</td></tr> <tr class="clickable"><td>What we shipped this week</td><td><span class="auto-empty">—</span></td><td><span class="auto-tags"><span class="auto-tag">draft</span></span></td><td class="num">418</td></tr> <tr class="clickable"><td>Pricing from 1 December</td><td>1 Dec 2026</td><td><span class="auto-tags"><span class="auto-tag">scheduled</span></span></td><td class="num">0</td></tr> </tbody> </table></div> <div class="auto-pager"><span>1–3 of 24</span><button class="btn ghost sm" type="button" disabled>Previous</button><button class="btn ghost sm" type="button">Next</button></div> </div> </main> </div>
CSS
.main.page { padding-top: 28px; padding-bottom: 36px; gap: 24px; } .page-head { display: flex; flex-direction: column; gap: 8px; } .page-head .row { display: flex; flex-wrap: wrap; align-items: center; gap: 12px; } .page-head h1 { font-size: 28px; line-height: 1.15; font-weight: 600; letter-spacing: -0.025em; } .page-head .row > .btn { margin-left: auto; } .page-head .row > .actions { margin-left: auto; } .page-head .sub { font-size: 14px; color: var(--text-2); }
Record page
One record. A crumb back to its list, the record's own name as the title with its state beside it, Edit and Delete on the right, then the fact list. Anything that belongs to the record, like its comments, follows as its own small section.
.crumbs.page-head.actions.badge.facts.sub-sectionMarkup
<div class="shell"> <header class="top"> <div class="wrap top-row"> <span class="mark"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5.203 8.6A7.6 7.6 0 0 1 18.797 8.6ZM5.203 15.4A7.6 7.6 0 0 0 18.797 15.4ZM0 10.4H24V13.6H0Z" transform="rotate(-24 12 12)" /></svg></span> <span class="name">inferencebureau</span> <span class="env development"><i><svg width="10" height="10" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><circle cx="3.5" cy="2.8" r="1.3"></circle><circle cx="3.5" cy="9.2" r="1.3"></circle><circle cx="8.5" cy="4.6" r="1.3"></circle><path d="M3.5 4.1v3.8M8.5 5.9c0 1.6-1.4 2-3.4 2.4"></path></svg></i>development</span> <span class="who"><span class="who-email">jay@inferencebureau.app</span><button class="btn ghost sm" type="button">Sign out</button></span> </div> </header> <main class="wrap main page"> <nav class="crumbs" aria-label="Breadcrumb"><a href="/posts">Posts</a><span>/</span><span>Welcome to inferencebureau</span></nav> <div class="page-head"><div class="row"><h1>Welcome to inferencebureau</h1><span class="badge ok"><i><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M2.5 6.2l2.3 2.3 4.7-5" stroke-linecap="round" stroke-linejoin="round"></path></svg></i>Published</span><span class="actions"><a class="btn ghost sm" href="/posts/post_8f2a/edit">Edit</a><button class="btn ghost sm" type="button">Delete</button></span></div></div> <dl class="facts"> <dt>Author</dt><dd>jay@inferencebureau.app</dd> <dt>Published</dt><dd>8 Nov 2026, 09:14</dd> <dt>Slug</dt><dd><code>welcome-to-inferencebureau</code></dd> <dt>Views</dt><dd>1,204</dd> </dl> <section class="sub-section"><h2>Comments <span class="faint">3</span></h2> <div class="auto-table"><table><tbody> <tr><td>Great first post.</td><td class="auto-mono">ops@inferencebureau.app</td><td class="num">8 Nov</td></tr> <tr><td>Looking forward to the pricing one.</td><td class="auto-mono">team@inferencebureau.app</td><td class="num">8 Nov</td></tr> </tbody></table></div> </section> </main> </div>
CSS
.crumbs { font-size: 13px; color: var(--muted); display: flex; gap: 8px; } .crumbs a { color: var(--text-2); } .page-head .actions { display: inline-flex; gap: 8px; padding: 0; } .sub-section { display: flex; flex-direction: column; gap: 12px; } .sub-section h2 { font-size: 15px; font-weight: 500; display: flex; gap: 8px; align-items: baseline; }
Form page
Creating or editing one record. The title says which, the form is AutoForm or the same classes by hand, 560px at most, and the actions sit under the last field: Save as the primary, Cancel as a ghost, and the Saved mark after a save.
.crumbs.page-head.auto-form.auto-actionsMarkup
<div class="shell"> <header class="top"> <div class="wrap top-row"> <span class="mark"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5.203 8.6A7.6 7.6 0 0 1 18.797 8.6ZM5.203 15.4A7.6 7.6 0 0 0 18.797 15.4ZM0 10.4H24V13.6H0Z" transform="rotate(-24 12 12)" /></svg></span> <span class="name">inferencebureau</span> <span class="env development"><i><svg width="10" height="10" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><circle cx="3.5" cy="2.8" r="1.3"></circle><circle cx="3.5" cy="9.2" r="1.3"></circle><circle cx="8.5" cy="4.6" r="1.3"></circle><path d="M3.5 4.1v3.8M8.5 5.9c0 1.6-1.4 2-3.4 2.4"></path></svg></i>development</span> <span class="who"><span class="who-email">jay@inferencebureau.app</span><button class="btn ghost sm" type="button">Sign out</button></span> </div> </header> <main class="wrap main page"> <nav class="crumbs" aria-label="Breadcrumb"><a href="/posts">Posts</a><span>/</span><span>New post</span></nav> <div class="page-head"><div class="row"><h1>New post</h1></div></div> <form class="auto-form"> <label class="auto-field">Title <span class="auto-required">required</span><input type="text" placeholder="What this post is about"></label> <label class="auto-field">Slug<input type="text" placeholder="made-from-the-title"></label> <label class="auto-field">Body<textarea placeholder="Write in Markdown"></textarea></label> <label class="auto-field">Status<select><option>Draft</option><option>Published</option><option>Scheduled</option></select></label> <label class="auto-field inline">Feature on the home page<input type="checkbox"></label> <div class="auto-actions"><button class="btn primary sm" type="submit">Save</button><a class="btn ghost sm" href="/posts">Cancel</a></div> </form> </main> </div>
CSS
.auto-form { display: flex; flex-direction: column; gap: 16px; max-width: 560px; } .auto-field { display: flex; flex-direction: column; gap: 6px; font-size: 13px; color: var(--text-2); } .auto-actions { display: flex; align-items: center; gap: 12px; }
Settings page
Things set once. Each setting is a card with a title, a badge for its state and one action on the right, stacked 16px apart. Anything destructive goes last, in its own card, with the danger button.
.page-head.sections.card.badge.btn.dangerMarkup
<div class="shell"> <header class="top"> <div class="wrap top-row"> <span class="mark"><svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M5.203 8.6A7.6 7.6 0 0 1 18.797 8.6ZM5.203 15.4A7.6 7.6 0 0 0 18.797 15.4ZM0 10.4H24V13.6H0Z" transform="rotate(-24 12 12)" /></svg></span> <span class="name">inferencebureau</span> <span class="env production"><i><svg width="10" height="10" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><circle cx="6" cy="6" r="4.5"></circle><path d="M1.5 6h9M6 1.5c1.5 1.4 1.5 7.6 0 9M6 1.5c-1.5 1.4-1.5 7.6 0 9"></path></svg></i>production</span> <span class="who"><span class="who-email">jay@inferencebureau.app</span><button class="btn ghost sm" type="button">Sign out</button></span> </div> </header> <main class="wrap main page"> <div class="page-head"><div class="row"><h1>Settings</h1></div></div> <div class="sections"> <div class="card"><div class="row"><strong>Email</strong><span class="badge warn"><i><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M6 2.5v4M6 9v.5" stroke-linecap="round"></path></svg></i>Not connected</span><a class="btn ghost sm" href="/settings/email">Connect Resend</a></div><p>Sign-up confirmations and password resets go out through your own Resend account.</p></div> <div class="card"><div class="row"><strong>Domain</strong><span class="badge ok"><i><svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="M2.5 6.2l2.3 2.3 4.7-5" stroke-linecap="round" stroke-linejoin="round"></path></svg></i>Live</span><a class="btn ghost sm" href="/settings/domain">Change</a></div><p>Serving at <code>inferencebureau.app</code>. Certificates renew on their own.</p></div> <div class="card"><div class="row"><strong>Delete this app</strong><button class="btn danger sm" type="button">Delete app</button></div><p>Removes every record, file and environment. There is no undo.</p></div> </div> </main> </div>
CSS
.sections { display: flex; flex-direction: column; gap: 16px; } .card .row { display: flex; flex-wrap: wrap; align-items: center; gap: 12px; } .card .row > .btn { margin-left: auto; }
Name a page after its records: Posts, then Welcome to inferencebureau, then New post. One main block per page. When a page needs two, it is two pages.
Add a sidebar, tabs or a dashboard of tiles. Apps on this look are a header and a column. Navigation is the crumb and the header's links.
The rules
What the look-and-feel skill tells an agent, in one list. The skill holds every specimen above as markup; read it in any app at .agents/skills/look-and-feel/SKILL.md, and see Getting started for how agents find it.
- Dark only: the surfaces, lines and text come from the variables in web/app/globals.css. Never write a hex color in a page; add a variable if one is missing.
- One primary button per view, ghost for the rest, danger only for deleting. A button is the text color inverted: no brand color, gradient or shadow.
- A state is a badge: a tinted icon tile plus words in an outlined box. Never a colored pill, a tinted card, a left-border stripe or colored text alone. The error banner is the only filled surface.
- Containers round at 12px, controls at 9px, small things at 8px and under. Heights are 56, 44, 36, 32 and 22.
- Geist for words, Geist Mono for anything a machine wrote: file names, ids, counts, eyebrows, commands.
- Icons are inline SVG on a 12-unit grid with a 1.3 stroke in currentColor, aria-hidden. No icon font, no fills, no emoji.
- A page is the header, a page head and one main block, 24px apart, in the .wrap column. Name it after its records. When a page needs two main blocks, it is two pages. No sidebars, tabs or tile dashboards.
- A list page shows the empty state instead of the table when it has nothing. Every list page has one.
- State changes are quiet: hover brightens, focus is a 2px ring in --text-2, disabled and busy fade to 60%. There is no pressed style. Transitions are 120ms on color and border, 200ms on opacity.
- Waiting is one repeated motion at a time, in grey, or in --ai only when the assistant works, always beside words saying what is happening. Arriving is one short ease, 160 to 420ms, from no further than 24px. Nothing spins, bounces or slides on hover, and every animation turns off under prefers-reduced-motion.
- Example names and addresses use inferencebureau: jay@inferencebureau.app, inferencebureau.app, Welcome to inferencebureau.