Skip to main content

max / alloy_tui

git clone https://makenot.work/git/max/alloy_tui.git git clone git@ssh.makenot.work:max/alloy_tui.git
Name Size
/ build/
/ builds.disabled/
/ crates/
/ docs/
/ etc/
/ schemas/
/ tools/
/ usr/
· .gitignore 550 B
· Cargo.lock 45.3 KB
· Cargo.toml 356 B
· Containerfile 11.0 KB
· CONTRIBUTING.md 2.5 KB
· LICENSE 34.3 KB
· README.md 2.6 KB

README

Project Alloy

An opinionated tiling user layer for Fedora Silverblue.

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.

Short form for slugs, CLI binaries, package names, file extensions: alloy.

Status

Pre-v0. The docs are the project. Code follows.

License

GPLv3-or-later, with one exception: the alloy_tui crate is MIT, so other projects can build terminal UIs on the design system without taking on copyleft. See LICENSE, crates/alloy_tui/LICENSE, and CONTRIBUTING.md.

Docs

  • docs/MANIFESTO.md — what Alloy is, who it’s for, the thesis.
  • docs/STACK.md — every pick (base, compositor, bar, lock, launcher, notifications, screenshot, file manager) with reasoning and what was rejected.
  • docs/MARQUEE-APPS.md — the egui design-system app pipeline.
  • docs/COMPONENT-LIBRARY.md — alloy_tui crate idioms and how themes reach the widgets.
  • 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?
  • docs/DESIGN-LANGUAGE.md — tinted-greyscale chrome, color reserved for information.
  • docs/CONSOLE.md — Alloy Console: the ratatui unified control surface (alloy net, alloy audio, alloy mesh shipped; alloy config <path> schema-driven editor next). Replaces the “graphical settings app” question.
  • docs/CONTINUITY.md — a mesh VPN and file sync as base-image citizens: an Alloy install should be rejoinable, not just installable.
  • docs/SHELL.md — Nushell as the login shell; bash unchanged as /bin/sh and /bin/bash. Architecture, interop rules, accepted costs.
  • docs/HARDWARE-FW12.md — Framework Laptop 12 as the first hardware target: 2-in-1 stance, touch/tablet/rotation/OSK/fingerprint decisions.
  • docs/IMAGE.md — Image composition: bootc + Containerfile, source on git.sr.ht, CI on builds.sr.ht, container image on quay.io.
  • docs/todo.md — open questions and next steps.