Skip to content

site: one design system for the four sites - #8

Merged
ricardofrantz merged 2 commits into
mainfrom
site/harmony
Nov 20, 2026
Merged

ricardofrantz merged 2 commits into
mainfrom
site/harmony

Conversation

@ricardofrantz

@ricardofrantz ricardofrantz commented Nov 19, 2026 •

Copy link
Copy Markdown
Member

The approved design (19 Nov), built by the generator. This replaces docs/ with what sh publish.sh boringquantsystems writes from machine-made/machine-made.github.io at d171410a9ca1af0c280c949c404295309057e483 (machine-made/machine-made.github.io#21). It uses the same GitHub facts file as the machine-made site.

The page now has:

  • the two bars, the banner and the house line;
  • Latest, and plates with live GitHub facts;
  • the houses row and the footer;
  • a 404 page;
  • AVIF and JPEG images with srcset, og.jpg at 1200 x 630, a favicon and a touch icon;
  • a subset of each font.

The design and its checks are described in the generator PR. Below 390 px the generator's style also sets the type tiles and the type line smaller. Those parts appear only on the type site, so these pages look the same.

Proof

docs/ is byte-identical to the generator's own build of this house from the same facts: the SHA-256 lists of the 33 files are equal.

Generator gate at d171410a9ca1af0c280c949c404295309057e483:

FETCHED
DETERMINISTIC
BRAND SKIPPED: set MM_FONTS=brand-fonts to check brand/
SELF-TEST OK (338 cases)
OK
SHOTS OK (9 renders)
OK
SHOTS OK (9 renders)
OK
SHOTS OK (9 renders)
HOUSES OK
grep clean

check_site.py --site for this house prints OK, and shots.py prints SHOTS OK (9 renders). The 9 renders are the home page at 320, 360, 390, 720, 1000, 1280 and 1920 px, and the 404 page at a nested missing path at 390 and 1280 px. They find no sideways scroll, no glyph in a system font, no facts line that wraps at 1280 px, and every link at least 44 px high at 390 px.

Contrast, axe and Lighthouse:

Check Result
Contrast (WCAG ratio) see the generator PR: text at least 14.9:1, muted at least 5.6:1, accent at least 9.6:1
axe-core 4.14.1, 1280 px 0 violations on the home page and the 404 page
Page Lighthouse mobile Lighthouse desktop
BoringQuantSystems 100 / 100 / 100 / 100 100 / 100 / 100 / 100
BoringQuantSystems 404 100 / 100 / 100 / 100 100 / 100 / 100 / 100

Bytes loaded per page, after scrolling to the end:

Page Fonts Images at 390 px Images at 1280 px
BoringQuantSystems 60,408 54,730 58,958

Shots, opened and checked by eye: home-390.png, home-1280.png, 404-390.png and 404-1280.png from shots.py.

Pixel comparison with the approved page, full page at 1280 px: 1384 / 1384 px, 0.0005 % (8 px, rows 68 to 72: the 28 px bar-2 avatar, scaled here from the 360 px avatar, while the approved page used GitHub's 56 px copy).

SHA-256 of every file in docs/
1430acd5ff18e2cd6b784b1218e5f547065af5956559143971e455eaebe22890  ./404.html
2fb33ba139387788333efcb5d71ef917b143bbbde378156a0038702c15812cf6  ./fonts/mm-sans-OFL.txt
ce071e4ae2b75c2389874643585cac2be1aa672e5219524408bbb116fe8047a2  ./fonts/mm-warp-OFL.txt
6a9105bee0f18e6f00138d17cb0b5692f416c763a9539a50d7e69c143c00fb6d  ./fonts/mm-weft-OFL.txt
8aa090b330f8cac7456894b1c6635b2af3a7157ce939d7f3a09f51cb92ce4e22  ./fonts/sans.woff2
f398c2c8c2b499526cc7c6d4ce857bf5391be5c2c0f686909c8ecf8f49f128a6  ./fonts/warp.woff2
d2597604e33f745c1033a20500a0a33cf6d0e80f687ac9d9f10d9a4b34d4495f  ./fonts/weft.woff2
cf7cb999ba696fcd0b89e7564c304dd67c4b0a6e01e6803e4349a3740ec94fd3  ./img/avatar.png
f319751f0555f7a1c3a8fff67782790b92905de6cc517377e625697d7d8d5a5f  ./img/banner-boringquantsystems-1408.avif
fd5c5ec4ecffebf69ec1d1f36923e85223eb0c045235b55d242eec6d51d0ea9c  ./img/banner-boringquantsystems-1408.jpg
1413d1fc6e6212434fe967c2d239f7961200929ec0ba88b666f976b6fdeffe93  ./img/banner-boringquantsystems-704.avif
e8ffb5f4120fb299ab4ab9585fc574c1ab767504384c57b80092278106dba498  ./img/banner-boringquantsystems-704.jpg
0b34269bb4b4a27147fd6f587d527b8b213dc93c5b1a2e3f14afc1263ac6acd7  ./img/banner-machine-made-1408.avif
28ea93ead52bb90f82346bf38e36f2cdd6f83832ade67c096bc13f41fda73b9a  ./img/banner-machine-made-1408.jpg
bdbf42836d1d9e04f0bc73f93c0194397a2e7743fb146cfaa7364b39b3db3177  ./img/banner-machine-made-704.avif
f065abd2f8aa83299ccbec3bdb743acf57ce2348da8975cb1cf3ab8d67249ee7  ./img/banner-machine-made-704.jpg
8d247382f463ceeb958da7dc3c936db95f9656197b66ba104c4f4c21777998ad  ./img/banner-openfluids-1408.avif
4fa2e3e962bedd852d8686ce3bf057c89a7be79799e2c4a4c5e6aec54c89ec74  ./img/banner-openfluids-1408.jpg
eb978eedc73978f08cc9a4988e1520917bf1b1544094c4b9fdd08870cb510e42  ./img/banner-openfluids-704.avif
14a28185fe2c4c3ad9fea59f3e85e4448c85a292845a44808da310c852b55af6  ./img/banner-openfluids-704.jpg
f70a3ba9ab57c9823e801f505d51040339bc7630c7e2b839a41d05b5c89d9658  ./img/icon.png
46006553b4ed990b013d4842d599d9af56de3f0eaeae04dd5952abe40d7ecd2e  ./img/nanobook-352.avif
4af9cf794d5bfeb52446e2b16c5004b7549c0680d7d8e9742841687e61186874  ./img/nanobook-352.jpg
f30756ac3da2c8a5092e9874cc58bffffc49db9fd31634c1c0af06d56cace597  ./img/nanobook-704.avif
3da4122eaad6a71ef6b0378b11dac995035a5af2ea037c2e764662179c0cd7c5  ./img/nanobook-704.jpg
d122281256da7023577c45e46ea901bfa2bb34ccdc94dcc1a02cf6a76bc87a0a  ./img/touch.png
a6cb82c86249879ce90fd1e05dd041ddfac2c54d08b89cc0753115011a681023  ./img/type-352.avif
201a373f27324e62a7a54d94744d186b626cde4d14232f08ee48e956b6fae532  ./img/type-352.jpg
65b9ea61f561f2cf8346ff3ebb220169744370f3fee8ee10bd52dff07fc9d959  ./img/type-704.avif
eec102d1a0f6bc82bb5dbaa579b47e67459dab1304932ce21ffcf0278407b72c  ./img/type-704.jpg
dfc279532eaac838f2d55f2234a683f3ba980206ecfaca78d2413a6df1a6d216  ./index.html
ca8d7a15f7445ed089f8e6ffc1a0b89cdbac994bdb324a098ecbc6924f20713d  ./llms.txt
8790df3b1c0655cc1823ba50c0c72bf18f4de881380a2c4a604f03f88f2a0def  ./og.jpg

Rebuilt docs/ from the generator, machine-made/machine-made.github.io at 885147315e7401ef615d0bf0901658802a2fc903
(sh publish.sh), from the same GitHub facts file as the machine-made site. The page follows the
approved design (19 Nov): two bars, the banner, the house line, Latest, plates with live facts,
the houses row, the footer and a 404 page, with AVIF and JPEG images, og.jpg, icons and font
subsets. docs/ is byte-identical to what the generator writes for this house.

Co-authored-by: Ricardo Frantz <4220623+ricardofrantz@users.noreply.github.com>

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 38 files

View guided diff | Re-trigger cubic

@coderabbitai

coderabbitai Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

Explain Change →

No actionable comments were generated in the recent review.

Walkthrough

The documentation site gains a redesigned home page with release and project listings, a standalone 404 page, and a font license file. The external stylesheet is removed, its styles are replaced with inline CSS, and a tagline is removed from llms.txt.

Changes: Documentation site refresh

Layer / File(s) Summary
Redesign the home page and update site content
docs/index.html, docs/style.css, docs/fonts/mm-sans-OFL.txt, docs/llms.txt
The home page replaces the external stylesheet with inline responsive styles and adds site and section navigation, release details, and Engines and Houses sections. The old stylesheet is deleted, the font license is added, and a tagline is removed from llms.txt.
Add a 404 page
docs/404.html
A standalone responsive page displays a not-found message and a link to the home page.

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Feature

Possibly related PRs

Merge Risk: Minimal · up to a101a

This updates the generated documentation site with a new design and a standalone 404 page. It is static content and easy to roll back, and no actionable merge-blocking risk was found.

Pre-merge checks: Passed 4

Check name Status Explanation
Title check Passed Title 'site: one design system for the four sites' names the main change: the docs/ site is rebuilt from one generator so the four sites share one design system. The summary shows the redesigned index…
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Full details: Title check

Explanation

Title 'site: one design system for the four sites' names the main change: the docs/ site is rebuilt from one generator so the four sites share one design system. The summary shows the redesigned index, 404 page, inline styling, and deleted style.css, which match this. The title is short and specific, though it does not mention that docs/ is regenerated from a generator.

Finishing Touches

Generate unit tests (beta)

  • Commit to this branch
  • Create a new PR
Simplify code

  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

Recent review info

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Central YAML; Path: .coderabbit.yaml
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: f8a5587a-3073-488a-bbb3-31222520f012
Commits

Reviewing files that changed from the base of the PR and between 6750fc9 and a101ae1.

Files ignored due to path filters: 23

  • docs/fonts/mm-warp-italic.woff2 is excluded by !**/*.woff2
  • docs/fonts/mm-warp-regular.woff2 is excluded by !**/*.woff2
  • docs/fonts/mm-weft.woff2 is excluded by !**/*.woff2
  • docs/fonts/sans.woff2 is excluded by !**/*.woff2
  • docs/fonts/warp.woff2 is excluded by !**/*.woff2
  • docs/fonts/weft.woff2 is excluded by !**/*.woff2
  • docs/img/avatar.png is excluded by !**/*.png
  • docs/img/banner-boringquantsystems-1408.jpg is excluded by !**/*.jpg
  • docs/img/banner-boringquantsystems-704.jpg is excluded by !**/*.jpg
  • docs/img/banner-machine-made-1408.jpg is excluded by !**/*.jpg
  • docs/img/banner-machine-made-704.jpg is excluded by !**/*.jpg
  • docs/img/banner-openfluids-1408.jpg is excluded by !**/*.jpg
  • docs/img/banner-openfluids-704.jpg is excluded by !**/*.jpg
  • docs/img/banner.jpg is excluded by !**/*.jpg
  • docs/img/icon.png is excluded by !**/*.png
  • docs/img/nanobook-352.jpg is excluded by !**/*.jpg
  • docs/img/nanobook-704.jpg is excluded by !**/*.jpg
  • docs/img/nanobook.jpg is excluded by !**/*.jpg
  • docs/img/touch.png is excluded by !**/*.png
  • docs/img/type-352.jpg is excluded by !**/*.jpg
  • docs/img/type-704.jpg is excluded by !**/*.jpg
  • docs/mark.svg is excluded by !**/*.svg
  • docs/og.jpg is excluded by !**/*.jpg
Files selected for processing: 15

  • docs/404.html
  • docs/fonts/mm-sans-OFL.txt
  • docs/img/banner-boringquantsystems-1408.avif
  • docs/img/banner-boringquantsystems-704.avif
  • docs/img/banner-machine-made-1408.avif
  • docs/img/banner-machine-made-704.avif
  • docs/img/banner-openfluids-1408.avif
  • docs/img/banner-openfluids-704.avif
  • docs/img/nanobook-352.avif
  • docs/img/nanobook-704.avif
  • docs/img/type-352.avif
  • docs/img/type-704.avif
  • docs/index.html
  • docs/llms.txt
  • docs/style.css
Files with no reviewable changes: 2

  • docs/llms.txt
  • docs/style.css

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

Rebuilt docs/ from the generator at f895aedbcab1a117cd9ba644ed428bca2843f7cf, from the same GitHub facts file. Only the
style block of index.html and 404.html changes: below 390 px the type tiles and the type line
are set smaller.
docs/ stays byte-identical to what the generator writes for this house.

Co-authored-by: Ricardo Frantz <4220623+ricardofrantz@users.noreply.github.com>
@ricardofrantz
ricardofrantz merged commit 83fc94a into main Nov 20, 2026
5 checks passed
@ricardofrantz
ricardofrantz deleted the site/harmony branch November 20, 2026 00:33
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.

1 participant