- Added new Tauri plugins: @tauri-apps/plugin-process and @tauri-apps/plugin-updater to improve application capabilities. - Introduced UpdateStatus component to display update information in the UI. - Enhanced GenerationForm to include an optional instruct field for additional input. - Refactored various components for improved styling and responsiveness, including Sidebar, AudioPlayer, and ProfileCard. - Updated API models and schemas to accommodate new instruct parameter in generation requests and responses. - Improved documentation for autoupdater setup and usage.
3.2 KiB
Autoupdater Quick Start
The Tauri v2 autoupdater has been fully configured and integrated. Follow these steps to activate it.
What's Already Done
✅ Rust plugin installed and initialized ✅ Tauri configuration set up with updater settings ✅ Permissions granted for update operations ✅ GitHub Actions workflow updated with signing support ✅ Frontend components created and integrated ✅ Update notifications on app startup ✅ Manual update check in Settings tab
Required Steps (5 minutes)
1. Generate Signing Keys
bun run generate:keys
This creates:
- Private key:
~/.tauri/voicebox.key(keep secret!) - Public key:
~/.tauri/voicebox.key.pub(safe to share)
2. Update Tauri Config
Open tauri/src-tauri/tauri.conf.json and:
- Replace
"REPLACE_WITH_YOUR_PUBLIC_KEY"with the content from~/.tauri/voicebox.key.pub - Update the endpoint URL with your GitHub username:
"endpoints": [ "https://github.com/YOUR_USERNAME/voicebox/releases/latest/download/latest.json" ]
3. Add GitHub Secrets
Go to your repo Settings → Secrets and variables → Actions:
-
Add
TAURI_SIGNING_PRIVATE_KEY:cat ~/.tauri/voicebox.keyCopy the entire output and paste as the secret value
-
Add
TAURI_SIGNING_PRIVATE_KEY_PASSWORD: Leave empty (or add your password if you set one)
4. Test the Setup
To test locally before creating a release:
bun run build:release
This will verify your keys are set up correctly.
How It Works
For Users
- App checks for updates on startup (only in Tauri builds)
- If an update is available, a banner appears at the top
- Users can click "Install Now" to download and install
- App restarts automatically after installation
For Developers
- Create a new git tag:
git tag v0.2.0 && git push --tags - GitHub Actions builds signed releases for all platforms
- Uploads installers and generates
latest.jsonmanifest - Users running older versions will be notified automatically
UI Components
Update Notification Banner
- Shows at top of app when update is available
- Appears automatically on startup
- Displays download/install progress
Settings Panel
- Located in Settings tab
- Shows current version
- Manual "Check for Updates" button
- Update status and progress
Troubleshooting
"Public key not configured"
- Make sure you copied the entire content from
voicebox.key.pub - The key should start with
dW50cnVzdGVkIGNvbW1lbnQ6
"Failed to check for updates"
- Endpoint URL might be incorrect
- No releases published yet (expected for first setup)
Build fails with signing error
- Check that GitHub secrets are set correctly
- Verify private key file exists at
~/.tauri/voicebox.key
Next Release Workflow
- Update version in
tauri/src-tauri/tauri.conf.json - Commit changes
- Create and push tag:
git tag v0.2.0 && git push --tags - GitHub Actions will automatically build and create a draft release
- Review the release and publish it
- Users will be notified of the update
See Also
- Full documentation:
docs/AUTOUPDATER.md - Build script:
scripts/prepare-release.sh - GitHub workflow:
.github/workflows/release.yml