Journey Auth

Handles the OAuth setup stage in a Butterbase project build after you've already defined your schema. It reads your auth plan from 02-plan.md, then delegates to auth-setup to walk you through configuring each provider (Google, GitHub, Apple) by prompting for client IDs and secrets. The nice part is it confirms what you're about to do before touching anything, then hands back the redirect URLs you need to paste into each provider's console. Gets skipped entirely if your plan doesn't need end-user auth. One thing to watch: it won't echo secrets back to you, so have your provider dashboards open when you run it.

GitHub stars: 532
last updated: Jun 11, 2026

View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

Journey: Auth

Stage 3c of the guided journey. Configure OAuth providers and (optionally) auth hooks.

When to use

Dispatched by journey when current_stage: auth.
Directly via /butterbase-skills:journey-auth.
Skipped (annotated (n/a) in 00-state.md) if the plan has no end-user auth.

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 Auth section.
docs/butterbase/00-state.md — for app_id.

Procedure

Refresh docs. Call butterbase_docs with topic: "auth". For provider-specific setup (Google/GitHub/Apple), also WebFetch https://docs.butterbase.ai/auth. Skip if cache is fresh.

SKILL.md on GitHub

Sponsors

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