About, versions and diagnostics

Applies to Workletto 1.x.

The About page

Click the picture to zoom in.Close

Open Manage, then About. Only admins see it. It shows:

• The version installed here.
• What that version changed, from the app’s change notes, grouped under headings such as Added, Fixed and Database.
• The database: how many database changes have been applied and when the latest was. Each update can change the database; the change notes say whether it does.
• A warning if a database change didn’t finish, for example because an update was interrupted. Restore your backup, then download the diagnostics file to look into it. See Back up and restore.

Version numbers

Versions look like 1.4.2 (Semantic Versioning). Before the first public release they start with 0, such as 0.8.0, and anything can still change. From 1.0.0 on:

• The last number (1.4.2 to 1.4.3) is a fix.
• The middle number (1.4 to 1.5) adds something and keeps working as before.
• A new first number (1 to 2) can change how things work, and says so.

Updates within a major version, such as every 1.x release, come through the Update app workflow in your own GitHub repository. Run it from the repository’s Actions tab; it opens a pull request, and nothing changes in your running app until you merge it. Take a backup first: the workflow asks you to confirm that you have one.

Click the picture to zoom in.Close

Updates are checked

The Update app workflow downloads a release signed by the app’s makers and refuses one that isn’t. It checks the signature against the key in .github/update-app/allowed_signers, which your repository already has. A release without a signature, or signed with another key, is not applied, and the workflow’s log says so.

The diagnostics file

When you, a developer or an AI coding assistant look into a problem, click Download diagnostics on the About page. It is a small text file (JSON) that has:

• the app version, the Node.js version, the system, how long the app has been running, its memory use, and the time zone;
• the Postgres version and the database changes applied, with any unfinished ones;
• which features are set up: whether the address uses HTTPS, the number of trusted proxies, whether email is on and working, whether Stripe is connected (test or live, and whether Stripe’s notifications are registered) and working.

It does not have passwords, keys, web addresses, email addresses, names or any of your business data.

The app never sends this file anywhere. It is made when you click, and goes nowhere unless you send it yourself.

The donation card

Workletto is free. Fourteen days after setup, once your team has tracked time, admins see a card at the top of the Time screen: Workletto is free, but building and running it isn’t. It has two buttons:

• Donate opens Workletto’s donation page in a new tab.
• Don’t show again closes it.

Either button removes the card for good, for every admin. Managers and members never see it.

The About page also has a make a donation link at the bottom.

The app doesn’t record or send whether anyone donated. The card and the link open a web page; nothing else leaves your server.