DevOps

Full-Stack Web App Development guides developers through scaffolding, AI features, auth, payments, i18n, deployment, and launch for modern web apps. Use it when building a SaaS or shipping a Next.js product from idea to production.

Plugin Development Workflow guides changes to plugin skills, agents, hooks, and the eval framework in this repo. Use when editing files in plugins/elixir-phoenix/, lab/eval/, or lab/autoresearch/ to keep eval, lint, and tests passing.

Plugin Release cuts a versioned Elixir/Phoenix plugin release by bumping manifests, finalizing the changelog, running CI, and creating the tag and GitHub release. Use it when shipping a new plugin version.

Auth Setup configures OAuth providers, JWT lifetimes, post-login hooks, and service API keys for Butterbase apps. Use it when setting up end-user sign-in or auth-related backend behavior.

Build App walks through creating a complete Butterbase app, including backend provisioning, schema design, RLS, and deployment. Use it when starting a new app or setting up auth and database-backed features.

Butterbase Preflight checks that a Butterbase account, MCP connection, API key, and app_id are in place before platform-touching actions. Use it to verify setup and write the results to preflight state files.

Frontend Deployment packages and uploads React, Next.js static exports, or plain HTML to a live Butterbase URL. Use it to set build-time env vars, configure CORS, and troubleshoot blank pages or MIME type errors.

Function Dev covers developing, deploying, and debugging Butterbase serverless functions. Use it for HTTP endpoints, webhooks, cron jobs, WebSocket triggers, database access, and environment variables.

Journey Deploy verifies a deployed Butterbase app end to end after build. It checks the live URL, invokes deployed functions, and confirms auth flow before allowing submission.

Journey Durable Objects deploys per-key stateful actors as part of the Butterbase journey. Use it when a plan includes Durable Objects such as chat rooms, multiplayer sessions, or rate limiters.

Journey Frontend builds or adopts the frontend stage of a Butterbase journey and deploys it with the app ID and API URL set. Use it when the plan includes a frontend step and the app should be scaffolded, built, and published.

Journey Functions implements the functions stage of the Butterbase journey by building each planned function, deploying it, and running a smoke test. Use it when the plan includes backend functions to ship.