diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 0000000..9206326
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,22 @@
+name: Release
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Publish
+        uses: whilesmart/workflows/js/publish@main
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          scope: '@sourceant'
+          verify_command: node scripts/check-exports.mjs
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..fd12831
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-08-30
+
+First release. Versioned on its own, because nothing about the components is
+tied to a release of the core.
+
+### Added
+
+- Twenty five components shared by everything SourceAnt puts on a screen, from
+  buttons, fields and modals through to the code graph, diffs and rendered
+  markdown
+- One set of design tokens, published as `@sourceant/design/tokens.css` and as a
+  Tailwind preset, so a consumer takes the vocabulary rather than restating it
+- A check that every path the package advertises actually resolves, run before
+  anything is published
diff --git a/package.json b/package.json
index 0928153..456736e 100644
--- a/package.json
+++ b/package.json
@@ -4,6 +4,13 @@
   "description": "SourceAnt design system: tokens, primitives, and the graph renderer",
   "license": "MIT",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sourceant/design.git"
+  },
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  },
   "sideEffects": [
     "*.css"
   ],