Skip to content

Redesign the README - #13

Merged
Kernel-Hunter merged 5 commits into
mainfrom
readme-redesign
Oct 30, 2026
Merged

Kernel-Hunter merged 5 commits into
mainfrom
readme-redesign

Conversation

@Kernel-Hunter

@Kernel-Hunter Kernel-Hunter commented Oct 30, 2026 •

Copy link
Copy Markdown
Owner

Reworks the README header and top section to look more like the READMEs of large app repos, and to read well on a phone.

  • Light and dark banner in a <picture> (docs/assets/mudroom-banner-*.png), replacing the icon and the for-the-badge shields
  • A link row and two flat badges (license, latest release). No stars badge, no star history chart
  • Three-sentence intro, then the 33-second overview video inline, then Install within the first screen: Homebrew and the install script on macOS, Scoop on Windows. The release zip and the Linux build steps are in <details>
  • Features as short bullets, then four screenshots from docs/screenshots (review, network, conflict, timeline), themed where a dark version exists
  • How it compares: a short table that fits a phone, with the full comparison in a <details>. Other agent sandboxes, requirements, sign-in methods and default hosts are lists now, since the tables scrolled sideways on a phone
  • The How it works diagram is top-down so it stays readable on a phone

The reference sections are unchanged apart from that, and every anchor the site and the docs link to still works (#install, #limitations, #install-on-windows, #windows-1, #contents, #keep-files-out-of-the-sandbox and the rest). Rebased on main, so the Windows zip example says 0.5.0.

Centered header with badges and the demo, a feature grid, a mermaid
diagram, install per platform, a quick start and a comparison table up
front. The reference sections keep all their content, with the longest
parts in collapsible blocks, plus an FAQ, contributing notes and a star
history chart.
Replace the icon and for-the-badge header with a light and dark banner,
a link row and two flat badges. Put the overview video and the install
steps in the first screen, show the main features with screenshots, and
turn wide tables into lists so the page reads on a phone. Drop the star
history chart. Every section anchor stays the same.
The sign-in and default-host tables and the left-to-right diagram were
too wide to read on a phone.
@Kernel-Hunter
Kernel-Hunter merged commit 588e7ad into main Oct 30, 2026
7 checks passed
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