Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Leonxlnx/todobar/llms.txt

Use this file to discover all available pages before exploring further.

Todobar releases are tag-triggered. You bump the version in several files, push a vX.Y.Z tag, and GitHub Actions takes over — building platform installers for Windows and both macOS architectures and uploading them to GitHub Releases. This page covers the version bump, the CI workflows, the release artifacts, and the current signing limitations.

​
Version files to update

Before tagging, bump the version string to the new release number in all five of these files:
FileField
package.json"version"
package-lock.jsontop-level "version"
src-tauri/Cargo.tomlversion in [package]
src-tauri/Cargo.lockversion entries for todobar
src-tauri/tauri.conf.json"version"
The npm run verify command checks that all five files agree. Run it after bumping to confirm consistency: 
npm run verify

​
Release flow

1

Bump the version

Update all five version files listed above to the new X.Y.Z number. Run npm run verify to confirm they all match.
2

Run the full validation suite

Confirm the project is in a clean, passing state before tagging:
npm run build
npm run lint
npm run test:smoke
npm run test:native
cargo check --manifest-path src-tauri/Cargo.toml
3

Commit the version bump

git add package.json package-lock.json src-tauri/Cargo.toml src-tauri/Cargo.lock src-tauri/tauri.conf.json
git commit -m "chore: bump version to X.Y.Z"
4

Tag and push

git tag vX.Y.Z
git push origin main
git push origin vX.Y.Z
Pushing the tag triggers the release.yml workflow on GitHub Actions.
5

Monitor the release workflow

Open the Actions tab on GitHub and watch the release.yml run. When it completes, the platform artifacts are attached to the new GitHub Release.

​
CI workflows

​
ci.yml

Runs on every push and pull request to main, on both Windows and macOS runners:
  • TypeScript + Vite production build (npm run build)
  • ESLint (npm run lint)
  • Project consistency check (npm run verify)
  • Playwright browser smoke tests (npm run test:smoke)
  • Rust check (cargo check)
  • No-bundle Tauri native build smoke test (npm run test:native)

​
release.yml

Triggered only when a vX.Y.Z tag is pushed. Builds full release artifacts on three matrix targets:
  • Windows (x64)
  • macOS Apple Silicon (aarch64)
  • macOS Intel (x64)

​
Release artifacts

Each release produces the following files:
ArtifactPlatform
Todobar_X.Y.Z_x64-setup.exeWindows installer
Todobar_X.Y.Z_x64_en-US.msiWindows MSI
Todobar_X.Y.Z_aarch64.dmgmacOS Apple Silicon
Todobar_X.Y.Z_x64.dmgmacOS Intel
Todobar_X.Y.Z_*.app.tar.gzmacOS app archives
Download the latest release from GitHub Releases.

​
Current limitations

macOS builds are currently unsigned and unnotarized. Gatekeeper will block the app on first open. Users need to right-click the .dmg or .app and choose Open to bypass the quarantine warning. This will be resolved when Apple Developer signing certificates and notarization are configured.
Three signing and update capabilities are not yet in place:
  • Windows code signing — the Windows .exe and .msi are unsigned. SmartScreen may warn on first run.
  • Apple notarization — macOS builds are not notarized, so Gatekeeper blocks them by default.
  • Signed auto-update channel — the Tauri updater is not yet configured with a signing key or update endpoint, so there is no automatic in-app update mechanism.
These are tracked as open issues. Contributions toward any of these are particularly welcome — see Contributing to the Todobar open source project for context.

Build docs developers (and LLMs) love

Get started for freeTalk to us