Release history¶
Archived release checklists from earlier versions. Current procedure: RELEASING.md.
Publishing 1.4.0¶
1.4.0 checklist¶
Item |
Status |
|---|---|
All seven |
Done |
CHANGELOG.md |
Done |
Sphinx |
Done |
MIGRATION-1.3-to-1.4.md in Sphinx toctree |
Done |
Docs updated for 1.4 observability, production guard, init template, and Node 20 |
Done |
|
Done |
No pending |
Done |
|
Done |
|
Done |
|
Done (2026-06-06) |
|
Done locally (2026-06-06); CI green on |
|
0 high/critical (2026-06-06) |
npm latest |
1.3.x — publish with |
Git tag |
Create when ready |
Do not create or push
v1.4.0until you intend to publish to npm.
Publishing 1.3.1¶
1.3.1 checklist¶
Item |
Status |
|---|---|
All seven |
Done |
CHANGELOG.md |
Done |
Sphinx |
Done |
|
Done |
No pending |
Done |
|
Done |
|
Verify before tag |
|
0 vulnerabilities (2026-06-05) |
Git tag |
Create when ready |
Do not create or push
v1.3.1until you intend to publish to npm.
Publishing 1.3.0¶
1.3.0 checklist (ready to publish)¶
Item |
Status |
|---|---|
All seven |
Done |
CHANGELOG.md |
Done |
MIGRATION-1.2-to-1.3.md in Sphinx toctree |
Done |
|
Done (2026-06-05) |
Sphinx |
Done |
No pending |
Done |
|
Verify before tag |
|
Done |
|
Done |
npm publish order: core → xapi → accessibility → themes → lxpack → react → cli |
Done |
npm latest |
1.2.0 — publish with |
Git tag |
Create when ready |
Do not create or push
v1.3.0until you intend to publish to npm.
Publishing 1.2.0¶
1.2.0 checklist (ready to publish)¶
Item |
Status |
|---|---|
All seven |
Done |
CHANGELOG.md |
Done |
MIGRATION-1.1-to-1.2.md in Sphinx toctree |
Done |
|
Verify before tag |
Sphinx |
Done |
|
Done — merge to |
Headless |
Done |
|
Done |
npm latest |
1.1.0 — publish with |
Git tag |
Create when ready |
Do not create or push
v1.2.0until you intend to publish to npm.
Prerequisites¶
mainis green (see CI workflow).All
packages/*/package.jsonversions match the release.CHANGELOG.md documents the release.
No pending files in
.changeset/that would runchangeset versionand bump versions unexpectedly (this repo publishes via git tags, notchangeset publish).
1.0.0 is the stable public API release. See MIGRATION-0.x-to-1.0.md.
1.1.0 checklist (ready to publish)¶
Item |
Status |
|---|---|
All seven |
Done |
Internal |
Done |
Root |
Done |
|
Done |
CHANGELOG.md |
Done |
Assessment contract, telemetry-catalog v2, block-catalog v2 |
Done |
P0 blocks + |
Done |
Done |
|
No pending |
Done |
|
Done — CI run 26893507343 |
|
Verified locally (2026-06-03) |
|
Run before tag |
npm latest |
1.0.2 — publish with |
Git tag |
Create when ready |
Do not create or push
v1.1.0until you intend to publish that version to npm.
1.0.2 checklist (ready to publish)¶
Item |
Status |
|---|---|
All seven |
Done |
Internal |
Done |
Sphinx |
Done |
|
Done |
CHANGELOG.md |
Done |
No pending |
Done (only |
Vitest 4.1.8+ (GHSA-5xrq-8626) |
Done |
|
Verified locally (2026-06-01) |
|
Verified locally (2026-06-01) |
|
Verified locally (2026-06-01) |
|
0 vulnerabilities (2026-06-01; 3 moderate dev-only Storybook/uuid on full audit) |
Git tag |
Create when ready — triggers npm publish |
Do not create or push a
v1.0.2git tag until you intend to publish that version to npm.
1.0.1 checklist (ready to publish)¶
Item |
Status |
|---|---|
All seven |
Done |
Internal |
Done |
Sphinx |
Done |
|
Done |
CHANGELOG.md |
Done |
No pending |
Done (only |
|
Done — CI run 26723716648 (2026-05-31) |
|
Verified locally (2026-05-31) |
|
Verified locally (2026-05-31) |
|
Verified locally (2026-05-31) |
|
0 vulnerabilities (2026-05-31) |
Git tag |
Create when ready — triggers npm publish |
Do not create or push a
v1.0.1git tag until you intend to publish that version to npm.
1.0.0 checklist (before tagging)¶
Item |
Status |
|---|---|
|
Done — CI run 26691621420 (2026-05-30) |
All seven |
Done |
Deprecated APIs removed ( |
Done |
|
Done |
MIGRATION-0.x-to-1.0.md reviewed |
Done |
CHANGELOG.md |
Done |
Sphinx |
Done |
|
Done (local, 2026-05-30) |
|
Done (local, 2026-05-30) |
|
Done (local, 2026-05-30) |
No pending |
Done (only |
|
Done |
npm latest is still 0.9.3 (1.0.0 not published yet) |
Verified 2026-05-30 |
Git tag |
Not created — create when ready to publish to npm |
Do not create or push a
v1.0.0git tag until you intend to publish to npm.
1.0.0-beta.1 checklist (before tagging)¶
Item |
Status |
|---|---|
|
Required |
All seven |
Done (local) |
Done |
|
CHANGELOG.md |
Done (local) |
Sphinx |
Done (local) |
|
Required before tag |
0.9.3 checklist (before tagging)¶
Item |
Status |
|---|---|
|
Required — verify on push |
All seven |
Done (local) |
|
Done (local) |
|
Historical (1.0 uses |
CHANGELOG.md |
Done (local) |
Sphinx |
Done |
|
Done (local, 2026-05-29) |
|
Done (local, 2026-05-29) |
No pending |
Done (only |
Commit all release changes on |
Required before tag |
Git tag |
Create when ready to publish to npm |
Do not create or push a
v0.9.3git tag until you intend to publish to npm.
0.9.2 checklist (shipped)¶
0.9.1 checklist (before tagging)¶
Item |
Status |
|---|---|
|
Required — verify on push |
All seven |
Done (local) |
|
Done (local) |
|
Done ( |
|
Done (local, 2026-05-29) |
|
Done (local, 2026-05-29) |
CHANGELOG.md |
Done (local) |
Sphinx |
Done |
|
Done (local, 2026-05-29) |
No pending |
Done (only |
Commit all release changes on |
Required before tag |
Git tag |
Create when ready to publish to npm |
Do not create or push a
v0.9.1git tag until you intend to publish to npm.
0.9.0 checklist (shipped)¶
Item |
Status |
|---|---|
Git tag |
Published |
0.9.0 checklist (before tagging)¶
Item |
Status |
|---|---|
|
Done (CI run 26645268211 on |
All seven |
Done |
|
Done |
|
Done ( |
|
Done (2026-05-29) |
|
Done (2026-05-29) |
Local release prep: |
Done (2026-05-29) |
CHANGELOG.md |
Done |
Sphinx |
Done |
No pending |
Done (only |
Git tag |
Create when ready to publish to npm |
Do not create or push a
v0.9.0git tag until you intend to publish to npm.
0.8.2 checklist (shipped)¶
Item |
Status |
|---|---|
Git tag |
Published |
0.8.1 checklist (shipped)¶
Item |
Status |
|---|---|
Git tag |
Published |
0.8.0 checklist (before tagging)¶
Item |
Status |
|---|---|
|
Required |
All seven |
Required |
|
Required |
|
Required |
CHANGELOG.md |
Required |
Block catalog reference docs complete |
Required |
|
Required |
Golden example packages via |
Required |
|
Required |
No pending |
Required |
Git tag |
Create on publish |
|
Required for Release workflow |
Notes for 0.8.0 consumers: @lessonkit/cli package LMS targets required Node.js 20+ (same as @lessonkit/lxpack at that release). 1.0.0+ requires Node.js 18+ for LMS packaging. Dev/build work on Node 18+ across releases. Import the block catalog via @lessonkit/react/block-catalog.v1.json.
Do not create or push a
v0.8.0git tag until you intend to publish to npm. Tagging triggers the Release workflow.
Publish to npm (tag-based)¶
Confirm locally:
npm ci npm run build npm test npm run typecheck npm run coverage npm run package:scorm12 -w lessonkit-example-lxpack-golden npm run package:standalone -w lessonkit-example-lxpack-golden
Commit and push any release-prep changes on
main.When ready to publish, create and push the version tag (triggers Release workflow):
git tag v1.0.1 git push origin v1.0.1
Verify the Release workflow on GitHub Actions and packages on npm.
The release job sets each LessonKit package version from the tag, aligns @lessonkit/* dependency ranges, builds, and runs npm publish for all seven packages. Requires the NPM_TOKEN repository secret (publish access to the @lessonkit org).
After release¶
Confirm npm shows
1.0.1for each@lessonkit/*package.Optional: create a GitHub Release from the tag with notes copied from CHANGELOG.md.
Changesets¶
changeset version / changeset publish are available for future workflows but are not used for the current tag-based publish path. Do not run changeset version on a branch that is already at the target version unless you intend to bump again.