How-to Guides

Problem-oriented, practical steps. Use these when you know what you want to do.

Deployment

• Deployment baseline — seven requirements every host must satisfy
• Build for web — export static web bundle with correct API URL
• Deploy to Google Cloud Platform — index for GCP guides
• Deploy backend to Cloud Run — container + Secret Manager + Cloud Run
• Deploy web to GCS + CDN — static hosting with SPA routing

Contents

• CircleCI — Dual-run CI on CircleCI (package CI / policy / e2e; deploys later)
• Create a Mongoose model — Define models with proper conventions
• Add GitHub OAuth authentication — Enable GitHub login for your API
• Configure Better Auth — Set up Better Auth with social OAuth (Google, GitHub, Apple)
• Add WebSocket integration — Set up real-time Socket.io connections
• Expose Model Context Protocol tools — Turn modelRouter models into MCP tools an LLM can call
• Install agent skills — Install Grow/Pick/Roast/Brew/Taste and domain skills with npx skills
• Call external APIs — Authenticated HTTP client, retries, and error normalization for third-party integrations
• Deploy to Google Cloud Platform — Deploy demo and example apps to GCS with CDN
• Migrate from @terreno/rtk to @terreno/syncdb — Move data sync to the local-first layer

Coming Soon

• Add feature flags — Add feature flags and A/B testing to your app
• Add custom permissions
• Implement file uploads
• Configure email notifications
• Customize AI workflows
• Set up custom CI/CD pipelines