← Help hub

Platform

Production launch checklist

Env vars, DNS, smoke tests, and analytics to go live on wazobiaos.com and docs.wazobiaos.com.

Last updated: 2026-08-01

Use this checklist before treating WaZoBia OS as production-ready.

Domains

  • Deploy this repo to Vercel as wazobiaos.com
  • Add domain docs.wazobiaos.com to the same project
  • DNS: apex + www → Vercel; CNAME docs → Vercel
  • Set env vars below in the Vercel project (Production)

Required environment variables

VariablePurpose
NEXT_PUBLIC_SITE_URLhttps://wazobiaos.com
NEXT_PUBLIC_DOCS_URLhttps://docs.wazobiaos.com
NEXT_PUBLIC_DOCS_HOSTdocs.wazobiaos.com
INVOICE_PARTNER_API_URLhttps://www.wazobia-invoice.ng (stats + partner proxy)
NEXT_PUBLIC_INVOICE_SIGNUP_URLInvoice app signup
NEXT_PUBLIC_BOOKS_SIGNUP_URLBooks /register
NEXT_PUBLIC_EVENTS_SIGNUP_URLEvents app
RESEND_API_KEYContact / enterprise forms
CONTACT_EMAIL_TOInbox for form submissions
CONTACT_EMAIL_FROMVerified Resend sender
NEXT_PUBLIC_GA_MEASUREMENT_IDOptional — GA4 after cookie consent

Also set product marketing/app URL overrides if they differ from defaults in .env.example.

Invoice site (deploy together)

  • Deploy wazobia-website with /api/public/stats live
  • Optional PUBLIC_STATS_* overrides if live counts are still low
  • Confirm partner interest API accepts proxied posts from OS

Smoke tests (production)

  1. Homepage loads; trust bar shows geography metrics (live payment metrics only if stats API returns them)
  2. Start free → Invoice / Books / Events app URLs with utm_source=wazobiaos
  3. /contact and /enterprise forms deliver email
  4. /partner-with-us submits successfully
  5. /blog and an MDX post render
  6. /docs and /docs/sso-billing render; Mermaid diagram draws
  7. https://docs.wazobiaos.com rewrites to the docs hub
  8. Cookie banner: Decline → no GA; Accept → GA loads
  9. In GA4 DebugView (after Accept): start_free_product, contact_submit

Analytics events

EventWhen
start_free_clickHeader / CTA “Start free”
start_free_productProduct card or product page opens app signup
learn_more_productLearn more → marketing site
contact_submitContact form success
enterprise_contact_submitEnterprise / sales form success
partner_interest_submitPartner interest success

After launch

  • Monitor Resend delivery and form spam
  • Set FORM_HMAC_SECRET (and optionally Upstash Redis REST for durable rate limits)
  • Confirm /security copy distinguishes hub vs product apps
  • Review GA funnels weekly
  • Publish 1 MDX blog post / month under content/blog/
  • Advance SSO Phase 1 per Unified SSO & Billing
Production launch checklist · WaZoBia OS