Updates and Startup

Startup and update issues are the main app-level failures in Tunedance.

The App Fails To Load

If Tunedance fails to initialize, the app shows a startup error screen with a Retry button.

Use that retry action first. The startup sequence includes:

• session refresh
• auth and subscription fetch
• theme initialization
• updater initialization
• tab restoration

If one of those steps fails badly enough, the app shows the load failure state instead of rendering a broken shell.

Update Check Fails

If the updater cannot reach the update service, Tunedance records the updater error and can show messages such as:

• could not reach the update server
• could not check for updates

This does not usually block the rest of the app.

Update Download Or Install Fails

If an update is found but download or installation fails, the updater moves into an error state and shows a failure message rather than pretending the update is ready.

Browser Preview Limitation

Update management only works in the desktop app.

If you are viewing the updates page outside the desktop environment, Tunedance makes that limitation explicit instead of allowing update actions to proceed.

Best Recovery Path

For startup and update problems:

1. retry startup once from the app
2. restart the desktop app
3. check your connection if update checks are failing
4. retry the update from the Updates page after the app is stable