The one-command install stops hiding on the hub page #433

Merged

enricobuehler merged 1 commits from worktree-docs-universal-installer into main 2026-08-28 21:00:29 +00:00

Conversation 0 Commits 1 Files Changed 8

+50 -1

enricobuehler commented 2026-08-28 20:48:59 +00:00

Owner

Copy Link

Copy Source

The guided installer covers apt, dnf, pacman and sysext boxes, but only /docs/install ever mentioned it. A reader who lands on /docs/ubuntu from a search works through five numbered steps and never learns the whole page has a one-liner.

What changed

The same block now sits above step 1 on every page the script actually detects — ubuntu, debian, fedora, arch, bazzite and omarchy:

One command instead? The guided installer (preview) does everything on this page — it detects the distro, installs the host, joins the groups, opens the firewall and starts it:

<Installer />

The steps below are the same thing by hand, and stay the documented path.

nixos, steamos-host and windows-host are deliberately left alone. scripts/install.sh refuses those three and points at their pages, so an installer box there would promise something the script will not do.

The wording is family-neutral on purpose. "Adds the repo" would be wrong on Bazzite, which installs a sysext rather than a repo.

The command itself is rendered by the existing <Installer /> component, so the one-liner still comes from data/platforms.json and no page restates the URL.

Also here

Omarchy was added to the sidebar with #428 but never to the two pages that route people there. It is now a card on /docs/install and an entry in the quickstart table. This is outside the change above and is two lines, so it is easy to drop if you would rather it landed separately.

Verification

• scripts/ci/check-docs-drift.sh exits 0, after the rebase onto the stricter gate that came with #432.
• bun run build in docs-site/ succeeds.
• Served the build and rendered each page: all six carry the block, and /docs/omarchy renders the real curl … | sh line rather than an empty component.
• Rebased onto 4e392a76. #432 edited install.mdx in the channel section, well clear of the cards, and the rebase applied without conflict.

The guided installer covers apt, dnf, pacman and sysext boxes, but only `/docs/install` ever mentioned it. A reader who lands on `/docs/ubuntu` from a search works through five numbered steps and never learns the whole page has a one-liner. ## What changed The same block now sits above step 1 on every page the script actually detects — `ubuntu`, `debian`, `fedora`, `arch`, `bazzite` and `omarchy`: > **One command instead?** The [guided installer](/docs/install#guided-install-preview) (preview) does everything on this page — it detects the distro, installs the host, joins the groups, opens the firewall and starts it: > > `<Installer />` > > The steps below are the same thing by hand, and stay the documented path. `nixos`, `steamos-host` and `windows-host` are deliberately left alone. `scripts/install.sh` refuses those three and points at their pages, so an installer box there would promise something the script will not do. The wording is family-neutral on purpose. "Adds the repo" would be wrong on Bazzite, which installs a sysext rather than a repo. The command itself is rendered by the existing `<Installer />` component, so the one-liner still comes from `data/platforms.json` and no page restates the URL. ## Also here Omarchy was added to the sidebar with #428 but never to the two pages that route people there. It is now a card on `/docs/install` and an entry in the quickstart table. This is outside the change above and is two lines, so it is easy to drop if you would rather it landed separately. ## Verification - `scripts/ci/check-docs-drift.sh` exits 0, after the rebase onto the stricter gate that came with #432. - `bun run build` in `docs-site/` succeeds. - Served the build and rendered each page: all six carry the block, and `/docs/omarchy` renders the real `curl … | sh` line rather than an empty component. - Rebased onto `4e392a76`. #432 edited `install.mdx` in the channel section, well clear of the cards, and the rebase applied without conflict.

enricobuehler added 1 commit 2026-08-28 20:49:01 +00:00

docs: the one-command install stops hiding on the hub page ... 6ca7e4a7ec

The guided installer covers apt, dnf, pacman and sysext boxes, but only the
install hub mentioned it — a reader who lands on /docs/ubuntu from a search
never learns the whole page has a one-liner. Put the same block above step 1
on every page the script actually detects, and leave NixOS, SteamOS and
Windows alone: the script refuses those and points at their pages.

Also list Omarchy on the hub cards and in the quickstart table. It was added
to the sidebar with #428 but never to the two pages that route people there.

enricobuehler merged commit 14ec3d1b5d into main 2026-08-28 21:00:29 +00:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No labels

Milestone

No items

No Milestone

Projects

Clear projects

No projects

Assignees

Clear assignees

FernandoMX FlipperDan HitFrostbite bluelightspecial enricobuehler (Enrico Bühler) kszlim luxus nannku neoney

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: unom/punktfunk#433