Floppy.WTF Documentation

Welcome to the Floppy.WTF documentation. This is the complete reference for the device lifecycle platform built on NixOS.

What is Floppy.WTF?

Floppy.WTF is a complete device lifecycle platform:

Register — Intake new hardware with verifiable identity + photo evidence
Provision — Flash deterministic NixOS builds via USB
Theme — Ship branded, gorgeous desktop experiences (Applenix / Matrix)
Connect — AirDrop-like device mesh with encrypted sync
Manage — Fleet visibility, role assignment, integrity verification

The goal: rival Apple’s device experience using open, reproducible infrastructure.

Principles

#	Principle	Description
1	Deterministic	Every system state derivable from config
2	Integrity-first	Content-addressed, hash-verified, auditable
3	Beautiful	Typography and theming rival commercial OS quality
4	Composable	Modular NixOS configs, reusable across hardware classes
5	Operational	CLI-driven workflows, not manual procedures

Quick Start


# Clone the repo
git clone git@github.com:DecOperations/Floppy.WTF.git
cd Floppy.WTF
 
# Install CLI dependencies
cd cli && bun install
 
# Register your first device
bun run src/main.ts device register \
  --model "Dell Inspiron 15 3535" \
  --serial "ABC1234XYZ" \
  --role dev

Documentation Structure

Architecture — Monorepo layout, component boundaries, tech stack
Device Registration — Device ID format, evidence handling, CLI commands
NixOS Provisioning — Flake architecture, role taxonomy, USB flash workflow
Theming — Applenix + Matrix themes, font rendering pipeline
Networking & Sync — LocalSend, Syncthing, WireGuard, Avahi
Roadmap — Phase-by-phase project plan