Skip to content

Brand kit

The mark, the name, the colors and the type that the public site and the console share. Every color, type sample and component on this page is drawn from the style sheet the product uses, so this page always matches it.

Use these files to refer to Homework. Please don't redraw, recolor or rearrange them.

Name and voice

The product is Homework: one word, capital H, the rest lower case. The domain is homework.house, all lower case. We write the way a good site manager talks: plain, specific and calm.

  • Plain

    Short sentences and everyday words. Say “invoice”, not “billing artifact”. Say what happened, then what to do.
  • Specific

    Name the thing: the invoice number, the room, the amount, the date. A number beats an adjective.
  • Calm

    Money is stressful enough. No exclamation marks, no countdowns, no alarm. Amber says “needs you” and that is enough.

Write it like this

  • Do
    Homework
    Don’t
    HomeWork, HOMEWORK, or “homework” in a sentence about the product
  • Do
    homework.house
    Don’t
    Homework.House, HomeWork.house
  • Do
    Invoice 1042 for $4,150 is due Friday.
    Don’t
    You have an outstanding balance that requires attention.
  • Do
    Change order 7 is waiting on you.
    Don’t
    Action required!
  • Do
    Gmail and Outlook connect is planned.
    Don’t
    Connects to your inbox. (It doesn’t yet.)
  • Do
    Paid Mar 3
    Don’t
    Payment successfully processed

Words we use

Invoice, change order, deposit, receipt, bid, room, owed, paid, approved, sent.

Words we don't

Revolutionary, seamless, effortless, game-changing, AI-powered. If a claim needs one of these, it needs a fact instead.

Sentence case for every heading, button, label and badge. No capitals-only labels above headings. Anything not built yet is badged Planned and written in the future tense; what runs today can carry In the pilot.

Color

A warm neutral shell, one ink, and four status colors that only ever mean status. The ink is the brand.

Each swatch is painted with its CSS variable, so it changes when your device switches to dark, just as the console does. The hex next to it is the light value, read from src/app/globals.css when this page was built. Dark values are listed in docs/BRAND.md.

Neutrals

  • --bg#fafaf9

    Page ground. Cards sit on it, transparent.

  • --panel#ffffff

    Raised controls only: buttons, inputs, the side sheet, tooltips.

  • --bg-2#f1f0ed

    Wash: hover, the segmented track, subtotal rows, the not-yet pill.

  • --bg-3#e9e8e4

    Deep wash: the stone panel, input hover border, scrollbars.

  • --line#e6e4df

    Hairline: card and table borders, chart gridlines.

  • --ink#121212

    Text, figures, chart marks, the filled button and the mark.

  • --ink-2#5e5d59

    Muted text: leads and secondary copy.

  • --ink-3#6f6e69

    Faint text: labels, captions, table headers, axes.

Status

Each status has a text tone and a tint. Color always repeats a word that already says the status; it is never the only signal.

  • $12,400Paid
    --green#0f7b3e
    --green-bg#e6f4ea

    Paid, done, matched.

  • $4,150Needs you
    --amber#9a5800
    --amber-bg#fcefd6

    Owed now, a change order to approve, a decision to make.

  • $860Sent
    --blue#1d5fbf
    --blue-bg#e7effb

    Sent or in flight: approved, invoiced, ordered. Also the focus ring.

  • $310Mismatch
    --red#b4232a
    --red-bg#fbe9e9

    Records that disagree, failed syncs, save errors.

Chart categories

For charts only, where telling sections apart is the job (the contract breakdown). Never for status, buttons or text. Each slot has a paired label ink, shown inside the fill.

  • --c1#2672cf
  • --c2#e87ba4
  • --c3#6250d6
  • --c4#eb6834
  • --c5#0f8fb0
  • --c-rest#b9b8b2

Type

Two faces. The serif sets titles and money, always at regular weight. Geist does everything else.

  • Hedvig Letters Serif

    Headings and figures. Weight 400 only. SIL Open Font License, self-hosted.

  • Geist

    Body, labels, buttons, tables, axes. Weights 400 and 500. SIL Open Font License, self-hosted.

  • .display

    Hedvig 400, 38 to 68px, line height 1.04

    The one page title (h1).

    Know exactly what your renovation owes.

  • .display-2

    Hedvig 400, 28 to 40px, line height 1.1

    Section titles.

    Budget against invoices, room by room

  • .display-3

    Hedvig 400, 22px / 28px

    Sheet titles and small headings.

    Change order 7: vanity upgrade

  • .lead

    Geist 400, 16 to 18px, line height 1.55, muted

    The line under a title.

    Every invoice, change order and payment from your contractor, checked against each other in one place.

  • Body

    Geist 400, 14px, line height 1.45

    Running text in the console and the site.

    Invoice 1042 from the tile crew was matched to your bank alert on Mar 3. Nothing is owed on the primary bath.

  • .t-label

    Geist 400, 12px / 16px, faint

    Labels, captions, table headers.

    Paid Mar 3 · Primary bath

  • .fig and .num

    Serif figures are proportional; numbers in columns are tabular.

    Every money headline, with its label beneath.

    $184,813

    Contract

    Including 4 change orders

    The same amounts with proportional and with tabular numerals
    InvoiceProportionalTabular (.num)
    1041$12,400.00$12,400.00
    1042$4,150.00$4,150.00
    1043$860.50$860.50
    1044$11,111.11$11,111.11

