Partner guide¶

A Yukon extension is an installed Frappe application that publishes a small, versioned contract to the Yukon shell. It is trusted tenant code: installation, frontend exposure, and user authorization are separate decisions.

The supported boundary¶

Partners may build:

• namespaced pages and navigation;
• permission-checked APIs in the partner application;
• background jobs and provider webhooks with their own security controls;
• form controllers when extension API 2 is available;
• app-owned DocTypes, roles, fixtures, and patches.

Partners must not depend on Yukon controllers, registries, query implementations, database layout, or frontend source. A whitelisted server method is not automatically a supported partner API.

Before you begin¶

1. Confirm your target versions in the compatibility matrix.
2. Create a standalone Frappe app with its own namespace and licence.
3. Follow the extension quickstart.
4. Apply the backend and security contract.
5. Complete the test and publishing checklist.