Platform Overview

Shuuka has two public extension types.

Extension	Build this when you need	Runs where
App	A feature with its own UI and logic	Inside the installed app runtime, owner admin tabs, or shareable public pages
Theme	A full profile presentation layer	Inside the theme runtime iframe

What Shuuka Owns

Shuuka owns the platform layer:

• runtime bootstrapping
• app and theme discovery
• asset delivery
• per-installation storage
• public and admin routing
• profile data shaping
• preview and live-update flows

What Builders Own

Builders own the package itself:

• HTML, CSS, and JavaScript
• manifest.json and, for themes, theme.config.json
• UI behavior and visual design
• privacy declarations for external domains
• the built files inside the uploaded ZIP bundle

Non-Negotiable Rule

External builders should not depend on raw internal API route strings.

Use platform-provided contracts instead:

• Apps: window.__shuukaCtx.shkApi or window.ShuukaApi
• Themes: template variables, CSS variables, and SDK runtime helpers

Recommended Reading Order

For app developers

1. App quickstart
2. App configuration surfaces
3. React apps
4. App package checklist
5. App manifest
6. App instance settings
7. App global settings and forms
8. App admin pages
9. App platform values
10. App data, storage, and access
11. App design and UX

For theme developers

1. Theme quickstart
2. Theme manifest
3. Theme platform values
4. Theme app-card integration

Before release

• Release checklist