Skip to main content

Framework & Runtime

Next.js 16

Modern React framework with App Router for server and client components, API routes, and optimized rendering.Version: 16.0.7

React 19

Latest React with improved concurrent features, server components, and automatic batching.Version: 19.2.0

TypeScript 5

Type-safe development with full IDE support and compile-time error checking.Version: ^5

Node.js 18+

Modern JavaScript runtime with native ESM support and enhanced performance.Minimum: Node.js 18 or higher

Styling & UI

Tailwind CSS 4

Utility-first CSS framework for rapid UI development with custom configuration.
  • tailwindcss@^4
  • @tailwindcss/postcss@^4
  • tailwindcss-animate@^1.0.7

Radix UI

Unstyled, accessible component primitives:
  • Accordion, Alert Dialog, Avatar
  • Dialog, Dropdown Menu, Popover
  • Select, Tabs, Tooltip
  • 20+ components total

Framer Motion

Production-ready animation library for smooth, physics-based animations.Version: ^12.23.25

next-themes

Perfect dark mode support with system preference detection.Version: ^0.4.6

Lucide React

Beautiful, consistent icon library with 1000+ icons.Version: ^0.556.0

Utility Libraries

  • class-variance-authority@^0.7.1 - Type-safe component variants
  • tailwind-merge@^3.4.0 - Intelligent class merging
  • clsx@^2.1.1 - Conditional classNames

Data & APIs

GitHub API (Octokit)

Official GitHub REST API client for fetching repository data, commits, contributors, and more.Package: @octokit/rest@^22.0.1Features:
  • Automatic rate limit handling
  • Pagination support
  • Type-safe request/response
  • OAuth authentication

date-fns

Modern date utility library for date manipulation and formatting.Version: ^4.1.0Usage:
  • Date range calculations
  • Time-series bucketing
  • Human-readable formatting

Caching & Performance

Upstash Redis

Serverless Redis for distributed caching with automatic scaling.Package: @upstash/redis@^1.35.7Configuration:
  • 24-hour TTL for wrapped data
  • Automatic fallback to in-memory cache
  • REST-based (no persistent connections)

In-Memory Cache

Map-based fallback cache for development and environments without Redis.Implementation: lib/cache.ts
  • Same 24-hour expiration
  • Type-safe cache entries
  • Automatic cleanup

Authentication & Database

better-auth

Modern, type-safe authentication library for Next.js.Version: ^1.4.5Features:
  • GitHub OAuth integration
  • Session management
  • Type-safe auth hooks
  • Minimal configuration

PostgreSQL + Prisma

Type-safe database client and schema management.Packages:
  • prisma@^7.1.0
  • @prisma/client@^7.1.0
  • @prisma/adapter-pg@^7.1.0
  • pg@^8.16.3
Usage: Auth session storage

Forms & Validation

React Hook Form

Performant form library with minimal re-renders.Version: ^7.68.0Features:
  • Uncontrolled form inputs
  • Built-in validation
  • TypeScript support

Zod

TypeScript-first schema validation library.Version: ^4.1.13Usage:
  • API request validation
  • Form schema validation
  • Type inference
Integration: @hookform/resolvers@^5.2.2

Visualization & Charts

Recharts

Composable charting library built on React components.Version: ^2.15.4Chart Types:
  • Line charts (commit activity)
  • Bar charts (language distribution)
  • Area charts (monthly trends)
  • Pie charts (contributor breakdown)

Framer Motion

Also used for animated transitions between slides and number counters.Slide Animations:
  • Fade in/out transitions
  • Slide entrance animations
  • Stagger effects
  • Number count-up animations

UI Component Libraries

The following Radix UI primitives are installed:
  • @radix-ui/react-accordion@^1.2.12
  • @radix-ui/react-alert-dialog@^1.1.15
  • @radix-ui/react-aspect-ratio@^1.1.8
  • @radix-ui/react-avatar@^1.1.11
  • @radix-ui/react-checkbox@^1.3.3
  • @radix-ui/react-collapsible@^1.1.12
  • @radix-ui/react-context-menu@^2.2.16
  • @radix-ui/react-dialog@^1.1.15
  • @radix-ui/react-dropdown-menu@^2.1.16
  • @radix-ui/react-hover-card@^1.1.15
  • @radix-ui/react-label@^2.1.8
  • @radix-ui/react-menubar@^1.1.16
  • @radix-ui/react-navigation-menu@^1.2.14
  • @radix-ui/react-popover@^1.1.15
  • @radix-ui/react-progress@^1.1.8
  • @radix-ui/react-radio-group@^1.3.8
  • @radix-ui/react-scroll-area@^1.2.10
  • @radix-ui/react-select@^2.2.6
  • @radix-ui/react-separator@^1.1.8
  • @radix-ui/react-slider@^1.3.6
  • @radix-ui/react-slot@^1.2.4
  • @radix-ui/react-switch@^1.2.6
  • @radix-ui/react-tabs@^1.1.13
  • @radix-ui/react-toggle@^1.1.10
  • @radix-ui/react-toggle-group@^1.1.11
  • @radix-ui/react-tooltip@^1.2.8
  • cmdk@^1.1.1 - Command menu (⌘K interface)
  • embla-carousel-react@^8.6.0 - Carousel component
  • input-otp@^1.4.2 - OTP input component
  • react-day-picker@^9.12.0 - Date picker
  • react-resizable-panels@^3.0.6 - Resizable panel layouts
  • sonner@^2.0.7 - Toast notifications
  • vaul@^1.1.2 - Drawer component

Open Graph & Meta

@vercel/og

Dynamic Open Graph image generation for social media sharing.Version: ^0.8.5Usage: /api/og route generates custom OG images with repository stats

Development Tools

ESLint

Code linting and formatting enforcement.Packages:Config: eslint.config.mjs

Build Tools

PostCSS: CSS processing
  • postcss.config.mjs
TypeScript: Type checking
  • tsconfig.json
Next.js Config: next.config.ts

Environment Variables

GITHUB_TOKEN=ghp_your_token_here
# Increases rate limit from 60/hour to 5,000/hour

Package Manager

The project uses pnpm for faster installs and better disk efficiency:
pnpm install    # Install dependencies
pnpm dev        # Start dev server
pnpm build      # Production build
pnpm start      # Start production server
pnpm lint       # Run ESLint
While pnpm is recommended, the project also works with npm or yarn.

Browser Support

The application targets modern browsers:
  • Chrome/Edge (latest 2 versions)
  • Firefox (latest 2 versions)
  • Safari (latest 2 versions)
  • Mobile browsers (iOS Safari, Chrome Android)

Production Deployment

Vercel

Optimized for Vercel deployment with automatic:
  • Static optimization
  • Edge function deployment
  • Image optimization
  • Analytics

Docker

Can also be containerized:
  • Standard Next.js standalone build
  • Multi-stage Docker builds
  • Environment-based configuration
Check package.json for the most up-to-date dependency versions.

Build docs developers (and LLMs) love