These pages are short, stable introductions to how Bare OS fits together. They intentionally link outward to the handbook (narrative depth) and docs/reference (normative numbers and APIs) instead of duplicating them.

Tip

New to the repo? Run Get started for copy-paste steps, then read Two-drive model and Boot and init timeline. Deeper operations: user manual — ch.3.

Pages

Topic	Summary
Two-drive model	System vs personal Hyperdrive, `$HOME`, `/.bare`, VFS routing
Boot and init timeline	Seeder → swarm → booter → `/boot/init.js` → shell
P2P swarm and Protomux	Topic, channel `bare-os-v1`, MBR, replication sketch
Identity and vault	Guest vs logged-in, Ed25519 account, vault snapshots
POSIX stance	Declared profile, what “POSIX-like” means here, where to look

Where to go next

Documentation hub — docs/README.md (full map, curricula, POSIX dashboard).
Handbook — handbook/README.md.
Developer guide — developer-guide/README.md.