/iblai-vibe-scaffold

How an ibl.ai app gets its skeleton: the project templates that scaffold a new app or add a feature, and the steps that assemble them. The templates here record what a generated app contains; the references document the assembly steps so the skills can perform them directly — render the assets/ templates, then apply the patches described in each reference.

Do NOT add custom styles / colors to ibl.ai SDK components — they ship
with their own styling. See
BRAND.md.

Common setup (env, conventions, verification): see
docs/skill-setup.md.

Two ways in

Both map PLATFORM/TOKEN/DOMAIN from iblai.env into the NEXTPUBLIC* vars in .env.local (see [references/config-command.md](references/config-command.md)).

Prefer the starter for greenfield work. For brand-new projects,
vibe-starter (the pre-wired template bundled with /iblai-vibe-ops-init —
see the repo CLAUDE.md "Getting Started") is the recommended path; the
base+agent templates here are the manual equivalent.

Env: .env.local before build

A vibe app (scaffolded from vibe-starter or rendered from these templates) reads its config from .env.local. Always ensure one exists before pnpm build — a missing file is the usual cause of a mis-tenanted build. (vibe-starter apps carry the URL defaults in code, so only the tenant key and IBLAIAPIKEY are at stake; template-rendered apps need the full set):

[ -f .env.local ] || cp .env.example .env.local

No .env.example in the project? Seed one from this skill's canonical copy (the vibe-starter .env.example): [assets/env.example](assets/env.example). Then map PLATFORM → NEXTPUBLICMAINTENANTKEY and TOKEN → IBLAIAPIKEY from iblai.env (see [references/config-command.md](references/config-command.md)).

The templates

The Jinja2 (.j2) templates live as assets beside this skill. They use {{ variable }} placeholders you fill in when rendering (platform key, app name, agent id, …) — see [references/template-system.md](references/template-system.md) for the variable contract.

• [assets/base/](assets/base/) — the non-shared foundation:

app/(app)/{layout,page}.tsx, providers/index.tsx, store/index.ts, lib/iblai/{auth-utils,config}.ts, lib/config.ts, next.config.ts, components/ui/{button,sonner}.tsx, package.json, .env.example.

• [assets/shared/](assets/shared/) — rendered into every app

(base and agent): root app/layout.tsx, the (auth)/sso-login-complete callback, components/app-shell.tsx, providers/store-provider.tsx, hooks/use-user.ts, lib/{utils,hooks}.ts, CLAUDE.md, .mcp.json, public/env.js, the tooling configs (eslint/tsconfig/tailwind/postcss/ vitest), and the Playwright e2e/ suite.

• [assets/agent/](assets/agent/) — the agent-app overlay on top of

base+shared: a chat app/(app)/page.tsx, lib/config.ts, components.json, package.json, .env.example.

The Tauri desktop/mobile shell templates (src-tauri/, CI workflows) that the build skill renders live with it: [iblai-vibe-ops-build/assets/tauri/](../iblai-vibe-ops-build/assets/tauri/).

Per-feature templates (auth, account, analytics, chat, notification, profile) live with their skill's assets, not here — e.g. [iblai-vibe-auth/assets/](../iblai-vibe-auth/assets/), [iblai-vibe-account/assets/](../iblai-vibe-account/assets/). Icons live in [iblai-vibe-ops-build/assets/icons/](../iblai-vibe-ops-build/assets/icons/).

Feature skills

Each feature has its own skill that renders its assets and applies its patches: /iblai-vibe-auth (SSO, store, providers — run first), then /iblai-vibe-agent-chat, /iblai-vibe-profile, /iblai-vibe-account, /iblai-vibe-analytics, /iblai-vibe-notification, /iblai-vibe-ops-build, and the rest of the /iblai-vibe-* family.

Provider chain (what base wires up)

AuthProvider > TenantProvider > {children}

initializeDataLayer(dmUrl, lmsUrl, legacyLmsUrl, storageService, httpErrorHandler) is called with 5 args (data-layer v1.2+). Redux Toolkit is deduplicated via a webpack resolve.alias in next.config.ts — without it, SDK components bind a different ReactReduxContext and RTK Query hooks return undefined. The base templates encode all of this; reproduce them faithfully if scaffolding by hand.

References

• [references/add-command.md](references/add-command.md) — adding a feature by hand — the render→patch contract.
• [references/config-command.md](references/config-command.md) — .env.local reference — known variables and defaults.
• [references/template-system.md](references/template-system.md) — the Jinja2 template/variable contract.

Related skills

• [/iblai-vibe-auth](../iblai-vibe-auth/SKILL.md) — SSO auth, store, providers (run first).
• [/iblai-vibe-ops-build](../iblai-vibe-ops-build/SKILL.md) — Tauri desktop/mobile shell.
• [/iblai-vibe-ops-deploy](../iblai-vibe-ops-deploy/SKILL.md) — deploy to Vercel.
• [/iblai-vibe-ops-init](../iblai-vibe-ops-init/SKILL.md) — update a project's CLAUDE.md with platform guidance.