Skip to content

Latest commit

 

History

History
335 lines (294 loc) · 16.5 KB

DESIGN.md

File metadata and controls

335 lines (294 loc) · 16.5 KB
name Doorplate
description Long-term rentals in Spain, listed by the people who own them.
colors
ink ink-soft paper enamel-cobalt enamel-cobalt-deep cobalt-wash mist slate hairline field-edge brick brick-wash pine pine-wash
hsl(222 22% 9%)
hsl(220 14% 30%)
hsl(0 0% 100%)
hsl(224 67% 35%)
hsl(224 69% 28%)
hsl(221 57% 95%)
hsl(216 26% 96%)
hsl(221 10% 42%)
hsl(220 18% 90%)
hsl(220 16% 82%)
hsl(4 77% 40%)
hsl(4 80% 96%)
hsl(152 62% 24%)
hsl(145 45% 95%)
typography
display headline headline-section figure display-tablet headline-phone listing-title-phone headline-section-phone figure-card title-lg title body-lg body label small caption
fontFamily fontSize fontWeight lineHeight letterSpacing
Libre Franklin, system-ui, sans-serif
56px
700
1.06
-0.025em
fontFamily fontSize fontWeight lineHeight letterSpacing
Libre Franklin, system-ui, sans-serif
40px
700
1.12
-0.02em
fontFamily fontSize fontWeight lineHeight letterSpacing
Libre Franklin, system-ui, sans-serif
34px
700
1.25
-0.02em
fontFamily fontSize fontWeight lineHeight letterSpacing fontFeature
Libre Franklin, system-ui, sans-serif
26px
700
1.25
-0.01em
tnum
fontFamily fontSize fontWeight lineHeight letterSpacing
Libre Franklin, system-ui, sans-serif
48px
700
1.06
-0.025em
fontFamily fontSize fontWeight lineHeight letterSpacing
Libre Franklin, system-ui, sans-serif
32px
700
1.25
-0.02em
fontFamily fontSize fontWeight lineHeight letterSpacing
Libre Franklin, system-ui, sans-serif
30px
700
1.12
-0.02em
fontFamily fontSize fontWeight lineHeight letterSpacing
Libre Franklin, system-ui, sans-serif
28px
700
1.25
-0.02em
fontFamily fontSize fontWeight lineHeight letterSpacing fontFeature
Libre Franklin, system-ui, sans-serif
24px
700
1.25
-0.01em
tnum
fontFamily fontSize fontWeight lineHeight letterSpacing
Libre Franklin, system-ui, sans-serif
22px
700
1.25
0
fontFamily fontSize fontWeight lineHeight letterSpacing
Libre Franklin, system-ui, sans-serif
1.3125rem
700
1.85rem
-0.01em
fontFamily fontSize fontWeight lineHeight
Libre Franklin, system-ui, sans-serif
1.1875rem
400
1.75rem
fontFamily fontSize fontWeight lineHeight
Libre Franklin, system-ui, sans-serif
1.0625rem
400
1.65rem
fontFamily fontSize fontWeight lineHeight
Libre Franklin, system-ui, sans-serif
1rem
600
1.5rem
fontFamily fontSize fontWeight lineHeight
Libre Franklin, system-ui, sans-serif
1rem
400
1.5rem
fontFamily fontSize fontWeight lineHeight
Libre Franklin, system-ui, sans-serif
0.9375rem
600
1.375rem
rounded
sm md lg full
4px
6px
8px
9999px
spacing
gutter gutter-sm card-gap-x card-gap-y section page
16px
24px
32px
40px
72px
1200px
components
button-primary button-primary-hover button-primary-lg button-outline button-ghost button-ghost-hover button-destructive input logo-plate owner-monogram panel-raised key-facts-cell nav-link nav-link-active
backgroundColor textColor typography rounded padding height
{colors.enamel-cobalt}
{colors.paper}
{typography.body}
{rounded.md}
0 20px
44px
backgroundColor
{colors.enamel-cobalt-deep}
backgroundColor textColor rounded padding height
{colors.enamel-cobalt}
{colors.paper}
{rounded.md}
0 24px
52px
backgroundColor textColor rounded padding height
{colors.paper}
{colors.ink}
{rounded.md}
0 20px
44px
textColor rounded height
{colors.ink-soft}
{rounded.md}
44px
backgroundColor textColor
{colors.mist}
{colors.ink}
backgroundColor textColor rounded height
{colors.paper}
{colors.brick}
{rounded.md}
44px
backgroundColor textColor typography rounded padding height
{colors.paper}
{colors.ink}
{typography.body}
{rounded.md}
0 14px
48px
backgroundColor textColor rounded padding
{colors.enamel-cobalt}
{colors.paper}
5px
3px
backgroundColor textColor rounded size
{colors.cobalt-wash}
{colors.enamel-cobalt}
{rounded.full}
52px
backgroundColor rounded padding
{colors.paper}
{rounded.lg}
28px
typography padding
{typography.figure}
16px 22px
textColor typography
{colors.ink-soft}
{typography.small}
textColor typography
{colors.ink}
{typography.label}

