About GrowthHQ
A case study in Digital Growth & Marketing Systems
What is this?
GrowthHQ is a Digital Growth Command Center — a real-time dashboard that consolidates metrics from 6+ marketing channels into one unified interface with automated insights, explainability tooltips, and an AI-queryable MCP server.
Why it exists
Directors of Digital Growth spend hours switching between GA4, Search Console, HubSpot, Mailchimp, and social platforms. GrowthHQ eliminates that context-switching by presenting all channels in one place, with rule-based insights that surface what matters.
Architecture
Connector Pattern
Every data source implements IConnector<T>. Swap mock → real by changing one env var. Zod validates all data at runtime.
Snapshot Strategy
Python scripts fetch data from GA4 and Search Console APIs. GitHub Actions cron commits JSON snapshots daily. Zero server-side API calls at build time.
MCP Server
9 read-only tools expose dashboard data to AI assistants. Query metrics, alerts, and insights programmatically via Claude Code.
Insights Engine
22 rule-based checks analyze all channels. No LLM — pure threshold, trend, and comparison logic. Transparent and auditable.
Tech Stack
Pages
7 functional pages covering the full marketing stack:
- Command Center — cross-channel KPIs, traffic trend, channel mix, automated insights
- Web Performance — sessions, users, bounce rate, device breakdown, top pages
- SEO / AEO / GEO — impressions, clicks, position history, top queries
- Email Marketing — open/click rates, send time heatmap, campaign performance
- Social Media — follower growth, engagement, referral traffic by platform
- CRM & Pipeline — conversion funnel, lead velocity, channel attribution
- Martech Health — system uptime, maturity score, automation success rates
Multi-tenant
This dashboard is designed as a reusable template. To adapt for a different company: fork the repo, update mock data to match your stack, add real connectors for your tools, and deploy. The connector pattern makes swapping data sources trivial.