Knowledge > Runbooks > Deployment

Deployment Runbooks

Procedures for deploying and managing infrastructure across all ChurchWiseAI properties.

Runbooks

Runbook	Description
deploy-churchwiseai.md	Deploy churchwiseai-web to churchwiseai.com (also serves sermonwise.ai and sharewiseai.com)
deploy-pewsearch.md	Deploy pewsearch/web to pewsearch.com
deploy-itw.md	Deploy sermon-illustrations to illustratetheword.com
deploy-voice-agent.md	Deploy the LiveKit voice agent
rollback.md	Roll back a bad deployment for any property
env-var-rotation.md	Rotate an API key and update all environments
domain-setup.md	Add a new domain or subdomain to the portfolio

Deployment Architecture Summary

Property	Codebase	Deploy Branch	Trigger	URL
churchwiseai.com	churchwiseai-web/	main	git push → Vercel auto	churchwiseai.com
sermonwise.ai	churchwiseai-web/	main	same deploy	hostname rewrite at /sermons
sharewiseai.com	churchwiseai-web/	main	same deploy	hostname rewrite at /social/*
pewsearch.com	pewsearch/web/	master	git push → Vercel auto	pewsearch.com
illustratetheword.com	sermon-illustrations/	master	git push → Vercel auto	illustratetheword.com
Voice agent	churchwiseai-web/voice-agent-livekit/	main	lk agent deploy --project cwa-voice --silent	LiveKit Cloud

Key Safety Rules

• Always create a feature branch from the deploy branch before making changes.
• Always run pnpm build locally before merging to the deploy branch.
• Voice agent deploy: C:\dev\lk.exe agent deploy --project cwa-voice --silent. No WSL, no Railway, no Cartesia CLI needed.
• Never git push --force to main or master.
• Voice agent SDK is pinned to livekit-agents~=1.5 — do not upgrade without testing.

Vercel Project Names

Project	Vercel Project Name
churchwiseai-web	churchwiseai-web
pewsearch	pewsearch-web
sermon-illustrations	sermon-illustrations

Run vercel ls to confirm current project names.