Development

The main Burette repository contains the desktop app, Quick Look extension, iPhone preview app, bundled web runtimes, agent tools, and documentation.

Set up a checkout

Install Git, Bun, Rust, Xcode, and the Vite+ CLI as described in the repository’s build guide . For frontend work:


vp install
vp dev
vp check

Native app and Quick Look builds require macOS and Xcode. A browser preview does not validate Finder registration or packaged app behavior.

File	Owns
`config/preview-formats.json`	Supported file extensions, content types, renderer routing, grid routing, Quick Look limits, and VESTA handoff flags.
`config/web-runtime-profiles.json`	Bundled web runtime assets for Tauri, Quick Look, grid, Mol*, and external-artifact profiles.
`apps/desktop/src-tauri/AppMetadata.plist`	App-level document type metadata used by the Tauri bundle.
`PreviewExtension/Info.plist`	Finder Quick Look preview extension metadata and supported content types.
`PreviewExtension/ThumbnailInfo.plist`	Finder thumbnail extension metadata and supported content types.
`apps/desktop/src-tauri/tauri.conf.json`	Tauri bundle metadata, resources, app identifiers, update config, and macOS file associations.

When a preview format or document type changes, keep the registry, plist files, and focused format tests in sync:


bun scripts/check-preview-format-registry.mjs

Use a unique development flavor for local packaged builds:


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

Then refresh Quick Look:


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