Kajabi Gamification README

GamifyKit for Kajabi

Course gamification theme pack for Kajabi — badges, XP/levels, learning paths, certificates,

confetti, announcement bar — with an optional **hosted Pro add-on** for cross-device sync,

real course leaderboards, quiz-gated paths, and creator analytics.

Standalone package inside the Wize repo. It is **not** part of the Astro build (Astro only

compiles src/). The Pro backend lives in the main app under src/pages/api/gamify/*.

Layout

theme/ Kajabi Liquid theme (layout, templates, sections, snippets, assets, config)

skins/ design overlays merged over theme/ at build time (editorial-wize, clean-pro)

docs/ positioning, Jiffy gap analysis, verification notes, customer docs

demos/ demo course structures (wize-school)

scripts/ build-theme-zip.mjs, validate-theme.mjs

Build

node scripts/validate-theme.mjs # lint structure + schema + reserved-name rules

node scripts/build-theme-zip.mjs # base theme -> dist/gamifykit-base-*.zip

node scripts/build-theme-zip.mjs --skin editorial-wize # with skin overlay

Upload the resulting zip in Kajabi: **Design → Saved Templates → Upload Template**.

Architecture

• **State adapter** (theme/assets/gamify-engine.js): LocalAdapter (v1, localStorage) ↔

ApiAdapter (Pro). Switched by settings.gamify_mode.

• **Progress** is read from Kajabi's native completion object — never re-stored.
• **Badges/XP/unlocks** are managed by the engine and persisted via the active adapter.

See [docs/positioning.md](docs/positioning.md), [docs/jiffy-checklist.md](docs/jiffy-checklist.md),

and [docs/verification-notes.md](docs/verification-notes.md). Full plan: ~/.claude/plans/crystalline-dazzling-wombat.md.