Releases

Changelogs and release documentation.

Contents

Document	Description
Releasing	Changesets, ordermatic-release-bot, and releases
Deployment Guide	What deploys where, and rollback
Branching & Promotion Model	How staging fast-forwards to main
Developer Workflow	Creating changesets and semantic versioning

Per-package version histories live in each app or package’s CHANGELOG.md file (e.g., apps/webapp/CHANGELOG.md). Older per-release notes (release-0.1.0) live in the Archive.

Creating Releases

Use changesets to record changes on feature branches; release.yml automatically versions and merges the Version Packages (staging) PR on staging:

# Create a changeset on your feature branch
pnpm changeset

# Preview what will be released
pnpm version:check

# Promote staging to production (manual human approval)
gh workflow run auto-deploy-main.yml --ref staging

See Releasing and the Deployment Guide for how releases reach staging and production.