Framework & Runtime
Next.js 16
Modern React framework with App Router for server and client components, API routes, and optimized rendering.Version:
16.0.7React 19
Latest React with improved concurrent features, server components, and automatic batching.Version:
19.2.0TypeScript 5
Type-safe development with full IDE support and compile-time error checking.Version:
^5Node.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@^4tailwindcss-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.25next-themes
Perfect dark mode support with system preference detection.Version:
^0.4.6Lucide React
Beautiful, consistent icon library with 1000+ icons.Version:
^0.556.0Utility Libraries
class-variance-authority@^0.7.1- Type-safe component variantstailwind-merge@^3.4.0- Intelligent class mergingclsx@^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.0pg@^8.16.3
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
@hookform/resolvers@^5.2.2Visualization & 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
Radix UI Components (Complete List)
Radix UI Components (Complete List)
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
Additional UI Components
Additional UI Components
cmdk@^1.1.1- Command menu (⌘K interface)embla-carousel-react@^8.6.0- Carousel componentinput-otp@^1.4.2- OTP input componentreact-day-picker@^9.12.0- Date pickerreact-resizable-panels@^3.0.6- Resizable panel layoutssonner@^2.0.7- Toast notificationsvaul@^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 statsDevelopment Tools
ESLint
Code linting and formatting enforcement.Packages:
eslint@^9[email protected]
eslint.config.mjsBuild Tools
PostCSS: CSS processing
postcss.config.mjs
tsconfig.json
next.config.tsEnvironment Variables
Package Manager
The project uses pnpm for faster installs and better disk efficiency: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