Design System: Doorplate

Overview

Creative North Star: "The Enamel Doorplate"

Doorplate looks like something a careful adult trusts with a year's rent. The page is white, the ink is near-black, the greys are cool, and a single enamel cobalt does the pointing: the logo plate, the links, the button you are meant to press. Everything else is photographs of real flats and facts stated plainly: rent per month, bedrooms, bathrooms, square metres, the owner's name.

The register is conventional on purpose, the same bar as a Ghost theme: standard header, standard forms, generous type, nothing that performs. Density is calm; the type ramp runs large (17px body, 19px for reading copy) so a renter on a phone never squints at a price or a label. The one literal gesture is the logo, a wordmark set in a small cobalt plate with a thin white keyline, like the enamel number plate by a front door.

The world rejects the previous Homely look outright: no pill badge above the headline, no serif headline with accent-coloured last words, no teal pill buttons, no soft floating cards, no AI-rendered interiors.

Key Characteristics:

  • White ground, near-black ink, one cobalt.
  • Libre Franklin throughout: 700 for headings and figures, 400 for reading, 600 for labels.
  • Facts as figures: rent, rooms and size set bold and tabular before any prose.
  • Real photographs at 6px corners, never illustration or render.
  • Hairline borders carry structure; one soft shadow marks the two working panels.

Colors

A paper-and-ink palette with one enamel blue and two quiet status colours.

Primary

  • Enamel Cobalt (enamel-cobalt): the logo plate, every primary action ("Show flats", "Send enquiry", "List your flat"), text links ("See all flats", auth switch links), the focus ring, text selection, caret and native control accent.
  • Deep Enamel (enamel-cobalt-deep): hover state of primary buttons only.
  • Cobalt Wash (cobalt-wash): the ground of owner and account monograms (initials set in Enamel Cobalt). Never a panel or section background.

Neutral

  • Ink (ink): headings, figures, body copy, the active nav item, and the ink rule over result lists.
  • Soft Ink (ink-soft): ledes, secondary lines, place names, the "a month" suffix, inactive nav links.
  • Paper (paper): the page, cards, panels, fields, popovers. One ground everywhere.
  • Mist (mist): photo placeholders, ghost-button hover, the "How Doorplate works" band, file-input buttons.
  • Slate (slate): placeholders, footer text, the owner/date line under a card, select chevrons.
  • Hairline (hairline): dividers, card rules, panel and key-facts borders, header and footer rules.
  • Field Edge (field-edge): input, select and outline-button borders, the search card border, step-number rings.

Status

  • Brick (brick) on Brick Wash (brick-wash): field errors, form alerts, the destructive outline button.
  • Pine (pine) on Pine Wash (pine-wash): the enquiry-sent confirmation.

Named Rules

The One Cobalt Rule. Cobalt appears on the logo plate, links, primary actions and interaction states (focus ring, selection, the filled heart of a saved listing, the current item in the phone menu), plus the initials of an owner monogram. It never fills a section, never colours a word inside a headline, never decorates.

The Single Ground Rule. The page is white. The only tinted band is Mist, used once on the landing for "How Doorplate works". No gradients, no glass, no dark sections.

Typography

Display Font: Libre Franklin (via next/font, with system-ui, sans-serif) Body Font: Libre Franklin (same family; weights 400, 500, 600, 700 loaded)

Character: One grotesque in four weights, set tight at the top and open in the body. It reads like a well-made property notice: confident numbers, plain sentences.

Hierarchy

  • Display (700, 56px desktop / 48px tablet / 40px phone, line-height 1.06, -0.025em): the landing headline only, two lines.
  • Headline (700, 40px / 32px phone, -0.02em): page titles (browse, listing, saved, my listings, forms, enquiries). Listing titles use line-height 1.12 and drop to 30px on phones; auth and not-found use 32px.
  • Headline Section (700, 34px / 28px phone, -0.02em): section headings on the landing ("New this week", "How Doorplate works").
  • Figure (700, 26px, -0.01em, tabular numerals): key-facts values on a listing. Card rents use the same treatment at 24px.
  • Title (700, 21px, -0.01em): panel headings ("Write to Lucía"), empty-state titles. Step-group titles and the rent on "My listings" rows run at 22px; the account name uses 28px; "About the flat" at 24px.
  • Body Large (400, 19px, line-height 1.75rem): ledes and listing descriptions, capped at 66ch (34ch for the landing lede, 56ch for intro copy). The landing lede steps to 21px at sm and up.
  • Body (400, 17px, line-height 1.65rem): default text, field values, buttons.
  • Label (600, 16px): form labels, emphasised names inside small lines.
  • Small (400, 16px): nav links, facts lines on cards, helper copy, footer.
  • Caption (600, 15px): the smallest size in use, for monogram initials and the "All N photos" button.

Named Rules

The Readable Floor Rule. Secondary text never goes below 15px; ordinary small copy is 16px; body is 17px. The Tailwind xs/sm/base steps are remapped to 15/16/17px so no utility can undercut the floor.

The Plain Headline Rule. Headlines are one colour, one weight, sentence case, ending in a full stop on the landing. No label above them, no coloured words inside them.

Layout

Pages sit in a centred column capped at 1200px (page), with 16px side padding on phones and 24px from 640px up. The header is a 72px bar ruled off by a hairline; the footer mirrors it.

Vertical rhythm runs on 72px between landing sections and 40–64px above page content. Listing cards sit in a one, two, then three-column grid (640px, 1024px) with 32px column and 40px row gaps; each card is photo (4:3), rent, facts line, title, place, then a hairline and the owner line.

The landing opens on a two-column hero (text column, 520px photo at 4:5) with a 72px gap; below 1024px the photo stacks under the search card at 16:10 or 4:3. The listing page opens on a 2fr/1fr photo grid 520px tall, then a content column and a 400px sticky side panel with a 72px gap; on phones the panel follows the content and a fixed bottom bar carries the rent and a "Write to" button.

Single-task pages use narrow columns: auth 440px, account 640px, listing form 760px, enquiries 860px, owner listings 920px. Result lists open under an ink rule (a 1px Ink border) with the count on the left and sort on the right.

Elevation & Depth

Depth is mostly hairlines on white. One soft, low-contrast shadow lifts the two surfaces where the visitor does the work: the landing search card and the listing's owner and enquiry panel. Radix overlays (dialog, sheet, dropdown, toast) keep their stock floating shadow because they genuinely float above the page.

Shadow Vocabulary

  • Raised (box-shadow: 0 1px 2px rgb(18 21 28 / 0.04), 0 8px 24px rgb(18 21 28 / 0.06)): the search card and the enquiry/owner panel only.
  • Photo control (box-shadow: 0 1px 3px rgb(0 0 0 / 0.18)): the round save button sitting on a listing photo, for legibility against the image.

Named Rules

The Two Panels Rule. Raised is earned by a working form, not by a card. Listing cards, key-facts strips and content boxes stay flat with hairline borders.

