# Rollbird

> Hosted over-the-air updates for React Native without monthly-active-user pricing. Rollback is always free and never consumes quota.

Rollbird's public CLI has exactly five commands: init, login, release, rollback, and status. Verify commands and flags against the CLI reference before changing a project. Do not install expo-updates alongside Rollbird. Re-run rollbird init and rebuild after native dependency or native configuration changes.

## Documentation

- [Documentation overview](https://rollbird.dev/docs/): Prerequisites, guide map, first-release path, and product invariants.
- [Getting started](https://rollbird.dev/docs/getting-started/): Ordered install, login, init, wrap, rebuild, preview release, device verification, production, and rollback.
- [CLI reference](https://rollbird.dev/docs/cli/): Every command, flag, output mode, exact exit-code contract, and worked examples.
- [React Native SDK](https://rollbird.dev/docs/react-native/): Rollbird.wrap, Expo config plugin, channels, fingerprints, update strategies, callbacks, Hermes, and device behavior.
- [CI/CD](https://rollbird.dev/docs/ci/): API-token scopes, project binding, secret handling, and GitHub Actions.
- [Troubleshooting](https://rollbird.dev/docs/troubleshooting/): Exact errors with causes, fixes, verification, and current limitations.

## Markdown sources

- [Overview Markdown](https://rollbird.dev/docs/index.md)
- [Getting started Markdown](https://rollbird.dev/docs/getting-started.md)
- [CLI Markdown](https://rollbird.dev/docs/cli.md)
- [React Native Markdown](https://rollbird.dev/docs/react-native.md)
- [CI/CD Markdown](https://rollbird.dev/docs/ci.md)
- [Troubleshooting Markdown](https://rollbird.dev/docs/troubleshooting.md)

## Agent rules

- Read rollbird.json before running init again; it identifies the linked project.
- Use Node.js 20 or newer.
- Treat CLI exit codes as an automation contract.
- Keep ROLLBIRD_TOKEN in the CI secret store. Never write it to rollbird.json or the repository.
- Prefer a release:write token bound to one project for CI publishing.
- Do not guess a command, flag, native path, plan limit, or price.
- Do not claim installation has been verified from npm until @rollbird/cli and @rollbird/react-native are published.