docs(steamframe): rewrite the plan against shipped hardware #1648

Merged
lytedev merged 4 commits from steamframe-plan into main 2026-11-02 13:52:36 -06:00
Owner

Supersedes the closed #937: the hardware shipped, so the issue is no longer a feasibility question. Read the commits for what changed and why the full-NixOS path stays outside this repo for now.

Supersedes the closed #937: the hardware shipped, so the issue is no longer a feasibility question. Read the commits for what changed and why the full-NixOS path stays outside this repo for now.
docs(steamframe): plan a desktop-first NixOS host for the Steam Frame
All checks were successful
/ check-format (push) Successful in 12s
/ build (push) Successful in 6m25s
1e13b92f61
Captures what is actually known ahead of the hardware (mid-2026 window):
aarch64 Snapdragon 8 Gen 3, Valve's ARM SteamOS with Proton/FEX/Lepton, and
Collabora's Holo Core aarch64 Arch port.

Two findings worth writing down: Jovian-NixOS is Deck-specific (jupiter kernel,
amdgpu, no aarch64 work in its tracker) so it does not transfer, and the
bootloader-unlock story is undocumented, which blocks everything else.

No host file and no registration in packages/hosts/default.nix -- a host
written now would be fiction on disk layout, kernel and display, and an
unbuildable aarch64 host would break CI eval.
docs(steamframe): rewrite the plan against shipped hardware
Some checks failed
/ check-format (push) Successful in 1m17s
/ build (push) Failing after 6m37s
1835784b11
The 2026-08 draft treated the Frame as a locked-down ARM device whose
bootloader was the blocking unknown. It shipped 2026-09-14 and there is
no lock: Valve's U-Boot reads Image, initrd.uImage and maindtb.dtb off the
btrfs rootfs slots, so slot A is ordinary writable storage and Valve's
SteamOS recovery image is the way back. Three stacks exist now -- Nix and
home-manager inside SteamOS, frametop for an actual VR desktop on top of
that, and a full NixOS system in slot A from one person's spike -- so the
issue records them with their costs instead of a feasibility question.

Also records why the full-NixOS path stays outside this repo for now: the
module pins its own nixpkgs because Valve's kernel and Mesa are built and
verified there, and Jovian declined to host it (#587), so a Frame host
cannot simply be another baseHost.
docs(steamframe): plan the road to a full NixOS host
Some checks failed
/ check-format (push) Successful in 9s
/ build (push) Failing after 2m32s
aa3989408b
Frametop turns out to be the opposite of what the last draft assumed: a KDE
Plasma multi-screen desktop driven into SteamVR through a 3D mouse, not a
wlroots compositor, and it needs SteamVR rather than replacing the session.
That makes it the desktop for a full NixOS Frame as well as for stock
SteamOS, and it retires the founding premise of niri on the headset, which
is now recorded as a decision to make rather than an assumption.

Adds the staged path to a steamframe host in this repo (throwaway aarch64
evaluations, then stock SteamOS, then the spike's own images, then our
nixpkgs), the four decisions it forces -- which nixpkgs, consume or vendor
the device layer, keeping the kernel out of CI, and what the desktop in VR
is -- and the open questions to answer on the hardware, headed by whether
slot A can be the default boot: if it cannot, SteamOS stays the daily
driver and this issue changes shape.

Runbook gains the parts of johns.codes that actually bite: passwd before
sudo, /etc/tmpfiles.d before the installer, the nested-session env for
home-manager, steamos-etc for gpuDrivers and /etc, and the launcher PATH.
docs(steamframe): record the phase-0 evaluation result
Some checks failed
/ check-format (push) Successful in 8s
/ build (push) Failing after 2m29s
f6b3cbb5cb
lytedev deleted branch steamframe-plan 2026-11-02 13:52:37 -06:00
Sign in to join this conversation.
No reviewers
No milestone
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
lytedev/nix!1648
No description provided.