Shapes

Corners are gently squared: 6px on buttons, fields, photos and small boxes; 8px on panels, the key-facts strip, the search card and the "List your flat" band; 4px for the smallest insets. The logo plate is 5px outside and 3px inside its white keyline. Full circles are reserved for monograms, the numbered steps on the landing and the photo save button. No pills. Photos clip to the same 6px, and the listing grid squares off the inner edges where photos meet.

Components

Buttons

Plain, solid, unmistakable.

  • Shape: gently squared (6px), 44px tall by default, 52px for the main action of a page, 36px compact; 600 weight; Lucide icons at 18px.
  • Primary: Enamel Cobalt with white text, 20px side padding (24px large); hover deepens to Deep Enamel. One per view where possible.
  • Outline: white with a Field Edge border and Ink text; hover darkens the border to Slate. Used for Sign up, Save, Share, Log out, Clear filters.
  • Ghost: Soft Ink text, Mist on hover; the phone menu trigger.
  • Destructive: white with a translucent Brick border and Brick text, Brick Wash on hover.
  • Focus / Disabled: a 2px cobalt outline offset 2px on every focusable element; disabled drops to 55% opacity.

Cards / Containers

  • Listing card: no box. A 4:3 photo at 6px corners, then rent as a figure, a facts line, a 19px semibold title link, the place, and a hairline above "Name, owner · listed N days ago". A round white save button sits top-right on the photo.
  • Raised panel: white, 8px corners, hairline border, Raised shadow, 24–28px padding; holds the owner monogram, the enquiry form and Save/Share.
  • Key-facts strip: four cells (two by two on phones) divided by hairlines inside an 8px border; value as Figure, label as Small Soft Ink underneath.

Inputs / Fields

  • Style: 48px tall, white, 1px Field Edge border, 6px corners, 14px side padding, 17px text, Slate placeholder. Selects are native with a Lucide chevron. Textareas start at 112px.
  • Hover / Focus: hover darkens the border to Slate; focus turns the border cobalt with a 3px cobalt ring at 20% opacity.
  • Error / Disabled: invalid fields take a Brick border and a 16px Brick message below; form-level errors are a Brick Wash alert with an icon. Disabled is 55% opacity.

Navigation

  • Header: logo plate, then 16px links in Soft Ink (the current page in Ink, semibold), Log in as a plain link and Sign up as an outline button on the right. Signed in, a monogram plus first name opens the account menu.
  • Phone: a ghost menu button opens a right-hand sheet of 19px links divided by hairlines, the current one in cobalt, with full-width Sign up and Log in buttons.
  • Footer: small logo plate, one Slate line, three Slate links.

Logo Plate

The wordmark "Doorplate" in 700 white, inside a 3px cobalt plate with a thin 70% white inner keyline. 17px in the header, 15px in the footer and sheet. It is the only place cobalt is used as a filled shape at rest besides buttons.

Owner Monogram

Initials in Enamel Cobalt, bold, on a Cobalt Wash circle: 36px in the header, 52px on the listing panel, 64px on the account page. It stands in for an avatar; there are no profile photos.

Do's and Don'ts

Do:

  • Do show rent per month, bedrooms, bathrooms and m² as bold tabular figures before any description.
  • Do name the owner on every card and listing.
  • Do use real photographs of real places, cropped with object-fit, at 6px corners.
  • Do keep cobalt to the logo plate, links, primary actions and interaction states.
  • Do keep secondary text at 15px or more and body at 17px.
  • Do separate with Hairline borders and reserve the Raised shadow for the search card and the enquiry panel.
  • Do use Lucide icons as inline SVG at 18px beside a text label.

Don't:

  • Don't put an eyebrow, kicker or pill badge above a headline.
  • Don't colour words inside a headline with cobalt or any other accent.
  • Don't use gradients, glass, blur or dark sections.
  • Don't use AI-generated interiors, renders or illustrations in place of photographs.
  • Don't use pill-shaped buttons or teal; don't bring back the Homely serif headline.
  • Don't add shadows to listing cards or content boxes.