Skip to content

feat(gui): close packaging, release & docs gaps (#106)#138

Merged
PAMulligan merged 2 commits into
mainfrom
106-packaging-distribution
Jun 21, 2026
Merged

feat(gui): close packaging, release & docs gaps (#106)#138
PAMulligan merged 2 commits into
mainfrom
106-packaging-distribution

Conversation

@PAMulligan

Copy link
Copy Markdown
Collaborator

Closes #106. Part of #100. Milestone v3.0.0. Final GUI sub-issue.

electron-builder config (mac/win/linux targets) and the README reference shipped
earlier. This PR adds the release integration, multi-OS artifact builds, the
packaged smoke test, and the walkthrough docs.

  • Versioning (no hand-bump): packages/gui/package.json $.version is now an
    extra-files entry in release-please-config.json, so release-please bumps it
    with the repo's git-tag-driven version.
  • CI artifact builds on release: .github/workflows/gui-release.yml builds
    .dmg / .exe / .AppImage (matrix) on a published release, smoke-tests each,
    and uploads them to the release with gh.
  • Packaged smoke test: tests/smoke/smoke.mjs launches the built app via
    Playwright _electron and asserts it reaches the setup view — verified locally,
    and run on every GUI PR (new smoke job in gui.yml, via Xvfb) and before each
    release upload.
  • Docs: docs/GUI.md adds a first-run → activated-theme walkthrough + the
    versioning/release notes, and corrects the now-shipped "Open project folder" picker.

Criteria

  • Installable builds for macOS, Windows, Linux — config + release CI
  • Build/release integrated with release-please (no hand-bumped versions) — this PR
  • docs/GUI.md covers install, first run, full walkthrough — this PR
  • README.md references the GUI as a v3.0.0 capability — earlier
  • CI builds GUI artifacts on release — this PR
  • Smoke test verifies a packaged build launches & reaches the setup view — this PR

Stacked on #105#103#104#102#133 → main (merge in that order).

🤖 Generated with Claude Code

…ning (#106)

Closes the packaging/distribution/documentation sub-issue.

- Versioning: release-please now syncs packages/gui/package.json $.version (added
  as an extra-file in release-please-config.json), so the GUI version tracks the
  git-tag-driven release and is never hand-bumped.
- Release CI: .github/workflows/gui-release.yml builds installers for macOS
  (.dmg), Windows (.exe), and Linux (.AppImage) on a published release (matrix),
  smoke-tests each, and uploads them to the release via gh.
- Packaged smoke test: tests/smoke/smoke.mjs launches the built Electron app with
  Playwright's _electron and asserts it reaches the setup view; wired into a new
  smoke job in gui.yml (Xvfb) so it runs on every GUI PR, and into the release
  build before upload. Verified locally.
- Docs: docs/GUI.md gains a first-run → activated-theme walkthrough and the
  versioning/release-artifact notes, and corrects the now-shipped "Open project
  folder" picker description.

electron-builder packaging config + README reference shipped earlier; this adds
multi-OS artifact builds, the release-flow integration, and the launch smoke test.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@PAMulligan PAMulligan added this to the v3.0.0 milestone Jun 21, 2026
Base automatically changed from 105-conversion-qa-view to main June 21, 2026 05:09
@PAMulligan PAMulligan self-assigned this Jun 21, 2026
@PAMulligan PAMulligan merged commit f51cb1f into main Jun 21, 2026
21 checks passed
@PAMulligan PAMulligan deleted the 106-packaging-distribution branch June 21, 2026 05:16
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.

Packaging, distribution & documentation

1 participant