Skip to content

💡 Idea #6: Website Revamp — aguidetocloud.com

Status: ✅ Complete Priority: 🔥 Urgent Category: 🎬 Content / 🎓 Learning / 💼 Official Created: 2026-03-29

The Vision

Completely revamp www.aguidetocloud.com — migrate from Squarespace template to a custom-built Hugo static site hosted on Azure Static Web Apps. New design uses a Warm Amber dark theme, clean YouTube-thumbnail-first card layout, and an AI-first content strategy reflecting Sutheesh's brand pivot from certification creator to AI educator.

Why This Matters

  • Brand pivot: Shifting from certification videos → AI/Copilot content creator
  • Current problems: Confusing navigation (courses vs full-courses vs bootcamps vs exam-qa), no consistent theme, retired exams cluttering the site
  • Goal: Professional, consistent branding across the entire A Guide to Cloud ecosystem (main site + learn portal + AI news)

Decisions Made

Decision Choice Rationale
Authentication Public now, optional login later YouTube videos are already public; login = friction
Retired exam content Archive in "Legacy" section Keep for SEO, don't mislead new visitors
Page structure Unified pages per topic One page with all resources (bite-sized + full course + Q&A + notes)
Content hierarchy AI Hub (primary) → Cloud Labs → Certifications AI-first pivot; certs as SEO engine
Hosting Azure SWA Free (lab sub, migrate to personal later) $0/month, 100GB bandwidth, easy migration
Technology Hugo static site generator Markdown content, blazing fast, Azure SWA integration
Color theme Warm Amber (dark bg, amber/orange accents) Distinctive, professional, warm
Layout Grid with YouTube thumbnails + text footer Clean, lets thumbnail designs shine
Thumbnails YouTube thumbnails as-is, clean text below No overlays — thumbnails ARE the brand
URL redirects Azure SWA route rules (staticwebapp.config.json) Map all old Squarespace URLs → new structure
Transition Keep Squarespace live until new site is ready Zero downtime, DNS switch when ready
Domain DNS Managed through Squarespace, can update CNAME Simple cutover when ready

Content Inventory (from Squarespace)

Section Count Action
/courses (bite-sized) 15 exams Merge into unified certification pages
/full-courses 11 exams Merge into unified certification pages
/exam-qa 11 exams Merge into unified certification pages
/bootcamps 20+ labs Split between AI Hub & Cloud Labs
/ai-hub 28 videos → AI Hub section
/about 1 page Refresh with new branding
Total content pages ~86+

Retired Exams → Legacy Section

  • AZ-303 (retired), AZ-304 (retired), MS-100 (retired)

Site Architecture

