Craft: Universal Release Tool

Craft is a command line tool that helps automate and pipeline package releases. It enforces a specific workflow for managing release branches, changelogs, and artifact publishing.

📚 Full Documentation

Quick Start

Installation

Download the latest binary release, or install via npm:

npm install -g @sentry/craft

Usage

# Auto-determine version from conventional commits
craft prepare auto

# Or specify a version explicitly
craft prepare 1.2.3

# Publish to all configured targets
craft publish 1.2.3

Features

• Auto Versioning - Automatically determine version bumps from conventional commits
• Multiple Targets - Publish to GitHub, NPM, PyPI, Docker, Crates.io, NuGet, and more
• Changelog Management - Auto-generate changelogs from commits or validate manual entries
• Workspace Support - Handle monorepos with NPM/Yarn workspaces
• CI Integration - Wait for CI to pass, download artifacts, and publish
• GitHub Actions - Built-in actions for release preparation and changelog previews

Configuration

Create a .craft.yml in your project root:

minVersion: '2.0.0'
changelog:
  policy: auto
targets:
  - name: github
  - name: npm
    access: public

See the configuration reference for all options.

Supported Targets

See the targets documentation for configuration details.

GitHub Actions

Craft provides GitHub Actions for automating releases and previewing changelog entries.

Prepare Release Action

Automates the craft prepare workflow in GitHub Actions:

name: Release
on:
  workflow_dispatch:
    inputs:
      version:
        description: 'Version to release (or "auto")'
        required: false

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: getsentry/craft@v2
        with:
          version: ${{ github.event.inputs.version }}
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Inputs:

Outputs:

Changelog Preview (Reusable Workflow)

Posts a preview comment on PRs showing how they'll appear in the changelog:

name: Changelog Preview
on:
  pull_request:
    types: [opened, synchronize, reopened, edited, labeled]

jobs:
  changelog-preview:
    uses: getsentry/craft/.github/workflows/changelog-preview.yml@v2
    secrets: inherit

The workflow will:

• Generate the upcoming changelog including the PR's changes
• Highlight entries from the PR using blockquote style (left border)
• Post a comment on the PR with the preview
• Automatically update when you update the PR (push, edit title/description, or change labels)

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT