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

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

License

Private repository.