| 1 |
# Project Alloy |
| 2 |
|
| 3 |
*An opinionated tiling user layer for Fedora Silverblue.* |
| 4 |
|
| 5 |
**Project Alloy is to Silverblue what Omarchy is to Arch:** a curated, beautifully-defaulted, keyboard-driven environment that fuses an immutable base, a Wayland tiling compositor, an opinionated app/tool stack, and a project-authored design system into one coherent system. An alloy is stronger than its component metals. |
| 6 |
|
| 7 |
Short form for slugs, CLI binaries, package names, file extensions: `alloy`. |
| 8 |
|
| 9 |
## Status |
| 10 |
|
| 11 |
Pre-v0. The docs are the project. Code follows. |
| 12 |
|
| 13 |
## License |
| 14 |
|
| 15 |
MIT. Copyright (c) 2026 Make Creative, LLC. See [`LICENSE`](LICENSE). |
| 16 |
|
| 17 |
The design system it renders through, |
| 18 |
[`alloy_tui`](https://makenot.work/git/max/alloy_tui), is MIT in its own repo and |
| 19 |
consumed from crates.io. |
| 20 |
|
| 21 |
## Docs |
| 22 |
|
| 23 |
The [manual](docs/manual/README.md) is for people who run Alloy: building an |
| 24 |
image, installing, the keybindings, how software gets installed, how to roll |
| 25 |
back, troubleshooting. Everything below it is design rationale, written for |
| 26 |
whoever works on Alloy. |
| 27 |
|
| 28 |
- [`docs/MANIFESTO.md`](docs/MANIFESTO.md) — what Alloy is, who it's for, the thesis. |
| 29 |
- [`docs/STACK.md`](docs/STACK.md) — every pick (base, compositor, bar, lock, launcher, notifications, screenshot, file manager) with reasoning and what was rejected. |
| 30 |
- [`docs/COMPONENT-LIBRARY.md`](docs/COMPONENT-LIBRARY.md) — `alloy_tui` crate idioms and how themes reach the widgets. |
| 31 |
- [`docs/RESEARCH-IMMEDIATE-MODE-DESIGN.md`](docs/RESEARCH-IMMEDIATE-MODE-DESIGN.md) — late-term research sketch: what does Figma look like for immediate-mode UI? How do designers and engineers collaborate without designers writing Rust? |
| 32 |
- [`docs/DESIGN-LANGUAGE.md`](docs/DESIGN-LANGUAGE.md) — tinted-greyscale chrome, color reserved for information. |
| 33 |
- [`docs/CONSOLE.md`](docs/CONSOLE.md) — Alloy Console: the ratatui unified control surface (`alloy net`, `alloy audio`, `alloy mesh`, `alloy settings` and the `alloy config <path>` schema-driven editor all shipped). Replaces the "graphical settings app" question. |
| 34 |
- [`docs/CONTINUITY.md`](docs/CONTINUITY.md) — a mesh VPN and file sync as base-image citizens: an Alloy install should be rejoinable, not just installable. |
| 35 |
- [`docs/SHELL.md`](docs/SHELL.md) — Nushell as the login shell; bash unchanged as `/bin/sh` and `/bin/bash`. Architecture, interop rules, accepted costs. |
| 36 |
- [`docs/HARDWARE-FW12.md`](docs/HARDWARE-FW12.md) — Framework Laptop 12 as the first hardware target: 2-in-1 stance, touch/tablet/rotation/OSK/fingerprint decisions. |
| 37 |
- [`docs/HARDWARE-FW13.md`](docs/HARDWARE-FW13.md) — Framework Laptop 13 (AMD Ryzen AI 300) as the second target: measured panel, the 1.75x seed, AMD graphics, what is still unverified. |
| 38 |
- [`docs/MIGRATION-FW13.md`](docs/MIGRATION-FW13.md) — cutover runbook for moving fw13 off Pop!_OS: phase order, the disk decision, the build-host role it has to keep playing, and the way back. |
| 39 |
- [`docs/IMAGE.md`](docs/IMAGE.md) — Image composition: bootc + Containerfile, source on `makenot.work`, built locally and natively. No image is published anywhere; you build your own. |
| 40 |
- [`docs/todo.md`](docs/todo.md) — open questions and next steps. |
| 41 |
|