Turn any GitHub presence into interactive visual intelligence, structured Markdown exports, and AI-ready portfolio context.
Explore developer profiles. Analyze repository metrics. Export structured context for portfolios, resumes, and AI website builders.
Live Deployment · Overview · Features · AI Context · Architecture · Getting Started
GitHub profiles provide rich engineering signal, but transforming public contributions into structured portfolio summaries, resume bullets, or AI context has traditionally been manual and fragmented.
GitFetch streamlines this pipeline:
GitHub Handle -> Visual Analytics Dashboard -> Structured Markdown -> AI Portfolio ContextUse GitFetch to inspect developer profiles, evaluate repository activity, export section-by-section Markdown reports, and provide structured context to LLMs (ChatGPT, Claude, Cursor, v0, Bolt, Lovable) for instantaneous portfolio and resume generation.
- Developer Summary Card: Avatar, biography, follower metrics, location, company, and verified social accounts.
- Repository Explorer: Searchable, filterable repository catalog with sorting by stars or recent activity.
- Primary Language Breakdown: Donut chart distribution computed across repository ecosystems.
- Activity Feed: Timeline feed tracking pushes, pull requests, issues, stars, and repository creations.
- Organization Directory: Display of public or token-authorized organization memberships with tooltips.
- Full README Viewer: GitHub-Flavored Markdown preview and source code switcher with syntax highlighting.
- Customizable Markdown Export: Granular selector modal to export biographies, stats, languages, activity, or repository READMEs.
- AI Portfolio Snapshot: One-click clipboard copy of token-efficient markdown context structured specifically for prompt engineering.
- Private Repository Support: Optional read-only Personal Access Token (PAT) support for authorized private workspaces.
- Multi-Provider Backend Proxy: Connect to Gemini, Claude, GPT, Groq, Mistral, OpenRouter, or local Ollama instances.
- Context-Aware Inquiries: Ask natural-language questions regarding the loaded developer's tech stack, strongest repositories, and recent open-source activity.
- Accessible Component Primitives: Built on Radix UI primitives and shadcn/ui components.
- Adaptive Color System: Semantic OKLCH design tokens with seamless light and dark theme parity.
- Mobile-First Responsiveness: Responsive navigation, 2x2 mobile filter grid, and touch targets (40px-48px) optimized down to 320px viewports.
GitFetch generates clean, structured Markdown context formatted for prompt engineering.
Use this exported GitHub profile context to generate a modern developer portfolio website.
Include a hero section, skills matrix, featured project showcases, and resume-ready impact statements.
Base all claims strictly on the provided repository metadata.| Layer | Technology | Purpose |
|---|---|---|
| Frontend Framework | React 19, TypeScript | Reactive client interface |
| Component Primitives | shadcn/ui, Radix UI | Accessible UI foundation (Button, Card, Dialog, Tabs, Avatar) |
| Styling & Design Tokens | Tailwind CSS v4, OKLCH | Semantic design system with class-based dark mode |
| Data Visualization | Recharts | Primary language breakdown donut chart |
| Markdown Processing | React Markdown, Remark GFM, Rehype Raw | Profile and repository documentation rendering |
| Testing Framework | Vitest | Comprehensive unit testing (34 passing suites) |
| Backend & Proxy | Node.js, Express, esbuild | Multi-provider AI assistant proxy and rate limit monitor |
src/
├── features/
│ ├── activity/ # Activity feeds, items, and event handlers
│ ├── analytics/ # Statistical calculations and Recharts visualizers
│ ├── chat/ # Multi-provider assistant proxy, hooks, and modals
│ ├── export/ # Markdown export generators and AI context builders
│ ├── landing/ # Hero section, use-case cards, and FAQ components
│ ├── profile/ # Developer profile card, organizations, and READMEs
│ └── repositories/ # Repository cards, filters, and detail viewers
└── shared/
├── components/ui/ # shadcn/ui component primitives
├── hooks/ # useTheme, useProfileSearch
├── services/ # Centralized GitHub REST API client
└── types/ # Domain contracts, error hierarchy, and modelsgit clone https://github.com/sizwinz/GitFetch.git
cd GitFetchnpm installCreate a .env file in the project root if you wish to configure a default server-side Gemini key for the AI assistant:
GEMINI_API_KEY=your_gemini_api_key_here
PORT=3000Note: Users can also input their own API credentials directly in the in-app assistant settings modal.
npm run devThe application is served at http://localhost:3000.
npm testnpm run build
npm start- Query a Profile: Enter any GitHub username to load public contributions and metadata.
- Authenticate with PAT (Optional): Provide a read-only Personal Access Token to increase the API limit from 60 to 5,000 requests/hour and access token-authorized organizations.
- Analyze Metrics: Explore language distribution, repository milestones, and recent public activity.
- Export Documentation: Click Export Markdown to configure and download custom Markdown snapshots.
- Copy AI Context: Click Copy AI Context on the portfolio banner to instantly copy prompt-ready developer intelligence.
- Consult AI Assistant: Open the assistant launcher in the bottom right to query metadata using your preferred AI model.
- Zero Database Dependency: GitFetch is a stateless client-side application. No personal credentials, usernames, or queries are stored on external databases.
- Client-Side Requests: GitHub API requests execute directly from the browser to GitHub endpoints.
- Token Handling: Personal Access Tokens are held in browser memory or local storage and never transmitted to third-party analytics.
- AI Requests: AI queries are routed only to the user-selected AI provider endpoint.
Contributions, bug reports, and feature proposals are welcome. Please open an issue or submit a pull request following standard conventional commit guidelines.
GitFetch is open-source software built for developers and engineering teams.