Creator docs

Build a VIBEZ pack

VIBEZ Studio is a declarative theme instrument — not a freeform code sandbox. You compose allowlisted layers, accents, chrome, and backgrounds into a package that themes Lyricist, Soundscape, WOVEN, and Interlace safely.

1. Product anatomy

  • Accent — atomic colors (primary / secondary / intensity). Cheap, remixable, reusable inside packs.
  • Vibe pack — composed look: accent + chrome + surface + background + optional WebGL layers / live wallpaper.
  • Live wallpaper — canvas/WebGL backdrop with user-tunable speed, density, and style variants.
  • Engine preset — allowlisted motion recipes from the official catalog (not custom GLSL uploads).

2. Security tiers

Everything sellable and live-installable must stay in the safe tiers:

  • T0 Declarative — JSON layers, params, theme chrome. Auto-approved.
  • T1 Allowlisted engine — official presets + uniforms. Auto-approved.
  • T2 Node Forge — visual allowlisted shader graph in the editor (no free-text GLSL). Compiles to safe recipes only.
  • T3 Raw CSS/GLSL — never auto-applied to installers. Preview-only quarantine; ThemeProvider blocks marketplace CSS injection.

Do not paste arbitrary JavaScript, remote scripts, or raw CSS into packages. Those paths are blocked by design so the marketplace cannot be exploited.

3. Creation workflow

  1. Open /studio/create and pick a reactivity source (time, scroll, or pointer).
  2. Add layers (glow, particles, aurora, spectrum…) and tune opacity, blend, springs.
  3. Animate with declarative tracks (time → value keyframes) — not raw CSS @keyframes.
  4. Optional: open Node Forge for allowlisted shader graphs (T2).
  5. Attach a theme package / accent and chrome skin for cross-app CSS vars.
  6. Upload cover art, set a price (cents), tags, and publish.
  7. Share deep links — installers activate the pack across apps that run Vibez.

4. Marketplace kinds

Browse facets: Theme · Pack · Live Wallpaper · Accent · Shader · Icon Set · Animation. Official live wallpapers ship as free productKind=WALLPAPER listings (wallpaper-warm-bokeh, etc.). Embed the marketplace widget from @woven/vibes-marketplace in any Vibez host.

5. Updates & competition

Packs are versioned products (productVersion). Ship additive improvements so owners stay current; breaking changes should bump a major version and ask installers to accept. Purchases are per pack — updates stay free for owners.

6. Publish checklist

  • Preview on canvas + at least one host mock (Soundscape / Lyricist).
  • Readable cover art; clear name + tagline.
  • Tags for mood / category; changelog if updating.
  • Price in whole cents (BigInt economics on the backend).
  • No raw CSS keyframes or external script URLs in the package.
  • Node Forge graphs must stay within allowlisted nodes + compile caps.

Architecture · Warm Obsidian · Declarative by default