Skip to content

groundhog-21/new_year_new_you

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 

Repository files navigation

The Accidental Portfolio: A Hobbyist’s Guide to Useful Things and AI Second Opinions

A high-performance, minimalist developer portfolio built for the Google AI "New Year, New You" Portfolio Challenge. This project prioritizes engineering judgment over marketing, balancing "static-first" speed with "dynamic-next" AI insights.

🚀 Live Links

🛠 Features

  • Streaming AI Insights: Utilizes Gemini 3 Flash to provide real-time "Hobbyist Second Opinions." The AI analyzes project metadata to offer a witty, critical, or supportive "third-party" perspective on the work.
  • Zero-Lag Architecture: Implements Next.js Suspense and Streaming (Server Components). The core portfolio UI renders instantly from static data, while the AI insights stream in asynchronously to prevent blocking the user experience.
  • Decoupled Content: Uses a clean projects.json structure as a single source of truth, allowing for rapid updates without modifying the underlying application logic.
  • Engineering-First Detail: Project pages focus on technical values and "How I Work" documentation, moving beyond the standard résumé format to show the developer's thought process.
  • Cloud-Native Deployment: Fully containerized with an optimized multi-stage Docker build and deployed to Google Cloud Run for serverless scaling and high availability.

🏗 Tech Stack

  • Framework: Next.js (App Router)
  • AI Integration: Google Gemini API (Gemini 3 Flash via Google AI Studio)
  • Deployment: Google Cloud Run
  • Infrastructure: Docker with optimized .gcloudignore for rapid CI/CD.

📖 Project Structure

The project is organized to separate content from logic:

  • src/content/projects.json: The metadata repository for all portfolio entries.
  • src/lib/gemini.ts: The bridge to the Gemini 3 Flash engine, handling error states and fallback insights.
  • src/app/portfolio/page.tsx: The streaming UI implementation using React Suspense boundaries.

🚦 Status

Complete — Live, functional, and submitted for the 2026 Portfolio Challenge.


Built with curiosity and restraint by groundhog21.

About

A high-performance, minimalist developer portfolio built for the DEV.to New Year, New You Portfolio Challenge

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors