Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -1,8 +1,11 @@
name: Release

on:
push:
branches: [main]
# Manual trigger for now. Re-enable `push: branches: [main]` once (1) a trusted
# publisher is configured on npmjs.com for each @ark/* package and (2) GitHub
# Actions is allowed to create pull requests
# (Settings → Actions → General → Workflow permissions).
workflow_dispatch:

# OIDC trusted publishing to npm (no long-lived NPM_TOKEN). Requires a trusted
# publisher to be configured on npmjs.com for each @ark/* package before the
Expand Down
18 changes: 13 additions & 5 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,8 +75,16 @@ changes bump the minor and reuse the file; breaking changes publish a new

## Releasing

Releases are automated with **Changesets** and published to npm via **OIDC
trusted publishing** (no `NPM_TOKEN`). Before the first publish, a trusted
publisher must be configured on npmjs.com for each `@ark/*` package, pointing at
`.github/workflows/release.yml`. Merging the bot's “Version Packages” PR then
publishes the bumped packages with provenance attestations.
Releases use **Changesets** and publish to npm via **OIDC trusted publishing**
(no `NPM_TOKEN`). Merging the “Version Packages” PR publishes the bumped packages
with provenance attestations.

The Release workflow is currently **manually dispatched** (Actions → Release →
Run workflow). Before switching its trigger back to `push` (auto-release), two
prerequisites must be in place:

1. a trusted publisher configured on npmjs.com for each `@ark/*` package,
pointing at `.github/workflows/release.yml`; and
2. **Settings → Actions → General → Workflow permissions →** “Allow GitHub
Actions to create and approve pull requests” enabled (Changesets opens the
“Version Packages” PR).