Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 66 additions & 5 deletions docs/tasks-todo/task-x-typography-font-selection.md
Original file line number Diff line number Diff line change
Expand Up @@ -134,11 +134,72 @@ Note: There is no need for our display face and Literata to be **expecially** co

## Running Task Lists

[Use this space to keep a checklist of tasks/progress, or write out phased plans etc as needed]

### Phase 1 - ???

- [ ]
All test fonts are loaded via CDN in `src/styles/_foundation.css`. Uncomment the relevant `--font-ui` and `--font-display` lines to test each option.

### Phase 1 - Test Unified Sans Hypothesis

Can Bricolage Grotesque work for BOTH display AND UI/short-form via its optical size axis?

- [ ] Uncomment TEST 1 in `_foundation.css` (both `--font-ui` and `--font-display` lines)
- [ ] Check display contexts:
- [ ] Homepage "DANNY SMITH" at massive scale
- [ ] "WRITING" / "NOTES" page headers
- [ ] 404 page
- [ ] Check UI contexts:
- [ ] Nav drawer links
- [ ] Footer
- [ ] Pills / tags
- [ ] Check short-form prose:
- [ ] /now page content
- [ ] Note cards on /notes
- [ ] Check Literata pairing:
- [ ] Callouts within articles
- [ ] Captions next to prose
- [ ] **Decision:** Is lack of italic acceptable for short-form prose?
- [ ] **Verdict:** Does Bricolage work as unified sans? YES / NO

### Phase 2A - If Unified Works

- [ ] Bricolage Grotesque confirmed for both `--font-display` and `--font-ui`
- [ ] Skip to Phase 3

### Phase 2B - If Unified Doesn't Work, Split the Problem

**UI/Short-form candidates** (test in order):

- [ ] TEST 2: Inter - the proven, safe Literata pairing
- [ ] Check /now page, note cards, nav, footer
- [ ] Check pairing with Literata in callouts/captions
- [ ] Verdict: ___
- [ ] TEST 3: Figtree - warmer, friendlier alternative
- [ ] Same checks as Inter
- [ ] Verdict: ___
- [ ] **UI Font Decision:** ___

**Display candidates** (test in order):

- [ ] TEST 4: Satoshi - leading candidate, clean geometric
- [ ] Check homepage, page headers, 404
- [ ] Verdict: ___
- [ ] TEST 5: Familjen Grotesk - ink traps add craft (watch the N)
- [ ] Same checks
- [ ] Verdict: ___
- [ ] TEST 6: Instrument Sans - subtle playfulness
- [ ] Same checks
- [ ] Verdict: ___
- [ ] TEST 7: Geist - angular terminals (no italic)
- [ ] Same checks
- [ ] Verdict: ___
- [ ] **Display Font Decision:** ___

### Phase 3 - Finalise

- [ ] Download and self-host chosen font(s) as woff2
- [ ] Remove CDN test fonts from `_foundation.css`
- [ ] Update `docs/developer/fonts.md` with new font documentation
- [ ] Run `bun run check:all`
- [ ] Test both light and dark themes
- [ ] Move this task to tasks-done/

## Research & Testing Notes

Expand Down
207 changes: 203 additions & 4 deletions src/styles/_foundation.css
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,9 @@
Font faces, @property declarations and design tokens
============================================ */

/* FONT FACES */
/* ============================================
FONT FACES - PRODUCTION
============================================ */

@font-face {
font-family: 'Literata';
Expand All @@ -28,6 +30,141 @@
font-display: swap;
}

/* ============================================
FONT FACES - TESTING CANDIDATES
These are loaded via CDN for experimentation.
Remove this section once font selection is finalized.
============================================ */

/* --- BRICOLAGE GROTESQUE ---
Axes: wght 200-800, wdth 75-100, opsz 12-96
No italic. The optical size axis is KEY - at large sizes ink traps
become decorative, at small sizes it adapts for legibility.
Could potentially serve as UNIFIED sans for both display AND UI.
Source: https://fonts.google.com/specimen/Bricolage+Grotesque
*/
@font-face {
font-family: 'Bricolage Grotesque';
font-style: normal;
font-display: swap;
font-weight: 200 800;
src: url('https://cdn.jsdelivr.net/fontsource/fonts/bricolage-grotesque:vf@latest/latin-wght-normal.woff2') format('woff2-variations');
}

