Journey Realtime

This is stage 3h in the Butterbase journey that enables WebSocket subscriptions on the tables you listed in your plan. It reads the Realtime section from 02-plan.md, asks you to confirm, then delegates to the realtime skill which calls manage_realtime to configure each table. The skill skips entirely if your plan has no realtime needs and marks itself (n/a). One thing to watch: it will happily enable realtime on tables whose RLS policies aren't ready yet, so clients connect but see nothing. The preflight check ensures your app_id exists and docs are current before touching any live configuration.

GitHub stars: 532
last updated: Jun 11, 2026

View on GitHub

Install

$ npx -y skills add butterbase-ai/butterbase-skills --skill journey-realtime --agent claude-code

Installs into .claude/skills of the current project.

Files

Journey: Realtime

Stage 3h of the guided journey. Enable WebSocket subscriptions per the plan.

When to use

Dispatched by journey when current_stage: realtime.
Directly via /butterbase-skills:journey-realtime.
Skipped (annotated (n/a)) if the plan has no Realtime section.

Preflight

If docs/butterbase/03-preflight.md is missing, older than 24 hours, or 00-state.md has app_id: null, invoke butterbase-skills:journey-preflight first. Wait for it to return successfully before proceeding.

Inputs

docs/butterbase/02-plan.md — the Realtime section.
docs/butterbase/00-state.md — for app_id.

Procedure

Refresh docs. Call butterbase_docs with topic: "realtime". For WebSocket subscription shape and RLS interaction, also WebFetch https://docs.butterbase.ai/realtime. Skip if cache is fresh.

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly