# Concepts — evergreen explainers

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](../get-started.md)** for copy-paste steps, then read **[Two-drive model](two-drive-model.md)** and **[Boot and init timeline](boot-and-init-timeline.md)**. Deeper operations: [user manual — ch.3](../../users-manual/03-running-seeder-and-booter.md).

## Pages

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

## Where to go next

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