Release Commands

Info

This document covers the release and changelog commands for publishing eIsland builds and generating release notes. For packaging the installer locally, see Package Commands.

All commands are run from the web/ directory:

cd web
npm run <script>

Warning

All scripts that invoke .ts files use node --experimental-strip-types for native TypeScript execution. This requires Node.js 22+. See Frontend Setup — Prerequisites.

Changelog Generation

release:notes

Generates incremental release notes from git history since the last tag.

npm run release:notes

Under the hood: node --experimental-strip-types scripts/generate-incremental-release-notes.ts -o RELEASE_NOTES_SINCE_LAST_TAG.md

Output: RELEASE_NOTES_SINCE_LAST_TAG.md in the project root.

When to use:

• After merging PRs, before creating a release
• To review what changes will be included in the next release

changelog:generate

Generates a full changelog from the entire git history.

npm run changelog:generate

Under the hood: node --experimental-strip-types scripts/generate-changelog.ts -o docs/CHANGE_LOG.md

Output: docs/CHANGE_LOG.md

Note

Unlike release:notes (incremental), this regenerates the complete changelog. Use it for periodic maintenance, not for every release.

Upload Commands

Caution

Upload commands are for maintainer use only. Regular developers do not have permission to upload build artifacts to remote storage (COS / MinIO). Use npm run package locally to verify the installer build, but do not run release:upload* commands.

release:upload

Packages the application and uploads release artifacts to COS (Cloud Object Storage).

npm run release:upload

Under the hood: npm run package && node --experimental-strip-types scripts/upload-release-to-cos-oss.ts

When to use:

• Maintainer only — publish a new release to CDN

release:upload-only

Uploads existing build artifacts to COS without rebuilding.

npm run release:upload-only

Under the hood: node --experimental-strip-types scripts/upload-release-to-cos-oss.ts

When to use:

• Maintainer only — re-upload a previously built package (e.g., after a CDN issue)

Tips

Use this instead of release:upload when you have already built the package and just need to re-upload. It skips the build step, saving time.

release:upload-minio

Uploads artifacts to MinIO storage for internal/self-hosted distribution.

npm run release:upload-minio

Under the hood: node --experimental-strip-types scripts/upload-release-to-cos-oss.ts --minio-only

When to use:

• Maintainer only — internal/self-hosted release distribution