Quick Look Troubleshooting

Finder can keep stale Quick Look state after an app update, reinstall, or local development build.

Reset Quick Look

First open Burette once from Applications, close the existing Finder preview, and run Reset Quick Look from Burette’s command palette. Reopen the preview.

If it still fails, the equivalent manual cache reset is:

qlmanage -r
qlmanage -r cache
killall quicklookd 2>/dev/null || true

Then select a supported molecular file in Finder and press Space again.

Common failure points

• The app was rebuilt but not reinstalled into the location Finder is using.
• Quick Look cache was not refreshed after replacing the app.
• The final app bundle does not contain BurettePreview.appex.
• The final app bundle does not contain BuretteThumbnail.appex.
• Vendored web assets are missing or stale.
• Launch Services is still pointing at an older app bundle.
• The selected file type is not registered to the expected content type.

Developer builds

For local packaged testing, use a unique BURETTE_DEV_FLAVOR value so the installed app, extension IDs, container paths, and forced content types do not collide with the release namespace or another dev install.

Example:

BURETTE_DEV_FLAVOR=docs-check ./scripts/build.sh
BURETTE_DEV_FLAVOR=docs-check ./scripts/install.sh