Skip to content

Latest commit

 

History

History
58 lines (43 loc) · 1.66 KB

RELEASE.md

File metadata and controls

58 lines (43 loc) · 1.66 KB

Release Procedure

Publish a new release with the below instructions, you must first be a contributor who is authorized to both push directly to this repo and publish packages to the lightningjs NPM scope.

Mark, push and publish the release

# Make sure you're on the main branch
git checkout main

# Stash any untracked + uncomitted changes
git stash -u

# Pull any new commits from GitHub
git pull

# Run the unit tests
pnpm test

# Run the Visual Regression Tests in CI mode
pnpm test:visual --ci

# Review changes in order to decide which release-increment to use
git log --first-parent main...v<last-version-number>

# Mark the version update
# This creates a new tagged commit for the version
pnpm version <release-increment> # patch/minor/major

# Publish the package to NPM
pnpm publish --access public

# Push version commit to github
git push

# Push version tag to github
git push origin vX.X.X

# Pop the stash (if one was created)
git stash pop

Generate a release on GitHub

  1. Go to https://github.com/lightning-js/renderer/releases/new
  2. Choose a Tag: Choose the newly pushed tag
  3. Target: main
  4. Name the release with the same name as the tag: vX.X.X
  5. Click "Generate release notes"
  6. Edit the release notes as appropriate:
    • User facing changes should go under the main "What's Changed" heading
    • Mark all breaking changes with: ⚠️ Breaking Change: (Description)
    • Move any changes specific to performance to a new level 3 heading called: Performance
    • If there are other non-user facing changes move them to a new level 3 heading called: Non-User Facing.
  7. Set as the latest release: Check
  8. Click "Publish release"