# w84death/floppinux architecture

> Architecture diagram of the GitHub repository w84death/floppinux, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/w84death/floppinux
- Repository: https://github.com/w84death/floppinux

## Overview

FLOPPINUX is documented as a compact Linux distribution for booting legacy or minimal hardware from a floppy. The README describes the resulting kernel, terminal, persistent storage and essential tools, but this tree contains no distribution source or image—only documentation and a framebuffer assembly file. Accordingly, the graph captures documented product capabilities, not an implementation pipeline; its internal relationships are limited to those stated in the README.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_distribution["Floppy distribution"]
  node_floppy["Floppy image"]
  node_linux["Linux distribution"]
end

subgraph group_runtime["Runtime capabilities"]
  node_kernel["Linux kernel"]
  node_terminal["Working terminal"]
  node_storage[("Persistent storage")]
  node_tools["Essential tools"]
  node_vi["Vi editor"]
end

node_user(("Hardware user"))

node_user -->|"boots from"| node_floppy
node_floppy -->|"boots"| node_linux
node_linux -->|"includes"| node_kernel
node_linux -->|"boots into"| node_terminal
node_linux -->|"provides"| node_storage
node_linux -->|"includes"| node_tools
node_tools -->|"includes"| node_vi

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_floppy,node_linux,node_user toneBlue
class node_kernel,node_terminal,node_storage,node_tools,node_vi toneAmber
```

## Components

### Floppy distribution

- **Floppy image**
- **Linux distribution**

### Runtime capabilities

- **Linux kernel**
- **Working terminal**
- **Persistent storage**
- **Essential tools**
- **Vi editor**

### Other components

- **Hardware user**

## Connections

- Hardware user → Floppy image: boots from (evidence: `README.md`)
- Floppy image → Linux distribution: boots (evidence: `README.md`)
- Linux distribution → Linux kernel: includes (evidence: `README.md`)
- Linux distribution → Working terminal: boots into (evidence: `README.md`)
- Linux distribution → Persistent storage: provides (evidence: `README.md`)
- Linux distribution → Essential tools: includes (evidence: `README.md`)
- Essential tools → Vi editor: includes (evidence: `README.md`)