Redesign: build the approved design on the redesign branch

The prototype for #8 is approved. This issue tracks building it into the site.

How it ships

One integration branch: redesign, created from main. Every sub-issue is one pull request into redesign, not into main. Each pull request gets its own preview link, where the owner approves it.
Nothing goes to main until everything is done. When every sub-issue is closed and the owner has approved the full preview, one pull request merges redesign into main, and the whole new site goes live at once.
Merge main into redesign from time to time, so content and fixes from main show in the previews and the final merge stays small.

Sub-issues, in order

Redesign: foundations (fonts, colours, header, footer, 404) #29 Foundations: fonts, colours, header, footer, 404. First.
Redesign: page background and topic map, prepared at build time #30 Page background and topic map, prepared at build time. After Redesign: foundations (fonts, colours, header, footer, 404) #29.
Redesign: article page #32 Article page. After Redesign: foundations (fonts, colours, header, footer, 404) #29, in parallel with Redesign: page background and topic map, prepared at build time #30.
Redesign: home page #31 Home page. After Redesign: page background and topic map, prepared at build time #30.
Redesign: About page #33 About page. After Redesign: page background and topic map, prepared at build time #30.
Redesign: share images and favicon #34 Share images and favicon. Any time after Redesign: foundations (fonts, colours, header, footer, 404) #29.

Decided

