Building a Portfolio Website (Astro v5)
Last Updated: 25 February 2026 Status: Homepage Refresh -- 1,323 Sessions, 380+ Protocols, v9.2.4
A personal portfolio website built with Astro, focusing on performance, component reusability, and zero-JavaScript defaults.
This documents how I built (and evolved) a complete portfolio website with AI-augmented execution using Project Athena.
Site Overview
| Metric | Count |
|---|---|
| Pages | 45 |
| Articles | 26 |
| Live Demo Sites | 6 |
| AI Widget | Athena Live |
| Framework | Astro 5.0 (Vite-powered) |
| Brand Kit | Lambda (L) Identity |
| Athena Kernel | v9.2.4 |
| Sessions Logged | 1,323 |
| Protocols | 380+ |
Brand Kit
The site includes a complete $10K-equivalent brand package:
| Asset | Location |
|---|---|
| Logo (Lambda L) | brand/logo/ -- 4 variants (SVG + PNG) |
| Brand Guidelines | brand/BRAND_GUIDELINES.md |
| CSS Variables | brand/variables.css |
| Email Signature | brand/collateral/email-signature.html |
| Presentation Template | brand/collateral/presentation-template.md |
| Invoice Template | brand/collateral/invoice-template.md |
| Business Card Mockup | brand/mockups/business-card.png |
| OG Image | public/assets/images/og-image.png |
Brand Identity
- Logomark: Lambda (L) -- represents Athena, precision, the L+XX signature
- Colors: Void (#0A0A0A) + Bionic Gradient (#3B82F6 - #EC4899)
- Typography: Outfit (display) + Inter (body) + JetBrains Mono (code)
- Personality: Sovereign * Precise * Bionic * Premium * No-Bullshit
Featured: Athena Live Widget
The homepage includes an interactive AI chat widget that demonstrates the Athena experience.
The Smart Mock Story
API integration with Gemini was too much hassle -- rate limits, latency, key management. So we built a Smart Mock system instead: keyword-matched, pre-authored responses with simulated typing delay. Same UX, zero cost, instant responses.
+--------------------------------------+
User Query | "What is Athena?" |
+--------------+-----------------------+
V
+--------------------------------------+
| Keyword Match: "athena" detected |
| - Return pre-authored response |
| - 800ms simulated typing delay |
+--------------------------------------+
What It Does
- Smart Mock System -- Rule-based responses covering ~20 common questions
- localStorage Persistence -- Chat state survives page refresh for seamless UX
- Reset Command --
/resetcommand allows users to clear cache and restart the flow - Dynamic Suggestions -- Context-aware follow-up prompts after each response
- Graceful Fallback -- Unknown queries get a helpful "how to reach me" response
Future: If usage justifies it, we'll add live API. The architecture already supports it -- just swap the mock for a real fetch.
Try it: winstonkoh87.com - Click the chat icon
Tech Stack
| Component | Technology |
|---|---|
| Framework | Astro 5.0 |
| Styling | Vanilla CSS (Scoped & Global) |
| Interactivity | Vanilla JavaScript (Islands Architecture) |
| Build | npm run build (Static Site Generation) |
| CI/CD | GitHub Actions (Astro Build + Deploy) |
| Hosting | Cloudflare Pages |
Philosophy: Evolution to Astro
We started with pure HTML/CSS/JS to prove a point about simplicity. But as the site grew (blogs, components, layouts), we needed a maintainable architecture without sacrificing performance.
Enter Astro.
- Zero JS by Default: Ships pure HTML unless interactivity is explicitly requested.
- Component Architecture: Reusable
.astrocomponents for Headers, Footers, and Cards. - Content Collections: Markdown/MDX support for the blog (coming soon).
- Same Performance: Still ~40KB initial load, but now with better developer experience.
We didn't sell out. We leveled up.
Built by a Bionic Unit
This entire site was co-created with Project Athena -- my AI-Powered Digital Personal Assistant.
The Workflow
| Layer | Role | Example |
|---|---|---|
| Human (Winston) | Vision, strategy, taste | "I need a portfolio that positions me as someone who builds reliable systems" |
| AI (Athena) | Execution, research, code | Astro migration, component extraction, SEO audit |
This isn't just a portfolio about AI-augmented work -- it's a living demonstration of the workflow itself.
What Athena Did (January-February 2026)
- Migrated entire site from Vanilla HTML to Astro v5
- Refactored repeated UI into reusable Components (
,) - Built the Athena Live AI widget with Smart Mock response system
- Implemented localStorage caching for instant responses
- Designed dark mode aesthetic, glassmorphism cards, particle constellation
- Audited codebase for SEO, accessibility, broken links
- Cleaned 230+ lines of duplicate code (January 2026 Audit)
- Optimized GA4 event tracking with beacon-based outbound CTA tracking
- Refreshed homepage content -- outcome-first project cards, testimonial attributions, 380+ protocols, 1,323 sessions, v9.2.4
- Corrected model references to Claude Opus 4.6 and Gemini 3.1 Pro
- Added CSS metric-glow animation and fulltime mode resume CTA
The Operating Model
+-------------------------------------------------------------+
| Human Intent (Top 1% nuance) + AI Scale (99% execution) |
| = |
| 1000% Leverage |
+-------------------------------------------------------------+
"Athena is a digital extension of me. It executes in my voice, with my principles."
Pages
| Page | Description |
|---|---|
| Home | Hero + Athena Live widget + Featured projects |
| About | Identity, philosophy, Bionic Operating Model |
| Writing | Blog with 26 published articles |
| Portfolio | 6 live demo sites |
| Athena | Product page: What Athena is and how it works |
| Services | Fixed pricing. Fast delivery. Systems that work. |
| Contact | WhatsApp CTA + social links |
Articles (26 Published)
| Cluster | Articles |
|---|---|
| Sovereign Systems | Athena 5 Pillars, Trilateral Feedback Loop, AI Bionic Layer, Iterative Layer, Athena Public Launch |
| Strategic Engineering | The Price of Ignoring Advice, Anti-Slop Protocol, Soulful Stoic Protocol, Net Life Hour Protocol, First Principles Design |
| Economics of Leverage | Why the $200 Coder Broke Your App, The Pricing Trap, Vibe Coding Trap, 2-Day Efficiency Trap |
| Case Files | Alteryx 24 Hours, Gemini Gem Agent, AI Marketing Workflow, Case Study P6 Math Tuition, SME AI Marketing Guide |
| Tactical Guides | Debugging with AI, Giving AI Jobs, Pair Programming with AI, The Ballast Friend, Guardian Protocol, Clinkz Doctrine |
Live Demo Sites
| Project | Type | Link |
|---|---|---|
| P6 Math Tuition | Education | View Site |
| Brew & Bean | F&B | View Site |
| Sticker Shop | E-commerce | View Site |
| That Bio Tutor | Education | View Site |
| Melvin Lim Portfolio | Personal | View Site |
| Coach Derrick Lim | Digital Marketing | View Case Study |
Features
- Interactive particle constellation background
- Athena Live AI chat widget
- Mobile responsive
- Dark mode aesthetic
- Fast load (~40KB total) -- Powered by Astro Island Architecture
- JSON-LD structured data (SEO)
- Accessibility: skip-links, focus-visible states
- localStorage caching for AI responses
- GitHub Actions: CI/CD Build & Deploy
Deployment
Hosted on Cloudflare Pages with GitHub Actions build pipeline.
# - GitHub Actions builds Astro project
# - Output generated in /dist
# - Deployed to Cloudflare Pages
Documentation
System architectures and strategic frameworks are hosted on the Athena-Public Repo:
- Architecture -- System design
- Trilateral Feedback -- Multi-AI validation
- Getting Started -- Build your own
Built with Astro + Project Athena. 1,323 sessions. 380+ protocols. Ships fast.