# lifeos handbook

- [lifeos](/docs): One person's estate — two apps, one ledger, one deploy path.
- Get started
  - [Get started](/docs/get-started): What to read first, depending on why you are here.
  - [The estate in ten minutes](/docs/get-started/tour): What exists, what talks to what, and why it is shaped this way.
  - [Run it locally](/docs/get-started/run-locally): Toolchain, one command, and the ports everything lands on.
- Apps
  - [Apps](/docs/apps): The two applications, and the line between them.
  - [Finloop](/docs/apps/finloop): A double-entry ledger with envelopes, bills, projects and a month-end statement.
  - [IAM](/docs/apps/iam): Issues the tokens, and deliberately does nothing else.
- Concepts
  - [Concepts](/docs/concepts): The ideas the code assumes you already hold.
  - [The ledger](/docs/concepts/the-ledger): Postings, lines, and why both have to balance.
  - [Envelopes](/docs/concepts/envelopes): Claims on money you already have, not accounts money moves into.
  - [The monorepo](/docs/concepts/the-monorepo): Nx above Gradle and Bun, and who actually owns each job.
- Operations
  - [Operations](/docs/operations): Getting it to production, and the machines it lands on.
  - [Deploying](/docs/operations/deploying): The single gated path, and the two switches that must stay off.
  - [Infrastructure](/docs/operations/infrastructure): The hosts, the shared services, and what each hostname is.
  - [Env and secrets](/docs/operations/env-and-secrets): Where configuration lives, and why a missing variable kills the app.
- Reference
  - [Reference](/docs/reference): The decisions, and the house style.
  - [Decision records](/docs/reference/adrs): Twenty-one ADRs, and what each one settles.
  - [Conventions](/docs/reference/conventions): Naming, layout, comments, and what the build actually enforces.