Skip to Content

Versions and releases

Every pull request that changes shipped code must bump the matching version. Tests and Markdown don't count. CI checks this.

You changedBump
The app: apps/mobile, packages/encryption, packages/schemas or packages/sharedexpo.version in apps/mobile/app.json, plus both ios.buildNumber and android.versionCode
The server: apps/backend, apps/scheduled-jobs, or any other package except tsconfigserverVersion in apps/backend/src/version.ts

Use a patch bump for fixes, and a minor bump for features and database migrations. Some packages are shared, so one change can need both bumps.

Check locally with:

bun scripts/check-version-bump.ts origin/main

Lockfile

Before committing, run bun install --frozen-lockfile. If it fails, run bun install, commit bun.lock, and run the frozen install again.

On this page