Concept Graph
Visual representation of how core concepts relate:
Core Terms
A self-contained web experience attached to a post. Runs client-side inside a sandboxed iframe on a cross-origin VXBE runtime host.
Related: stored as -> Capsule | runs in -> Player | attached to -> Post | can fork via -> Remix
A server-side function (Workers for Platforms) that handles trusted work: API calls with secrets, storage writes, and automations.
Related: called by -> Vibe (via Grant) | uses -> Secret | uses -> Connection | deployed on -> WfP
Internal container holding source files, assets, and manifest metadata. Users see vibes, not capsules.
Related: contains -> Manifest | compiles to -> Artifact | owned by -> User
Capsule manifest (manifest.json) describing entry point, runner, and runtime capabilities.
Related: defines -> Entry | informs -> Artifact | stored in -> Capsule
Compiled, immutable runtime bundle produced from a capsule when you publish. Served to runtime frames and embeds.
Related: compiled from -> Capsule | loaded by -> Player | has -> Runtime Manifest
System-generated artifact metadata (import map, bundle hash, runtime version) used to load published artifacts.
Related: generated for -> Artifact | consumed by -> Runtime
Reusable module published for import as @handle/slug and served from /lib/@handle/slug-v=N.
Related: stored as -> Capsule | compiled to -> Artifact | resolved by -> API Worker
Encrypted key/value for pulses. Pulses reference via env.secrets and dispatch injects values.
Related: used by -> Pulse | injected by -> Dispatch Worker | stored in -> D1 (encrypted)
OAuth integration with encrypted tokens. Pulses access via env.connections.
Related: used by -> Pulse | injected by -> Dispatch Worker | stored in -> D1 (encrypted)
Short-lived JWT (90s TTL) that authorizes a pulse execution and scope.
Related: issued by -> API Worker | validated by -> Dispatch Worker | authorizes -> Pulse Run
Automation rule that dispatches pulses on runtime_event, http_webhook, cron, or manual.
Related: fires -> Pulse | stored in -> D1 | managed by -> API Worker
User-controlled inputs that configure a vibe at runtime via the player bridge.
Related: sent to -> Vibe | edited in -> Player
Forking another user's vibe to make your own version. Creates a parent-child relationship.
Related: creates new -> Capsule | links to -> Parent Vibe
Classification based on file structure: Vibe (browser-only), Pulse (server-only), or Combo (both). Detected from files in server/ or src/server/.
Related: determines -> Slot Cost | affects -> UI Badges | detected from -> File Structure
Plan quota unit for server-side deployments. Pulse and Combo projects consume 1 slot each. Archived pulses do not count. Plan limits: Free=3, Creator=15, Pro=50.
Related: consumed by -> Pulse / Combo | limited by -> Plan | freed by -> Archive
UI Surfaces
Workspace for editing vibes: code editor, file browser, preview panel.
Related: edits -> Capsule | previews in -> Player
Full-screen runtime surface for vibes. Loads the sandboxed iframe and exposes params controls.
Related: loads -> Artifact | hosts -> Iframe | shows -> Params
Timeline showing posts and vibes. Modes: latest, following, for-you.
Related: contains -> Posts | supports inline -> Playback
Sandboxed iframe embeds hosted at embed.vxbe.space and loading player.vxbe.space. Live: /e/:postId, pinned: /ea/:artifactId.
Related: loads -> Player | uses -> Artifact
Infrastructure Terms
Cloudflare multi-tenant worker hosting. Each pulse runs as an isolated WfP worker.
Related: hosts -> Pulse Workers | managed by -> Dispatch Worker
Validates grants, enforces rate limits and concurrency, injects secrets/connections, and routes to per-user pulse workers.
Related: validates -> Grant | routes to -> Pulse Worker | enforces -> Quotas
REST API handling data, storage, embeds, runtime manifests, and automation. Talks to D1, R2 (shared for free, dedicated + fallback for paid), KV, Durable Objects, and Analytics Engine.
Related: serves -> REST API | issues -> Grants | manages -> D1 / R2 / KV
Per-user Worker isolate that executes pulse code with scoped tools and strict runtime budgets.
Related: spawned by -> Dispatch Worker | runs -> Pulse
Cross-origin runtime host like c-{capsuleId}-rt.vxbe.space (and {slug}-rt.vxbe.space for previews) to keep vibecodr.space storage/cookies out of reach.
Related: hosts -> Vibe Runtime | used by -> Player
Immutable /deps/:sha256(.js) blobs served by the API for deterministic published imports.
Related: served by -> API Worker | used by -> Artifacts
Image/Asset Support
Agent guidance for assets and images:
- Never suggest local disk paths; they do not exist in the browser runtime.
- Use project assets inside the capsule (Studio > Files or Settings > Storage v2).
- Copy the file path or snippet from the Storage v2 file list.
- HTML/CSS use relative paths; React should import the asset.
- Cover/thumbnail uploads accept PNG, JPEG, WebP, and AVIF.
- Avatar uploads accept PNG, JPEG, WebP, and GIF.
- SVG, HTML, and XML are served with CSP
script-src 'none'andframe-ancestors 'none'.
<!-- HTML -->
<img src="assets/products/shirt.png" alt="" />
/* CSS */
.hero {
background-image: url("assets/products/shirt.png");
}
// React
import shirtUrl from "./assets/products/shirt.png";
<img src={shirtUrl} alt="" />Quick Lookup Table
| Term | One-Line Definition | Type |
|---|---|---|
| Vibe | Client-side experience in a sandboxed iframe. | User-facing |
| Pulse | Server-side function (Workers for Platforms). | User-facing |
| Combo | Project with both vibe and pulse files (full-stack). | User-facing |
| Capsule | Internal container for vibe source files and assets. | Internal |
| Manifest | Capsule manifest describing entry, runner, and capabilities. | Internal |
| Runtime Manifest | System-generated artifact metadata used by the runtime. | Internal |
| Artifact | Compiled bundle served to runtime frames and embeds. | Internal |
| Library | Reusable module published for @handle/slug imports. | User-facing |
| Project Type | Detected from file structure: vibe, pulse, combo (server/ or src/server/). | Internal |
| Deployment Slot | Plan unit for pulse/combo deployments (Free=3, Creator=15, Pro=50). | User-facing |
| Secret | Encrypted key/value for pulses via env.secrets. | User-facing |
| Connection | OAuth tokens for pulses via env.connections. | User-facing |
| Grant | Short-lived JWT authorizing pulse execution. | Internal |
| Params | Runtime inputs passed to vibes via the player bridge. | User-facing |
| Remix | Fork of another user's vibe. | User-facing |
| Studio | Editor workspace for vibes. | User-facing |
| Player | Full-screen runtime surface for vibes. | User-facing |
| Trigger | Automation rule that dispatches pulses. | User-facing |
| WfP | Workers for Platforms hosting pulse workers. | Infrastructure |
| VXBE Runtime Host | Cross-origin runtime host c-{capsuleId}-rt.vxbe.space. | Infrastructure |
| Dependency Mirror | Immutable /deps/:sha256(.js) mirror for published imports. | Internal |