βοΈ Command Centre (CC)¶
Built: 2026-04-16
URL: aguidetocloud.com/cc/ β NOT linked from anywhere on the site
Status: π Password-gated (Cric@buzz321)
Accent: Terminal green#22c55e
CSS Namespace:cc-*(no.siteana-prefix)
Body Class: none (standalone layout)
Privacy:noindex, nofollow, not in sitemap, not in nav
What It Is¶
A private operations dashboard β your personal command centre for making content, tool, and growth decisions. Completely separate from the public /site-analytics/ transparency page.
Design philosophy: Terminal-inspired, dense, action-first. JetBrains Mono for numbers. Green/amber/red semantic colours. No glassmorphism. Every pixel earns its place.
Architecture¶
ββββββββββββββββββββββββββββββββββββββββββββ
β DATA SOURCES β
ββββββββββββ¬βββββββββββ¬βββββββββββ¬ββββββββββ€
β GA4 β GSC β YouTube β YouTube β
β Data API β Queries β Data API βAnalyticsβ
β β β (public) β (OAuth2)β
ββββββ¬ββββββ΄βββββ¬ββββββ΄βββββ¬ββββββ΄βββββ¬βββββ
β β β β
ββββββββββββ΄βββββββββββ΄βββββββββββ
β
ββββββββββΌβββββββββ
β /api/stats β
β ?range=30d β
β ?realtime=1 β
β ?youtube=1 β
ββββββββββ¬βββββββββ
β
ββββββββββΌβββββββββ
β /cc/ β
β command-centre β
β .js + .css β
βββββββββββββββββββ
5 Views¶
| View | Keyboard | What it does |
|---|---|---|
| Dashboard | D |
Morning operating screen β status strip, Do Today actions, WoW comparison, pulse charts, content bets, growth trajectory |
| YouTube | Y |
Channel intelligence β stats, weekly scorecard (A+βD), velocity leaderboard, title scorecards (0-100), subscriber projections (when 100K/500K/1M) |
| SEO | S |
Search growth β quick wins, opportunities, all queries with position badges, content gaps |
| Strategy | T |
Forward-looking β topic clusters, content calendar, growth predictions, competitor watch, portfolio health |
| Bio Links | B |
/links/ page analytics β click leaderboard, section breakdown, trend, CTR, insights |
Key Features¶
V1 (2026-04-16)¶
- Status strip with time-of-day context
- Live heartbeat (GA4 Realtime API, 30-second refresh)
- Health Score (0-100 composite: growth + SEO + engagement + reach)
- Priority actions engine (SEO fixes + tool promotion + content ideas)
- Dual pulse charts (site + YouTube side by side)
- Working / Needs Fixing split view
- Content Bet Engine (ranked next content ideas from GSC demand + tool momentum)
- Growth trajectory with full timeline
V2 (2026-04-16)¶
- Time context: "on track for ~400 today, 120% of typical pace"
- WoW comparison row with arrows
- Publish streak tracker
- YouTube localStorage cache (survives quota errors)
- SEO Quick Wins (queries at pos 8-20 needing one push)
- Keyboard shortcuts (D/Y/S/T/R/?)
- Copy Weekly Report to clipboard
- Pace indicator
V3 (2026-04-16)¶
- Topic Cluster Intelligence (9 clusters: Copilot, Azure, Security, Licensing, etc.)
- Content Calendar (14-day visual planner, localStorage)
- Growth Predictions (current pace vs 2x vs 10x scenarios β 100K/500K/1M dates)
- Competitor Watch framework
- Portfolio Health Score (blog + tools + videos + SEO)
V4 (2026-04-17)¶
- Bio Links tab β analytics for the
/links/bio page - Click leaderboard by link_id with coloured bars matching link accents
- Section breakdown (primary / watch / connect / social)
- 30-day click trend bar chart
- Stats: total clicks, page views, CTR%, unique visitors, WoW change
- Auto-generated insights (top link, CTR assessment, least-clicked suggestions)
- Data source:
/api/stats?biolinks=1
UX Layer (2026-04-16)¶
- Welcome overlay (first visit only)
- Help modal (press
?) - Morning routine guided walkthrough (press β)
- Section explainer tooltips
Files¶
| File | Size | Purpose |
|---|---|---|
content/cc/_index.md |
0.1KB | Front matter (noindex, nofollow) |
layouts/cc/list.html |
~8KB | Template with all view containers + password gate |
static/js/command-centre.js |
~49KB | Full intelligence engine |
static/css/command-centre.css |
~21KB | Terminal-inspired styles |
Data Sources & API Params¶
| Param | What it returns | Cache |
|---|---|---|
?range=30d |
GA4 traffic + GSC queries + tool trends | 5 min |
?range=all |
Full history since 2026-03-30 | 5 min |
?realtime=1 |
GA4 Realtime active visitors | No cache |
?youtube=1 |
Channel stats + all videos + analytics + title scores + projections | 6 hours |
?latestvideo=1 |
Most recent video (id, title, thumbnail, date) | 6 hours |
?biolinks=1 |
Bio link click analytics (by link, by section, trend, WoW) | 5 min |
YouTube API Details¶
- Data API (API key): Channel stats, all video stats, engagement metrics. ~300 units per request.
- Analytics API (OAuth2): Watch time, avg duration, subs gained/lost, traffic sources (28-day window).
impressionsandCTRare NOT available via API β YouTube Studio only. - Quota: 10,000 units/day. Resets midnight Pacific (8 PM NZT).
- OAuth2 credentials: Stored in SWA env vars (
YOUTUBE_OAUTH_CLIENT_ID,YOUTUBE_OAUTH_CLIENT_SECRET,YOUTUBE_OAUTH_REFRESH_TOKEN).
β οΈ Important: CC vs Site Analytics¶
/site-analytics/ |
/cc/ |
|
|---|---|---|
| Purpose | Public transparency | Private decision-making |
| Access | No password, fully public | Password-gated (Cric@buzz321) |
| Linked from | Nav, homepage, free tools | Nowhere β direct URL only |
| SEO | Indexed | noindex, nofollow |
| YouTube data | Not shown | Full channel intelligence |
| Actions/insights | Not shown | Do Today, Content Bets, Strategy |
| Design | Glassmorphism dark theme | Terminal/monospace, dense |
NEVER mix these two. Don't add CC features to the public page. Don't link CC from anywhere. Don't expose YouTube data publicly.
Maintenance¶
- YouTube API quota: If quota exceeded, CC shows cached data from localStorage (up to 24h old)
- Content Calendar: localStorage only β not synced. Plan content in the CC, track here.
- Competitor Watch: Framework only β needs YouTube Data API calls per competitor channel (future)
- Title Scorecards: Heuristic-based (power words, length, curiosity gap). Not as reliable as real CTR data.