Skip to content

docs(readme): describe the stack that actually ships - #6

Merged
fajarhide merged 2 commits into
mainfrom
docs/readme-stack
Jul 26, 2026
Merged

fajarhide merged 2 commits into
mainfrom
docs/readme-stack

Conversation

@fajarhide

Copy link
Copy Markdown
Contributor

Closes #2

What

README.md documented a design system the site no longer has. The Stack section
now describes what ships, and stops restating values that live in code.

Why it was wrong

Claim Reality Broke at
#080808 background #12141F dark / #FAF8F3 light 23b5768
#00FFD1 accent #F5B841 dark / #9C6100 light 23b5768
"Strict Dark Mode" Light and dark, with a persisted toggle 6f8f7c6
Body font Geist Inter 23b5768
Display font JetBrains Mono Bricolage Grotesque 23b5768
"High-performance. Shipped to production." Removed from site metadata c23f7d8

The Geist line was wrong before any of this: app/layout.tsx loaded
IBM_Plex_Mono under a variable merely named --font-geist, so the README
looked consistent with the code while both were wrong.

The fix is deletion, not restatement

The section rotted because it duplicated values owned by app/globals.css.
Rewriting the hexes would just reset the clock. Instead the palette bullet links
the file and describes the system in words that stay true when a token changes.
That is also why this PR carries no test: after the change there is no duplicated
constant left for a test to compare.

Verified

Every remaining claim grepped against source on this branch:

080808/00FFD1/Geist still in README: 0
Bricolage in layout:  2
Inter in layout:      1
JetBrains in layout:  2
triplet tokens:       10
toggle persists:      1
ISR revalidate 3600:  1

One thing caught in review of my own draft

My first pass wrote "nothing on the page is a number typed by hand" under Live
data
. That is false — the hero falls back to a hardcoded '300+', which is
#3. Rewriting a doc to be true and slipping a fresh untrue sentence in is the
exact failure this PR exists to fix. The bullet now states the fallback and links
the issue.

Out of scope

README.md:9 carries a "not just X, it's Y" construction. Real, but not part of
#2, so it stays. Worth a separate ticket if the prose gets a pass.

The Stack section documented #080808/#00FFD1/Geist/strict dark mode, none of which survived the palette and theming work. Stop restating values that live in code: link app/globals.css instead of copying hexes, so the section cannot rot the same way again.
@vercel

vercel Bot commented Jul 26, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
weekndlabs-com Ready Ready Preview, Comment Jul 26, 2026 8:42am

The earlier wording documented the hardcoded star count as current. PR #7 removes it, so the line would have shipped false. Describes the behaviour both PRs agree on instead, which makes merge order irrelevant.
@fajarhide

Copy link
Copy Markdown
Contributor Author

Updated for the interaction with #7.

The Live data bullet previously read "The hero still falls back to a hardcoded star count when a lookup fails (#3)". #7 removes that fallback, so the line would have merged already-false. It now describes the behaviour both branches agree on:

When a lookup fails the page drops the affected line rather than substituting a stale number.

No file overlap between the two branches, so CI would not have caught this. Merge order no longer matters.

@fajarhide
fajarhide merged commit 8aebc7c into main Jul 26, 2026
2 checks passed
@fajarhide
fajarhide deleted the docs/readme-stack branch July 26, 2026 08:52

This branch was successfully deployed

1 active deployment
Preview — 65162cc3 Deployed Jul 26, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

README documents a retired design system: #080808/#00FFD1/Geist/"strict dark mode" are all false on main

1 participant