Skip to main content

Shuuka builder documentation

Build apps and themes that install cleanly in Shuuka.

A public bundle specification for uploaded apps and themes, with runtime values, settings schemas, and release rules.

Read the docs See the upload checklist

What the platform gives you

A stable model for uploaded extensions

Installer-first contract

Builders work from the uploaded bundle contract: manifest, entry file, required images, and optional schema files.

Schema-driven admin by default

Most apps can ship settings pages and collected-data forms without custom backend work.

Theme-aware runtime values

Apps and themes both receive a clear public runtime contract instead of requiring hardcoded internal paths.

Builder journey

Read in this order

1. Understand the platformDecide whether you are building an app or a theme and see what Shuuka owns.2. Prepare the upload packageRequired files, image rules, built output, and ZIP structure for apps.3. Add settings and formsUse `settings.json`, `settings-global.json`, and `inputs.json` before reaching for custom admin UI.4. Pass reviewValidate privacy, assets, and package completeness before submission.