aguidetocloud.com/
├── 🏠 Homepage
│   ├── Hero: "Learn AI & Cloud" (AI-first messaging)
│   ├── Latest Videos grid (8 most recent)
│   ├── AI Hub section (4 featured + "View all")
│   ├── Cloud Labs section (4 featured + "View all")
│   ├── Certifications section (4 featured + "View all")
│   └── Ecosystem banner (learn portal, AI news, YouTube, LinkedIn)
│
├── 🤖 /ai-hub/
│   ├── M365 Copilot (What's New, deep dives)
│   ├── Agentic AI / Copilot Studio
│   ├── Prompt Engineering
│   ├── GitHub Copilot & MCP (coming soon)
│   └── Azure AI (OpenAI, Foundry)
│
├── ☁️ /cloud-labs/
│   ├── Azure Networking
│   ├── Azure Security
│   ├── Azure DevOps
│   └── Azure Migration
│
├── 📜 /certifications/
│   ├── Active exams (AZ-900, AZ-104, AZ-500, etc.)
│   │   └── Each = unified page (bite-sized + full course + Q&A + notes)
│   └── /legacy/ (retired exams with badge)
│
├── 👋 /about/
└── 🔗 Footer links to ecosystem

Tech Stack

Component Technology
Static site generator Hugo (Extended)
Theme Custom Warm Amber neon theme
Content format Markdown (.md files)
Hosting Azure Static Web Apps (Free tier)
CDN/SSL Built-in with Azure SWA
CI/CD GitHub Actions → Azure SWA auto-deploy
Domain aguidetocloud.com (DNS on Squarespace → CNAME to Azure)
URL Redirects staticwebapp.config.json route rules
Video embedding YouTube embed via Hugo shortcode

Cost Estimate

Item Monthly Annual
Azure SWA Free $0 $0
Domain (already paid via Squarespace) ~$2 NZD ~$25 NZD
Squarespace (can cancel after migration) -$33 NZD saved -$396 NZD saved
Net cost after Squarespace cancellation ~$2 NZD ~$25 NZD

Build Phases

Phase 1: Foundation ⬜

  • Set up GitHub repo for the site
  • Hugo project with Warm Amber theme finalized
  • Homepage layout (minimal hero + inline stats + latest videos + featured pick)
  • Navigation structure
  • Responsive design (mobile/tablet/desktop)
  • Footer with ecosystem links
  • Fonts: Montserrat (headings) + Inter (body)

Phase 1.5: YouTube MCP Server ⬜

  • Set up YouTube Data API key + OAuth2 credentials (Google Cloud Console)
  • Install youtube-channel-mcp MCP server
  • Connect to workflow, test read/write access
  • Audit all YouTube videos — pull titles, descriptions, tags
  • Update YouTube titles for consistent naming convention
  • Update YouTube descriptions — replace old Squarespace links with new aguidetocloud.com URLs, add consistent branding footer
  • Update tags for SEO consistency
  • Auto-generate Hugo Markdown files from YouTube video data (title, description, youtube_id, date, tags)
  • Pull transcripts for future study notes feature

Phase 2: Content Migration ⬜

  • Auto-generated content from YouTube MCP (above) populates most pages
  • Map videos to correct sections (ai-hub, cloud-labs, certifications)
  • Create unified certification pages (~15 active + 3 legacy)
  • About page refresh
  • Manual review & enrichment of auto-generated pages

Phase 3: URL Redirects & SEO ⬜

  • Map all old Squarespace URLs to new structure
  • staticwebapp.config.json with route rules
  • 404 page (catch-all → homepage)
  • Meta tags, Open Graph, Twitter cards
  • Sitemap.xml
  • robots.txt

Phase 4: Deploy & Test ⬜

  • Deploy to Azure SWA (lab subscription)
  • Test all pages, links, embeds
  • Test old URLs redirect correctly
  • Mobile testing
  • Performance audit (Lighthouse)

Phase 5: Go Live ⬜

  • Update DNS (Squarespace CNAME → Azure SWA)
  • Verify SSL certificate
  • Final QA on live domain
  • Update learn portal + AI news links
  • Announce on YouTube/LinkedIn

Phase 6: Future Enhancements ⬜

  • Study notes alongside videos
  • Downloadable student guides
  • Optional user login (saved progress, bookmarks)
  • Search functionality
  • Analytics (page views, popular content)
  • Comment system (Giscus/GitHub Discussions)

Prototype

Working prototype exists at: C:\ssClawy\aguidetocloud-revamp

Run: hugo server --port 1313 to preview locally.

  • Learning Portal — same ecosystem, MkDocs + Material theme
  • AI News — automated nightly AI news dashboard
  • YouTube channel: Learn AI & Cloud with Susanth

What Was Built

The full website revamp is complete and live at www.aguidetocloud.com.

Site & Theme

  • Hugo static site with a custom retro neon theme — pink neon #ff66ff accents on a dark #0f0f1a background
  • Typography: Montserrat (headings) + Inter (body) + Fira Code (video content)
  • Deployed to Azure Static Web Apps Free tier — $0/month (saving ~$400 NZD/year from Squarespace)

Content (75 Videos Across 6 Categories)

Category Videos
🤖 AI Hub 17
☁️ Cloud Labs 18
📜 Certifications 14
❓ Exam Q&A 18
🎤 Interview Prep 3
🎵 Study Music 5
Total 75

YouTube MCP Server — Automated Content Pipeline

  • Connected YouTube MCP server to pull all video data via YouTube Data API v3
  • Auto-generated all Hugo Markdown content from YouTube API (titles, descriptions, thumbnails, dates, tags)
  • Updated 74 YouTube video descriptions with new branded footer linking to aguidetocloud.com
  • Updated tags on all videos for SEO consistency
  • Fixed 4 video titles for consistent pipe (|) separator format

Channel Naming

  • Main channel: "A Guide to Cloud & AI"
  • Bite-sized channel: "A Guide to Cloud & AI — Bites"

URL Redirects & SEO

  • 35 redirect rules in staticwebapp.config.json mapping all old Squarespace URLs to new structure
  • Open Graph + Twitter Cards meta tags on all pages
  • sitemap.xml + robots.txt for search engine indexing
  • Custom 404 page

Domain & Hosting

  • Domain: www.aguidetocloud.com — live ✅
  • Hosting: Azure Static Web Apps (Free tier)
  • Cost: $0/month

Tech Stack (Final)

Component Technology
Static site generator Hugo (Extended)
Theme Custom retro neon (pink #ff66ff / dark #0f0f1a)
Hosting Azure Static Web Apps (Free tier)
CI/CD GitHub Actions (future)
Content automation YouTube Data API v3 via YouTube MCP server
URL Redirects staticwebapp.config.json (35 rules)
Domain www.aguidetocloud.com

Changelog

2 April 2026 — Homepage & Layout Fixes

Change Reason Detail
Fixed duplicate videos in "Latest Videos" grid Same content exists in blog/ + ai-hub/ (cross-listed). The grid pulled from all sections, showing the same video 2-3 times. Excluded blog section entirely from the "Latest Videos" query — only shows entries from ai-hub, cloud-labs, certifications, etc. Blog posts are long-form articles, not video entries.
Homepage query: where .Site.RegularPages "Section" "!=" "blog" Blog entries should never appear in the video grid. When a new video + blog are published together, only the video entry shows. layouts/index.html