Components

The same classes build the console and this site. These are live, painted by the same tokens, with invented numbers.

  • Buttons

    .btn .btn-primary .btn-lg

    One filled button per view. Everything else is the quiet default.

  • Status badges

    .badge .badge-paid .badge-attn .badge-sent .badge-bad .badge-muted .badge-ink .badge-outline

    PaidNeeds youSentMismatchNot yet invoicedIn the pilotPlanned

    Sentence case, the word first. Badges, count chips and dots are the only round shapes.

  • Card

    .card .card-head .card-body .row .fig

    Owed now

    2 invoices

    $4,150

    • Invoice 1042 · Primary bath$3,290
    • Invoice 1044 · Powder room$860

    A hairline box on the page ground. Cards never lift.

  • Chips

    .chip

    • PDF invoices
    • Contractor email
    • Phone photos

    Sources and plain tags. Not buttons, not links.

  • Segmented control

    .seg

    Static here. In the console it switches Monthly and Weekly, or chart and table.

  • Inputs

    .input, select.input

    Square, on the panel color, with a visible label. Focus draws the blue ring.

Usage rules

Ten rules keep the site and the console looking like one product.

  • One filled button per view

    The ink button marks the single next step. Everything else is the outlined default or a text link.
  • Serif for titles and figures

    Hedvig sets page titles, section titles and money. Labels, controls, tables and axes are always Geist.
  • Color means status

    Amber means it needs you. Green means paid. Blue means sent or in flight. Red means two records disagree. Grey means not yet.Needs youPaidSentMismatchNot yet
  • No new colors

    Use the variables in globals.css. If something needs a new color, it needs a conversation first, and both themes.
  • Square corners

    Cards, buttons, inputs, tables, the sheet and the mark. Only badges, count chips and dots are round.
  • Hairlines over shadows

    Depth comes from a 1px line and a step in tone. Shadows are kept for three things: the selected segment, chart tooltips and the side sheet.
  • Sentence case

    Every heading, button, label and badge. No capitals-only labels, no tracked-out eyebrows.
  • Honest tense

    If it isn't built, it carries a Planned badge and the future tense. No testimonials, no invented numbers.
  • No emoji

    Not in copy, buttons, badges or alt text. Icons are lucide-react at a 1.5 to 1.7 stroke.
  • Both themes, phone width

    Everything works in light and dark, using the variables only, and at 390px with no sideways scroll on the page. Wide tables become stacked lists on phones.

How the site and the console stay the same

There is one style sheet. Both the public site and the console import it, so a token changed there changes both.

  1. Change the token

    Edit the variable in src/app/globals.css, in the light block and in both dark blocks.
  2. Both change

    The console and every marketing page read the same variables. There is no second copy to update.
  3. Write it down

    DESIGN.md documents the system; docs/BRAND.md lists the values and files. Update both in the same change.
  4. Rebuild the mark

    If the mark or wordmark changes, run scripts/brand/make_brand_assets.py to regenerate the SVGs and the favicon, then update Logo.tsx and src/brand/og.tsx by hand to match.
$175,188
Contract incl. tax
bid + approved change orders
$116,129
Paid
deposit and invoices
$4,150
Owed now
1 invoice unpaid
The console's own figure cards, on the same tokens as this page. Sample project, invented numbers.Open the full demo

Where everything lives

  • src/app/globals.css
    What it holds
    Every color, type and component token, for both themes. The single source of truth.
  • DESIGN.md
    What it holds
    The design system: roles, hierarchy, components and named rules.
  • docs/BRAND.md
    What it holds
    This kit as a maintained document, with light and dark hex values.
  • src/lib/brand.ts
    What it holds
    Name, domain, tagline, pricing line and contact email.
  • src/components/marketing/Logo.tsx
    What it holds
    The Mark and Lockup components, drawn with the live variables.
  • public/brand-assets/
    What it holds
    The four downloadable SVGs.
  • src/app/icon.svg
    What it holds
    The favicon.
  • src/app/opengraph-image.tsx
    What it holds
    The social card.
  • scripts/brand/make_brand_assets.py
    What it holds
    Regenerates the SVGs, the favicon and the static fonts for generated images.

Need a file that isn't here?

Write to us and we'll send it, or tell you why we can't.