workshopsoft/ludic
2
0
Fork 0
Code Issues Pull requests Projects Releases 26 Packages Wiki Activity Actions

refactor(docs): rebuild the site around reading, not launching

Browse source 
The generated site had the shape of a product launch page: a near-black navy
ground with mint/coral radial glows, a gradient-clipped headline, a glowing
pill badge, nine emoji feature cards and scroll-reveal animations. None of it
told a reader anything about the language.

It is now typographic and light-first — a warm paper ground, a serif display
face, one ink-blue accent used only where it means something, and rules
instead of floating cards. Colour is reserved for code. Dark mode is the same
design with the ground inverted, defined once as tokens under a single
prefers-color-scheme block.

Structurally:

- base.css holds the tokens and shared chrome; site.css and docs.css hold what
  is specific to the landing page and the reference pages. They ship as linked
  files rather than being inlined into all 900+ pages, which takes the site
  from 16 MB to 5 MB and means a design change no longer needs a regenerate to
  be seen.
- api.css was dead — the generator never referenced it, rendering the API index
  with item.css — and is gone. docs.css replaces item.css and covers all four
  reference page kinds.
- Grids draw their separators as cell borders instead of bleeding a ruled
  background through gaps, so a final row with fewer cards than columns stops
  cleanly instead of leaving a grey hole. The feature card count is not a
  multiple of the column count at any breakpoint.
- Inline code loses its tinted chip; in a language reference, a box behind
  every keyword turns a paragraph into confetti.
- Fonts are the platform's own, so the site makes no webfont request.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Orkun ÇAKILKAYA 2026-09-05 01:47:36 +03:00
parent 583783449a
commit 2f3833a295
12 changed files with 1046 additions and 571 deletions
Download patch file Download diff file Expand all files Collapse all files

22
changes/site-redesign.md Normal file
View file

@ -0,0 +1,22 @@
bump: minor
type: docs
The generated site is redesigned around reading rather than launching: a warm
paper ground with a serif display face, one ink-blue accent, and rules instead
of floating cards. Colour is reserved for code. Dark mode is the same design
with the ground inverted, driven entirely by tokens under one
`prefers-color-scheme` block, and the landing page's scroll-reveal animations,
gradient headline, glowing badge and emoji feature icons are gone.
- Stylesheets are linked files (`base.css` + `site.css`/`docs.css`) instead of
being inlined into all 900+ pages, which cuts the published site from 16 MB to
5 MB and means a design change no longer requires regenerating to be seen.
- Fonts are the platform's own; the site makes no webfont request.
- `api.css` was dead — the generator never referenced it — and is removed along
with `item.css`, which `docs.css` replaces.
- A page no longer flashes its own title on every plain visit; only a deep link
highlights its target, and under `prefers-reduced-motion` the highlight no
longer stays on the element permanently.
- The copy leads with what is verifiable — ahead-of-time compiled, an ECS in the
syntax, deterministic fixed-point, no C in a build — and the "get started"
steps now begin with the clang-plus-seed bootstrap, without which `bin/x` does
not exist on a clean checkout.