journey-frontend

# Journey: Frontend Stage 3j of the guided journey. Build (or adopt) and deploy the frontend. ## When to use - Dispatched by `journey` when `current_stage: frontend`. - Directly via `/butterbase-skills:journey-frontend`. - Skipped (annotated `(n/a)`) if `frontend_stack: none` in `00-state.md`. ## 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 Frontend section. - `docs/butterbase/00-state.md` — for `app_id`, `api_base`, `frontend_stack`. ## Procedure 0. **Refresh docs.** Call `butterbase_docs` with `topic: "frontend"`. For framework-specific deploy patterns, also WebFetch `https://docs.butterbase.ai/frontend`. Skip if cache is fresh. ### Use `@butterbase/sdk` Any frontend that talks to the deployed Butterbase app should use `@butterbase/sdk`: - Install: `npm install @butterbase/sdk` inside the frontend project. - Initialize: `import { createClient } from '@butterbase/sdk'; const bb = createClient({ apiUrl: import.meta.env.VITE_API_URL, appId: import.meta.env.VITE_APP_ID });` - Auth: `bb.auth.signInWithOAuth({ provider: 'google' })`, `bb.auth.signOut()`, `bb.auth.getSession()`. - Data: `bb.db.from('posts').select('*').eq('user_id', userId)`. - Storage: `bb.storage.upload(file)`, persist the returned `object_id`, resolve download URLs via the SDK a...