Extension Development

Tuna extensions add searchable items, actions, settings, connections, and app-specific behavior. They are macOS frameworks written in Swift against TunaKit.

These public-beta developer docs target Tuna 0.80 and TunaKit 1.14.0.

• Building an Extension — start from the template and build a complete extension
• Extension API — catalog of the supported TunaKit extension surface
• Extension Declaration and Manifest — every declaration and bundle field
• Extension Distribution — test, package, and propose an extension for the store

The Tuna Extension Starter and first-party examples are public under the MIT License, copyright Mikkel Malmberg. TunaKit source remains proprietary, copyright Mikkel Malmberg; its released compiled binary is free to use for building Tuna extensions and themes.

TunaKit’s supported API is currently public beta. Minor releases may include documented source-breaking improvements; pin it up to the next minor release and read the changelog before updating.