AppBuilder Package

AppBuilder is Zango's frontend framework package. It provides the React shell, routing, navigation, theming, and authentication UI that every Zango app's frontend is built on.

What It Does

Responsibility	How
React app shell	ZangoApp component wraps your entire frontend
Routes & pages	Configured in App Panel → Packages → AppBuilder
Sidebar navigation	Menu items configured per user role in App Panel
Theme (colours, fonts)	Set per app in App Panel
Auth UI (login, 2FA, role selection)	Built-in, customisable via authConfig props
App initializer API	GET /appbuilder/initializer/ — serves routes, menus, and theme to the React app at runtime

How It Fits Together

App Panel  ──→  configure routes, menus, theme
                        ↓
         /appbuilder/initializer/ API
                        ↓
         ZangoApp (React) — renders sidebar,
         routes pages, applies theme
                        ↓
         Your custom pages + CrudHandler pages

Install Order

AppBuilder must be installed first — CRUD and Workflow depend on it:

appbuilder → crud → workflow

Sections

Section	Description
Installation	Install via App Panel
Frontend Setup	Scaffold the React app and connect it to your backend
Routes & Menus	Add pages and configure navigation in App Panel
Theming	Colours, typography, logo
Auth Customisation	Login page, 2FA, OAuth providers
ZangoApp Reference	All props for the root component