Under the hood

Explore the engineering behind this portfolio — its architecture, design system, performance metrics, and the roadmap for what’s coming next.

Architecture

This portfolio is built with a modern React architecture using Next.js, TypeScript, and Turborepo. The project structure emphasizes separation of concerns, reusable component patterns, and maintainable project organization, reflecting how I typically structure React applications.

Tech Stack

Tech Stack

    UI Layer

  • Next.js
  • React
  • Styled Components
  • TanStack Query (React Query)
  • Content Layer

  • Contentful CMS
  • Integration & APIs

  • REST
  • GraphQL
  • Developer Tooling

  • Turborepo
  • Vite
  • Storybook
  • Testing

  • React Testing Library
Portfolio App

Next.js + React + TypeScript

Main Next.js application responsible for rendering pages and UI.
Design System

Storybook + Vite + Styled Components

Reusable UI components shared across the application.
CMS Package

Contentful

Contentful client, queries, and data mapping.

Secure By Design

Upstream Github and Lighthouse APIs are proxied through a Next.js BFF (Backend-for-Frontend) architecture. This server-side bridge keeps sensitive API tokens strictly in the environment—delivering clean, pre-processed data to the UI without exposing credentials to the browser’s Network tab.

Client

Client triggers a GET request to server /api/<route>

Next.js server · Node.js runtime

API routes

Route handler receives call on the secure server

Environment

Private keys are injected via process.env into the server environment

Auth headers injected here—0% exposure to client

Upstream

Secure HTTPS outbound request to upstream Github and Lighthouse APIs

Design System

To ensure visual consistency and streamline the development workflow, I am currently architecting a centralized design system hosted as a shared package. Each component will be fully documented within an isolated Storybook environment, with a live link provided here as soon as the first iteration is live.

Vintage Fender Radio - Stay Tuned
Signal Incoming

Stay Tuned

We're currently fine-tuning the frequencies. This section is under development and will be broadcasting soon.

Performance Lab

Automated performance profiling and accessibility auditing. This interface leverages the Lighthouse engine to generate deep-dive insights into the application's speed, crawlability, and inclusive design patterns.

LIGHTHOUSE
HOME
KC
KC
550
692
833
975
1117
1258
1400
Performance
Accessibility
Best practices
SEO
> RUNNING_AUDIT...
LCP
FCP
FID
CLS
SI
OPTIMIZATION_LOG
[OK] React v18.3.0
[OK] Tree-shaking active
[OK] Gzip compression
[!] Lighthouse: /100

A real-time synchronization of active development across the application layer, design system, and CMS integration. This board pulls directly from GitHub Issues serving as a functional 'command center' for the continuous integration and deployment of new features.

Application Layer
Design System
Contentful
Accessibility