/* --- INTER ---
Axes: wght 100-900, opsz
Has italic (separate file). Proven Literata pairing, excellent for screens.
The "safe" choice for UI/short-form.
Source: https://rsms.me/inter/ or Fontsource
*/
@font-face {
font-family: 'Inter';
font-style: normal;
font-display: swap;
font-weight: 100 900;
src: url('https://cdn.jsdelivr.net/fontsource/fonts/inter:vf@latest/latin-wght-normal.woff2') format('woff2-variations');
}
@font-face {
font-family: 'Inter';
font-style: italic;
font-display: swap;
font-weight: 100 900;
src: url('https://cdn.jsdelivr.net/fontsource/fonts/inter:vf@latest/latin-wght-italic.woff2') format('woff2-variations');
}

/* --- FIGTREE ---
Axes: wght 300-900
Has italic. Friendlier/warmer than Inter. Less common.
Source: https://fonts.google.com/specimen/Figtree
*/
@font-face {
font-family: 'Figtree';
font-style: normal;
font-display: swap;
font-weight: 300 900;
src: url('https://cdn.jsdelivr.net/fontsource/fonts/figtree:vf@latest/latin-wght-normal.woff2') format('woff2-variations');
}
@font-face {
font-family: 'Figtree';
font-style: italic;
font-display: swap;
font-weight: 300 900;
src: url('https://cdn.jsdelivr.net/fontsource/fonts/figtree:vf@latest/latin-wght-italic.woff2') format('woff2-variations');
}

/* --- SATOSHI ---
Axes: wght 300-900
Has italic. Current leading display candidate. Clean geometric.
Source: https://www.fontshare.com/fonts/satoshi
*/
@font-face {
font-family: 'Satoshi';
font-style: normal;
font-display: swap;
font-weight: 300 900;
src: url('https://cdn.fontshare.com/wf/NWBQYJIM7GCZ5XWD7D26ARB3VDY55ZRT/K63EV2KZIGKLE7RANQ2U42S6SVHU5RJ7/X6XYTKIVDUW7GZTZPZNN4EUM5KH54KHF.woff2') format('woff2');
}
@font-face {
font-family: 'Satoshi';
font-style: italic;
font-display: swap;
font-weight: 300 900;
src: url('https://cdn.fontshare.com/wf/NWBQYJIM7GCZ5XWD7D26ARB3VDY55ZRT/XCDLPNIPWWHTEBVJQMXMZ45QNILV7HMX/LYBDPA24LJFLVMQKN6WHEO7VHQHM6SZ4.woff2') format('woff2');
}

/* --- FAMILJEN GROTESK ---
Axes: wght 400-700
Has italic. Ink traps add craft at display scale. Watch the uppercase N.
Source: https://fonts.google.com/specimen/Familjen+Grotesk
*/
@font-face {
font-family: 'Familjen Grotesk';
font-style: normal;
font-display: swap;
font-weight: 400 700;
src: url('https://cdn.jsdelivr.net/fontsource/fonts/familjen-grotesk:vf@latest/latin-wght-normal.woff2') format('woff2-variations');
}
@font-face {
font-family: 'Familjen Grotesk';
font-style: italic;
font-display: swap;
font-weight: 400 700;
src: url('https://cdn.jsdelivr.net/fontsource/fonts/familjen-grotesk:vf@latest/latin-wght-italic.woff2') format('woff2-variations');
}

/* --- INSTRUMENT SANS ---
Axes: wght 400-700, wdth 75-100
Has italic. "Balances precision with subtle playfulness."
Source: https://fonts.google.com/specimen/Instrument+Sans
*/
@font-face {
font-family: 'Instrument Sans';
font-style: normal;
font-display: swap;
font-weight: 400 700;
src: url('https://cdn.jsdelivr.net/fontsource/fonts/instrument-sans:vf@latest/latin-wght-normal.woff2') format('woff2-variations');
}
@font-face {
font-family: 'Instrument Sans';
font-style: italic;
font-display: swap;
font-weight: 400 700;
src: url('https://cdn.jsdelivr.net/fontsource/fonts/instrument-sans:vf@latest/latin-wght-italic.woff2') format('woff2-variations');
}

/* --- GEIST ---
Axes: wght 100-900
No italic. Angular terminals add craft at scale. From Vercel.
Source: https://vercel.com/font
*/
@font-face {
font-family: 'Geist';
font-style: normal;
font-display: swap;
font-weight: 100 900;
src: url('https://cdn.jsdelivr.net/fontsource/fonts/geist:vf@latest/latin-wght-normal.woff2') format('woff2-variations');
}

/* COLOR PROPERTIES */

@property --color-accent {
Expand Down Expand Up @@ -89,9 +226,71 @@
============================================ */
:root {
/* ======= FONTS ======= */

--font-ui: 'League Spartan', 'Inter', 'Helvetica Neue', Helvetica, Arial, sans-serif;
--font-display: 'League Spartan', 'Inter', 'Helvetica Neue', Helvetica, Arial, sans-serif;
/*
* TESTING WORKFLOW - See docs/tasks-todo/task-x-typography-font-selection.md
*
* PHASE 1: Test "Unified Sans" hypothesis with Bricolage Grotesque
* - Can one font work for BOTH display AND UI/short-form via optical sizing?
* - Uncomment TEST 1 below, check: homepage, /writing, /notes, /now, nav, footer
* - Key question: Is lack of italic a dealbreaker for short-form prose?
*
* PHASE 2A: If unified works → done! Keep Bricolage for both.
*
* PHASE 2B: If unified doesn't work → split the problem:
* - For UI/short-form: Test Inter (safe), then Figtree (warmer)
* - For Display: Test Satoshi (leading), then others
*
* WHAT TO CHECK:
* Display contexts: Homepage "DANNY SMITH", "WRITING"/"NOTES" headers, 404
* UI contexts: Nav links, footer, pills, buttons
* Short-form: /now page prose, note cards, callouts, captions
* Pairing: How does the sans look NEXT TO Literata? (article callouts, captions)
*/

/* === CURRENT (baseline for comparison) === */
--font-ui: 'League Spartan', 'Helvetica Neue', Helvetica, Arial, sans-serif;
--font-display: 'League Spartan', 'Helvetica Neue', Helvetica, Arial, sans-serif;

/* === TEST 1: Bricolage Grotesque (unified hypothesis) ===
* Try ONE font for both display and UI. The optical size axis should adapt:
* - Large sizes (display): decorative ink traps
* - Small sizes (UI/prose): neutral, legible
* NOTE: No italic available - use font-weight for emphasis instead
*/
/* --font-ui: 'Bricolage Grotesque', 'Helvetica Neue', Helvetica, Arial, sans-serif; */
/* --font-display: 'Bricolage Grotesque', 'Helvetica Neue', Helvetica, Arial, sans-serif; */

/* === TEST 2: Inter for UI, keep testing display separately ===
* The "safe" choice. Proven Literata pairing, excellent screen rendering.
*/
/* --font-ui: 'Inter', 'Helvetica Neue', Helvetica, Arial, sans-serif; */

/* === TEST 3: Figtree for UI ===
* Friendlier/warmer than Inter. Less commonly used.
*/
/* --font-ui: 'Figtree', 'Helvetica Neue', Helvetica, Arial, sans-serif; */

/* === TEST 4: Satoshi for Display ===
* Leading display candidate. Clean geometric, modern.
*/
/* --font-display: 'Satoshi', 'Helvetica Neue', Helvetica, Arial, sans-serif; */

/* === TEST 5: Familjen Grotesk for Display ===
* Ink traps add craft. Watch the uppercase N at large sizes.
*/
/* --font-display: 'Familjen Grotesk', 'Helvetica Neue', Helvetica, Arial, sans-serif; */

/* === TEST 6: Instrument Sans for Display ===
* "Balances precision with subtle playfulness"
*/
/* --font-display: 'Instrument Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif; */

/* === TEST 7: Geist for Display ===
* Angular terminals. No italic. From Vercel.
*/
/* --font-display: 'Geist', 'Helvetica Neue', Helvetica, Arial, sans-serif; */

/* Prose stays Literata - decision already made */
--font-prose: 'Literata', Georgia, 'Times New Roman', serif;
--font-code: 'Fira Code Variable', 'Fira Code', 'Inconsolata', monospace;

Expand Down
Loading