Skip to content

Release tested starter zips by hand - #1

Merged
coderjun merged 1 commit into
mainfrom
release-workflow
Oct 21, 2026
Merged

coderjun merged 1 commit into
mainfrom
release-workflow

Conversation

@coderjun

Copy link
Copy Markdown
Owner

What and why

Adds a way to publish versioned Bumpers starters as downloadable zips, promoted by hand.

  • Release workflow (.github/workflows/release.yml): run from the Actions tab or gh workflow run release.yml -f version=X.Y.Z. It runs pnpm check, builds bumpers-vX.Y.Z.zip with git archive, smoke-tests it by following the README quick start in a clean folder (git init, pnpm install, pnpm check), and only then tags the commit and publishes a GitHub Release. Nothing is tagged if any step fails.
  • scripts/build-starter.ts: the build and smoke test, typechecked and runnable locally without publishing.
  • .gitattributes: keeps release-only files out of the zip and GitHub's source downloads.
  • RELEASING.md, a README "Get it" section (release zip or "Use this template"), and decision record 0005.

Tested locally: pnpm check passes; the version check rejects malformed, existing, and lower versions; a full build and smoke test passed under CI=true; the zip has 52 files and none of the release-only ones.

Unrequested decisions

  • Build logic is a TypeScript script rather than inline YAML, so it's typechecked and testable locally.
  • Releases run only from main, and only in coderjun/ts-bumpers, since template copies also get the workflow.
  • The zip unpacks into bumpers-vX.Y.Z/; releases are titled "Bumpers vX.Y.Z".
  • Release notes are generated by GitHub from merged PRs.
  • The repository was marked as a GitHub template (requested; one click to undo in settings).

Diagrams

No change: no package or service changed. The release process is tooling, not part of the system the diagrams describe.

🤖 Generated with Claude Code

https://claude.ai/code/session_01QDhuY8My9jmziKrHogpQWV

A manually run Release workflow takes a version, runs pnpm check,
builds bumpers-vX.Y.Z.zip with git archive, smoke-tests it by following
the README quick start in a clean folder, and only then tags the commit
and publishes a GitHub Release with the zip. Release-only files are
export-ignored. README gains a "Get it" section; RELEASING.md and
decision record 0005 describe the process.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QDhuY8My9jmziKrHogpQWV
@coderjun
coderjun merged commit e1d56a8 into main Oct 21, 2026
3 checks passed
@coderjun
coderjun deleted the release-workflow branch October 21, 2026 19:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant