# HALO

> Identity management for local-first apps: a user's identity, the devices and credentials that act for it, and who can join a space.

## Start here

- [Overview](https://dxos.org/docs/halo/overview.md): What HALO is and how its pages are organized.
- [Why HALO?](https://dxos.org/docs/halo/why-halo.md): Why identity is a key pair your device makes, not an account a server issues.

## Learning path

- [The HALO identity](https://dxos.org/docs/halo/learn/the-halo-identity.md): What an identity is, and the app the learning path builds, running for three people.
- [Your profile](https://dxos.org/docs/halo/learn/your-profile.md): Create an identity with a profile, show it and change it.
- [Your spaces](https://dxos.org/docs/halo/learn/your-spaces.md): Create named spaces and switch between them.
- [Invite people](https://dxos.org/docs/halo/learn/invite-people.md): Alice invites Bob into a space with an invitation code and an authorization code.
- [Your contacts](https://dxos.org/docs/halo/learn/your-contacts.md): List everyone you share a space with, and remove someone from a space.
- [Add a device](https://dxos.org/docs/halo/learn/add-device.md): Join Alice's phone to her identity, so it shows the same contacts.
- [Recover an identity](https://dxos.org/docs/halo/learn/recover-identity.md): Make a recovery code, and get Alice's identity back on a new laptop.

## Core concepts

- [Identities and devices](https://dxos.org/docs/halo/concepts/identities-devices.md): An identity is a Keyhive group named by a DID; its devices are its members.
- [Spaces and membership](https://dxos.org/docs/halo/concepts/spaces-membership.md): Who may enter a space, and what each member may do.
- [Invitations](https://dxos.org/docs/halo/concepts/invitations.md): How a device or a person is let into an identity or a space.
- [Recovery and credentials](https://dxos.org/docs/halo/concepts/recovery-credentials.md): How an identity survives the loss of its devices, and what credentials it holds.

## Guides

- [Passkey recovery](https://dxos.org/docs/halo/guides/passkey-recovery.md): Register a passkey as a recovery credential and recover with it.
- [React](https://dxos.org/docs/halo/guides/react.md): Read the identity, devices, spaces and members from React components.

## API

- [Identity](https://dxos.org/docs/halo/api/identity.md): Create, follow, recover and share an identity.
- [Invitation](https://dxos.org/docs/halo/api/invitation.md): Drive an invitation flow from either side.
- [Space](https://dxos.org/docs/halo/api/space.md): Create spaces and manage their members.

## Resources

- [API reference](https://dxos.org/docs/halo/resources/api-reference.md): Generated API reference for `@dxos/halo` and `@dxos/halo-react`.
- [Glossary](https://dxos.org/docs/halo/resources/glossary.md): Every HALO term, defined once.
- [llms.txt](https://dxos.org/docs/halo/resources/llms-txt.md): The HALO site map and full text for agents, in the llms.txt format.