Your GitHub, Made Iconic.
Spotify Wrapped meets Apple Wallet — for developers.
Freme generates a premium, shareable identity card from any public GitHub profile in seconds. No login required. No OAuth. Just a username.
- 13 Premium Themes — From GitHub Pro and Glass Elite to full anime worlds (One Piece, Tokyo Ghoul, Jujutsu Kaisen, Demon Slayer, Sakura Dev, Cyber Samurai, and more). Every theme ships with hand-crafted SVG scene art baked into the card.
- Dev Archetypes & Levels — Real repo analysis assigns your class (Starter → Junior → Mid → Senior → Legend) based on stars, followers, languages, and commit patterns.
- Card Flip — Cards have a front face (profile, stats, languages, repos) and a back face (QR code, quick stats, contact links).
- PNG Export — Download whichever face is currently showing at 3× resolution. Perfect for Twitter/X, LinkedIn, and portfolio pages.
- Battle Mode — Enter two GitHub usernames and compare stars, impact scores, and language dominance side-by-side.
- GitHub Wrapped — Your year in code: top languages, biggest repos, and your developer evolution told as a shareable visual story.
- Zero Auth — Purely public GitHub REST API. No tokens, no permissions needed from users.
- Custom Scrollbar — Sleek red-gradient scrollbar throughout the UI.
| Layer | Technology |
|---|---|
| Framework | React 18 + TypeScript |
| Build tool | Vite |
| Styling | Tailwind CSS v4 |
| Animations | Framer Motion |
| Routing | Wouter |
| Data fetching | TanStack Query |
| Image export | html-to-image |
| QR codes | qrcode.react |
| Icons | Lucide React + React Icons |
| Monorepo | pnpm workspaces |
- Node.js 18+
- pnpm 8+
# Clone the repository
git clone https://github.com/nozomee/freme.git
cd freme
# Install dependencies
pnpm install# Run the Freme web app
cd artifacts/gitcard
pnpm devThe app will be available at http://localhost:5173.
cd artifacts/gitcard
pnpm buildartifacts/gitcard/
├── public/
│ ├── favicon.svg # Freme logo (F + spark icon)
│ └── opengraph.jpg # OG image for social sharing
├── src/
│ ├── components/
│ │ ├── GitCard.tsx # Core card component (13 themes, flip, SVG art)
│ │ ├── Heatmap.tsx # Contribution heatmap
│ │ └── layout/
│ │ ├── Navbar.tsx # Top nav with Freme logo
│ │ └── MainLayout.tsx
│ ├── hooks/
│ │ └── use-github.ts # GitHub REST API data fetching
│ ├── pages/
│ │ ├── Home.tsx # Landing page with 3D card preview
│ │ ├── Generate.tsx # Card generator + PNG export
│ │ ├── Battle.tsx # Head-to-head dev comparison
│ │ └── Wrapped.tsx # GitHub Wrapped view
│ └── index.css # Global styles + custom scrollbar
└── package.json
| Theme | Vibe |
|---|---|
| GitHub Pro | Classic dark + green contributions |
| Glass Elite | Glassmorphism + deep indigo |
| Cyber Neon | Cyberpunk cyan + glowing yellow |
| Anime Dev | Futuristic fuchsia + purple |
| Terminal Hacker | Pure black + green phosphor |
| Minimal White | Clean, print-ready white |
| Matrix Mode | Green rain — you are the One |
| One Piece | Ocean navy + gold, Jolly Roger + wave SVGs |
| Tokyo Ghoul | Crimson dark, kakugan eye + Tokyo skyline |
| Jujutsu Kaisen | Cursed energy violet, hex domain seal |
| Demon Slayer | Flame + water breathing, Nichirin sword art |
| Sakura Dev | Cherry blossom with falling petal SVGs |
| Cyber Samurai | Dark honor code, katana geometry + gold |
Made by nozomee
MIT