Skip to content

Latest commit

 

History

History
72 lines (57 loc) · 2.62 KB

DESIGN.md

File metadata and controls

72 lines (57 loc) · 2.62 KB
name BetterAuth Demo
description Calm registration surface for application-owned authentication.
colors
graphite surface surface-dark violet violet-deep success danger
#2b2c31
#f8f8fb
#292a30
#7550c9
#5635a5
#247a52
#b43a4a
typography
body
fontFamily fontSize fontWeight lineHeight letterSpacing
ui-sans-serif, system-ui, sans-serif
16px
400
1.5
normal
rounded
sm md lg
6px
10px
16px
spacing
sm md lg xl
8px
16px
24px
40px
components
button-primary input
backgroundColor textColor rounded padding
{colors.violet}
#ffffff
{rounded.sm}
12px 16px
backgroundColor textColor rounded padding
{colors.surface}
{colors.graphite}
{rounded.sm}
10px 12px

Overview

Creative North Star: "Quiet technical confidence." A developer registers in daylight on a laptop or phone, checks a concrete contract, and moves on. The interface is compact, legible, and deliberately absent of dashboard theatre.

Key Characteristics: graphite ground, violet reserved for decisions, native technical sans, and only state-explaining movement.

Colors

Graphite neutrals carry almost all surface area; violet is limited to primary actions, focus, and selected state. Canonical values use OKLCH in implementation (oklch(21% .01 270) graphite; oklch(55% .19 295) violet).

The Ten Percent Rule. Do use violet only for action and state. Do not use it as a decorative field, gradient, or dashboard accent.

Typography

Use the technical system sans stack. Product labels stay at a stable rem scale; reading copy remains under 70ch. Headings earn their weight through density, not a display face.

Elevation

Use one low, neutral shadow only to separate the registration task from the page. Borders remain one pixel and quiet. No glass, glow, or colored side stripe.

Components

Buttons and inputs are at least 44px high, have visible violet focus, and work without hover. Mobile starts as one column; 768px introduces breathing room, 1024px permits the two-column product layout. Safe-area padding and reduced motion are always active.

Do's and Don'ts

Do:

  • Do use graphite neutrals and #7550c9 only for decisions and focus.
  • Do make failure copy specific, generic where account enumeration matters.
  • Do preserve keyboard order, contrast, and 44px touch targets.

Don't:

  • Don't build a fake terminal or decorative SaaS dashboard.
  • Don't use purple gradients, glass surfaces, hero metrics, or colored side stripes.
  • Don't animate layout or ignore reduced-motion preferences.