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 for any hardware — laptops, single-board computers, robots, terminals, embedded systems:

Register — Intake new hardware with verifiable identity + photo evidence
Provision — Flash deterministic NixOS builds via USB or SD card
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 — on any device you throw at it.

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 any device — laptops, Pis, robots, terminals
bun run src/main.ts device register \
  --model "Dell Inspiron 15" --serial "ABC123" --role dev
bun run src/main.ts device register \
  --model "Raspberry Pi 4" --serial "RPi4-001" --role robot
bun run src/main.ts device register \
  --model "HIWONDER TurboPi" --serial "HW-042" --role robot

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