portfolio

Created: August 18, 2024

Last commit: January 22, 2026

TypeScript96.9%

JavaScript1.8%

Mermaid1.1%

CSS0.2%

AI-powered chatRAG (Retrieval-Augmented Generation)semantic searchblog / CMSscheduled publishingadmin dashboardproject showcase / GitHub Projectsdocumentation viewer (GitHub repos)authentication / OAuthembeddingsE2E testingchat evaluationsmonorepo architectureCI/CD & deploymentinfrastructure as codeedge deploymentserver-side API routesE2E (end-to-end)OAuth (OAuth2)CDK (AWS CDK)OpenAI (OpenAI API)Upstash (Upstash Redis)CloudFront (Amazon CloudFront)S3 (Amazon S3)DynamoDB (Amazon DynamoDB)NextAuth (NextAuth.js)Tailwind (TailwindCSS)Framer Motion (framer-motion)pnpm (package manager)Turbopack (TurboPack)Playwright (E2E)Zod (zod)MiniSearch (MiniSearch)Lambda@Edge (Lambda@Edge)pnpmTurbopackPlaywrightESLintAWS CDK CLIOpenNext (build/deploy adapter)chat-preprocess-clipnpm chat:preprocesspnpm chat:evalspnpm devpnpm buildpnpm testOpenAI API (integration)MiniSearchZod

README.md

Portfolio

Live at jcvolpe.me

A full-stack portfolio application built with Next.js 15, React 19, and deployed on AWS using OpenNext and CDK.

Features

AI-Powered Chat: RAG-based conversational interface with semantic search over portfolio content
Blog System: Full CMS with DynamoDB storage, scheduled publishing, and admin dashboard
GitHub Projects: Dynamic project showcase with documentation viewer from GitHub repos
Authentication: NextAuth.js with GitHub/Google OAuth

Tech Stack

| Category | Technologies | |----------|-------------| | Frontend | Next.js 15, React 19, TailwindCSS, Framer Motion | | Backend | Next.js API Routes, NextAuth.js, OpenAI API | | Infrastructure | AWS CDK, Lambda@Edge, CloudFront, DynamoDB, S3 | | Data | Upstash Redis, AWS Secrets Manager | | Testing | Playwright (E2E), Chat Evals |

Quick Start

# Install dependencies
pnpm install

# Start development server
pnpm dev

# Run tests
pnpm test

Project Structure

/
├── src/                    # Next.js application source
│   ├── app/               # App Router pages and API routes
│   ├── components/        # React components
│   ├── hooks/             # Custom React hooks
│   ├── lib/               # Utilities and helpers
│   ├── server/            # Server-side code
│   └── context/           # React context providers
├── packages/              # Monorepo packages
│   ├── chat-contract/     # Zod schemas for chat API
│   ├── chat-data/         # Data layer with MiniSearch
│   ├── chat-orchestrator/ # OpenAI integration
│   ├── chat-next-api/     # API route handlers
│   ├── chat-next-ui/      # Chat UI components
│   ├── chat-preprocess-cli/ # Data preprocessing CLI
│   ├── github-data/       # GitHub API integration
│   └── test-support/      # Test fixtures and utilities
├── infra/cdk/            # AWS CDK infrastructure
├── generated/            # Preprocessed chat embeddings
└── e2e/                  # Playwright E2E tests

Documentation

Comprehensive documentation is available in the docs/ folder:

Getting Started - Installation, development, and commands
Architecture - System design and infrastructure
Features - Chat, blog, projects, and authentication
Configuration - Environment variables and secrets
Deployment - CI/CD and production deployment
Testing - E2E testing and chat evaluations

Commands

| Command | Description | |---------|-------------| | pnpm dev | Start development server with Turbopack | | pnpm build | Build for production (OpenNext + CDK) | | pnpm lint | Run TypeScript and ESLint checks | | pnpm test | Run Playwright E2E tests | | pnpm chat:preprocess | Generate chat embeddings | | pnpm chat:evals | Run chat quality evaluations |

License

Private repository.