Navigation: Home and About only. No Writing page: the home holds Projects and Writing, and "← All writing" on an article goes to the Writing section.
Activity logs leave the home. Their pages keep their URLs, unlisted.
RSS: no visible links. /rss.xml keeps working for subscribers.
Light theme only. Dark mode can be its own issue later.
No shader library or WebGL on the live site: the background and the map are prepared at build time (Redesign: page background and topic map, prepared at build time #30).

Reference

The approved prototype and its source, including the map's shape data and the scripts that made it, are in docs/redesign/ on the redesign branch. Its README says how to view and rebuild it.
The article design is in the Paper file, page "Variations", artboard "V2 · Article — Serif text".

Before merging `redesign` into `main`

Redesign: foundations (fonts, colours, header, footer, 404) #29, Redesign: page background and topic map, prepared at build time #30, Redesign: home page #31, Redesign: article page #32, Redesign: About page #33 and Redesign: share images and favicon #34 closed
The owner approved the full preview, on desktop and phone
The owner confirmed the first figure in the Product part of About (Redesign: About page #33)

Keep the approved redesign prototype as a reference

Merge #36: redesign foundations (fonts, colours, header, footer, 404)

#29 (foundations) is merged into redesign with #36, merge commit 4cf01a4.

Preview: https://pr-36-meaningfool.josselin-perrus.workers.dev
An independent review accepted head 7d38043, and the Deploy build check passed on it.
Points left to the owner (listed in Redesign foundations: fonts, colours, header, footer and 404 #36):
- the 24px phone gutter, where the prototype has 32px;
- the footer spanning the 1240px frame;
- the /documents/ portfolio view keeping its own header.

Next: #30, #32 and #34, in parallel.

Generated by Claude Code

Merge #37: redesign share images and favicon

#34 (share images and favicon) is merged into redesign with #37, merge commit 3df7e38.

Preview: https://pr-37-meaningfool.josselin-perrus.workers.dev
Review: an independent review accepted head 9fab9bf, and the Deploy build check passed on it.
Change made in review: the reading time is now 235 words a minute, which gives the prototype's minutes for all 18 articles.
Points left to the owner (listed in Redesign: share images and favicon #37):
- The orange dot is DejaVu Sans Mono's full stop, so it is smaller than in the Menlo export.
- The 180px apple-touch-icon keeps the tile's 1px border.

Still in progress: #30 and #32.

Generated by Claude Code

Merge #39: redesign article page

#32 (article page) is merged into redesign with #39, as merge commit 572200e.

Preview: https://pr-39-meaningfool.josselin-perrus.workers.dev
Review: an independent review accepted head 94fffd2, and the Deploy build check passed on it. The review fixed two things:
- the heading levels in "Agent Frameworks for the Rest of Us";
- CI's Astro cache was serving stale article HTML after a Markdown plugin changed.
Projects: src/data/projects.ts now holds the three projects, with which articles belong to which project, taken from the prototype. It stays in this repo, and nothing was pushed to meaningfool-writing.
Proposed for meaningfool-writing, not done (see Redesign: article page #39): to show the design's highlighted row and caption, 2026-05-27-structured-extraction.md needs the Mistral row in bold and a Table: … line after the table.
For Redesign: home page #31: "← All writing" links to /#writing, so the home's Writing section needs id="writing".

Still in review: #30, in #38.

Generated by Claude Code

Merge #38: redesign page background and topic map

#30 (page background and topic map) is merged into redesign with #38, merge commit 78b78fd.

Preview: https://pr-38-meaningfool.josselin-perrus.workers.dev. The map is on the temporary, unlisted /map-preview/, which Redesign: home page #31 removes.
Review: an independent review accepted head a26fefa, and the Deploy build check passed on it.
- The review fixed the map's resolution: it is now drawn at 2x or more, as the shader did.
- It also checked Redesign: page background and topic map, drawn from prepared images #38 merged with Redesign: article page #39: the article band lines up with the 720px column on all 58 post pages.
No shader library and no WebGL. The images are prepared by scripts/make-background.py and committed; the browser draws them on 2d canvases.
For Redesign: home page #31 and Redesign: About page #33: the shared Intro block and the TopicMap events (topicmap:pick, data-picked, links) are documented in Redesign: page background and topic map, drawn from prepared images #38.
Points left to the owner (listed in Redesign: page background and topic map, drawn from prepared images #38):
- the paper grain is fixed at its 1440px size;
- the map is about 3.5% lighter than the prototype's;
- the map is 16px wider below 1288px, because of the 24px gutter.

Wave 2 is done. Next: #31 and #33, in parallel.

Generated by Claude Code

Merge #40: redesign home page

#31 (home page) is merged into redesign with #40, as merge commit 319deac.

Preview: https://pr-40-meaningfool.josselin-perrus.workers.dev
Review: an independent review accepted head cd5b9e8 with no fixes, and the Deploy build check passed on it.
- The review also tested Redesign: home page #40 merged locally with Redesign: About page #33's branch (Redesign: About page #41): Home → About → Home with Back and Forward, the filter, and "← All writing".
Topics:
- The site reads topics from the frontmatter first, and falls back to src/data/topics.ts (the prototype's 30% reading).
- Give each article its topics in the frontmatter meaningfool-writing#6 adds the field to the 18 articles. It is a draft and is not merged. Merging it deploys the live site, but the live code ignores the field.
Points left to the owner (listed in Redesign: home page #40):
- hover styles that aren't in the prototype;
- activity logs staying in the sitemap and RSS;
- the new page title and description.

Next: #33 (#41) gets redesign merged in, legacy.css removed now that no page uses it, and a fresh review.

Generated by Claude Code

Merge #41: redesign About page

#33 (About page) is merged into redesign with #41, merge commit 118b781.

Preview: https://pr-41-meaningfool.josselin-perrus.workers.dev
Review: an independent review accepted head 1f36b5e with no fixes, and the Deploy build check passed on it.
- The review tested this unit merged with Redesign: home page #40, and the merged tree (0869662) is the one that landed on redesign.
- Home → About keeps the same map canvas and background, drawn once, with no page load. The home's filter still works after every move.
Points for the owner (listed in Redesign: About page #41):
- The first figure of the Product part ("€1K / year / customer") is still to be confirmed (see the checklist above).
- "beats everyday" is kept as written in the issue; "every day" would be the usual spelling.
- Clicking a dot on About adds the part's #fragment to the address.
- The site-wide footer also ends About.

All six sub-issues are now merged. A last small cleanup follows before the final pull request: src/styles/legacy.css is no longer used by any page and gets removed.

Generated by Claude Code

Merged #42 (remove the unused legacy stylesheet, a cleanup following #33) into redesign as b5c7f46, from accepted head 61b24fd. The rendered site is unchanged: every page is pixel-identical at 1440px and 375px wide, and the only computed-style difference is <html> font-size, from 18px to 16px, which nothing uses any more.

Preview: https://pr-42-meaningfool.josselin-perrus.workers.dev

Generated by Claude Code

Shipped. At the owner's request, #43 merged redesign into main as e8c17cc. Its tree is identical to redesign at b5c7f46, which the owner reviewed at https://pr-43-meaningfool.josselin-perrus.workers.dev.

The Deploy run for that commit succeeded: https://github.com/meaningfool/meaningfool.github.io/actions/runs/41798642270

Checked on https://meaningfool.net afterwards:

All 60 sitemap pages, /documents/ and the 404 page give the same status and the same HTML as the preview. The only parts set aside were the analytics beacon and the hostname.
/rss.xml, /robots.txt, /sitemap-index.xml and /llms.txt return 200.
/about redirects to /about/ with a 301, and www redirects to the bare domain.
The security headers and the report-only CSP are present. There is no X-Robots-Tag, so search engines can index the site.
/documents/ keeps no-transform.

The JSON-LD escaping fix in src/components/JsonLd.astro is a separate task. It was there before the redesign.

Generated by Claude Code

Navigation Menu

Repository navigation

Redesign: build the approved design on the redesign branch #35

How it ships

Sub-issues, in order

Decided

Reference

Before merging `redesign` into `main`

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Redesign: build the approved design on the redesign branch #35

Description

How it ships

Sub-issues, in order

Decided

Reference

Before merging redesign into main

Activity

meaningfool commented on Nov 3, 2026

meaningfool commented on Nov 3, 2026

meaningfool commented on Nov 3, 2026

meaningfool commented on Nov 3, 2026

meaningfool commented on Nov 3, 2026

meaningfool commented on Nov 3, 2026

meaningfool commented on Nov 3, 2026

meaningfool commented on Nov 4, 2026

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions

Before merging `redesign` into `main`