# getfolio.dev - Full Technical Reference

> getfolio.dev is a developer portfolio platform that automatically syncs with GitHub to generate a live, customizable public portfolio.

## What it does
Developers sign in with GitHub, claim a username, and get a portfolio at getfolio.dev/{username} populated from their GitHub data (pinned repos, contribution graph, stars, followers). They customize it in an in-place editor, choose a theme, and publish.

## Key features
- GitHub auto-sync (repos, contributions, stats)
- A curated set of themes, including Terminal, Minimal, DarkPro, Catalogue and Acetate
- In-place editor with undo/redo and drag-to-reorder projects
- Custom domains with automatic HTTPS (Pro)
- Privacy-first analytics dashboard (Pro)
- Blog sync from Dev.to and Hashnode (Pro)
- Testimonials system with approval workflow (Pro)
- "Made with getfolio.dev" badge with UTM tracking
- Open Graph image generation per profile
- RSS feed per profile
- Public profile directory at /explore

## Pricing
- Free: GitHub sync, every theme, editor, up to 6 projects, 3 links, getfolio.dev/{username} URL
- Pro: €9/mo or €7/mo billed yearly (€84/yr). Unlimited projects, unlimited links, custom domain, analytics, blog sync, testimonials, remove branding

## Tech stack
- Framework: Next.js (App Router), React
- Language: TypeScript (strict mode)
- Database: Firestore (Firebase)
- Auth: Firebase Auth with server-side session cookies
- Payments: Stripe
- Email: Resend
- Styling: Tailwind CSS, Framer Motion, Radix UI
- Deployment: Vercel

## Architecture
- Monorepo managed with Nx
- Shared libraries for types, Firebase, crypto, GitHub API, Stripe, email, and validations
- ISR (Incremental Static Regeneration) for public profile pages
- Daily cron job syncs GitHub data automatically
- GitHub OAuth tokens encrypted at rest with AES-256-GCM

## URLs
- Homepage: https://getfolio.dev
- Pricing: https://getfolio.dev/#pricing
- Explore: https://getfolio.dev/explore
- What is getfolio: https://getfolio.dev/what-is-getfolio
- Example profile: https://getfolio.dev/{username}
- Profile RSS: https://getfolio.dev/{username}/rss.xml
- OG image: https://getfolio.dev/api/og/{username}

## Contact
- Twitter/X: @doom_sebastien
- GitHub: github.com/Zansuken