RepoPulse

GitHub Intelligence Engine - Transform raw GitHub data into meaningful insights, health scores, and beautiful visualizations.

🚀 Quick Start

Analyze Any Repository

Visit repopulse-one.vercel.app and enter any GitHub repository URL.

Example: vercel/next.js → View Analysis

Add to Your README

<!-- Repository Health Card -->
![RepoPulse](https://repopulse-one.vercel.app/api/card/repo?repo=your-username/your-repo)

<!-- Health Badge -->
![Health](https://repopulse-one.vercel.app/api/badge/health?repo=your-username/your-repo)

Explore Examples

• Repository Analysis
• User Profiles
• Theme Gallery

📚 Documentation

• Getting Started - Complete setup guide
• API Reference - Full API documentation
• Health Scores - How scoring works
• Insights - Understanding insights
• Cards & Badges - Customization guide

🌟 What is RepoPulse?

RepoPulse analyzes GitHub repositories and users to provide intelligent insights about:

• Health Status: Overall project health with transparent scoring (0-100)
• Growth Trends: Activity levels, star growth, and community adoption
• Maintenance Quality: Issue resolution, PR merge times, and contributor diversity
• Risk Assessment: Potential problems and actionable recommendations

🎯 Key Features

• Health Scores: A-F letter grades with detailed breakdowns
• Actionable Insights: Top 3 insights prioritized by severity
• Beautiful Cards: SVG visualizations for README files
• Smart Badges: Dynamic status indicators
• User Profiles: Comprehensive developer analytics
• Fast & Reliable: Server-rendered with intelligent caching

📖 Learn More

How It Works

• Data Flow - Transparent analysis pipeline
• Health Score Calculation - Detailed scoring methodology
• Insights Engine - Rule-based intelligence explained

Use Cases

• For Maintainers - Project health monitoring
• For Contributors - Finding healthy projects
• For Recruiters - Developer evaluation

Philosophy

• About RepoPulse - Mission and principles
• Why Different - vs Shields.io, GitHub Insights

README Integration

Add RepoPulse cards and badges to your README with custom themes:

<!-- Repository Health Card with Dark Theme -->
![RepoPulse](https://repopulse-one.vercel.app/api/card/repo?repo=your-username/your-repo&theme=carbon)

<!-- Health Badge with Rounded Theme -->
![Health](https://repopulse-one.vercel.app/api/badge/health?repo=your-username/your-repo&theme=rounded)

<!-- Stars Badge with Neon Theme -->
![Stars](https://repopulse-one.vercel.app/api/badge/stars?repo=your-username/your-repo&theme=neon-blue)

<!-- User Card with Dracula Theme -->
![GitHub User](https://repopulse-one.vercel.app/api/card/user?username=your-username&theme=dracula)

<!-- Language Breakdown with Gradient Theme -->
![Languages](https://repopulse-one.vercel.app/api/card/languages?repo=your-username/your-repo&theme=ocean)

🔌 API Overview

Base URL: https://repopulse-one.vercel.app/api

Core Endpoints

• GET /api/repo/:owner/:repo - Complete repository analysis
• GET /api/user/:username - User profile intelligence
• GET /api/org/:org - Organization overview

Visualizations

• GET /api/card/repo?repo=:owner/:repo - Repository health cards
• GET /api/card/user?username=:username - User profile cards
• GET /api/badge/health?repo=:owner/:repo - Health status badges

Full API Documentation →

🎨 Themes & Customization

100+ card themes and 25+ badge styles with full customization.

Popular Themes

• Dark: carbon, midnight, dracula, github-dark
• Light: default, clean, paper, github-light
• Gradient: ocean, sunset, aurora, cosmic
• Minimal: monochrome, elegant-black

Quick Examples

![Health](https://repopulse-one.vercel.app/api/badge/health?repo=owner/repo&theme=neon)
![Card](https://repopulse-one.vercel.app/api/card/repo?repo=owner/repo&theme=carbon)

Theme Gallery → • Customization Guide →

🏗️ Architecture

Clean, layered design for transparency and performance:

1. Data Collection - GitHub API fetchers with intelligent caching
2. Metrics Processing - Raw data → quantitative measurements
3. Intelligence Engine - Rule-based insights with confidence scores
4. Health Scoring - Weighted component calculations
5. Output Generation - JSON APIs, SVG visualizations, web interface

How It Works →

🛠️ Tech Stack

• Frontend: Next.js 14+ (App Router), React Server Components
• Styling: Tailwind CSS, clean Data Explorer design
• Backend: Vercel Edge Functions, TypeScript
• APIs: GitHub REST API, intelligent caching
• Deployment: Vercel (serverless, global CDN)
• Caching: Upstash Redis for performance

🎯 Core Principles

• Intelligence First: Insights over raw numbers
• Explainable Logic: No black-box algorithms
• Server-First: Optimized for performance and SEO
• API-Driven: Everything accessible via APIs
• Open Source: Contributor-friendly and transparent

🛠️ Development

Quick Setup

git clone https://github.com/manjunathh-xyz/repopulse.git
cd repopulse
npm install
npm run dev

Environment (Optional)

# Higher rate limits
GITHUB_TOKEN=your_token

# Production caching
UPSTASH_REDIS_REST_URL=url
UPSTASH_REDIS_REST_TOKEN=token

Contributing Guide →

2. Install dependencies

   npm install

3. Environment Variables Create a .env.local file:

   # GitHub API Token (recommended for higher rate limits)
   GITHUB_TOKEN=your_github_token_here
   
   # Upstash Redis (optional, for production caching)
   UPSTASH_REDIS_REST_URL=your_upstash_redis_url
   UPSTASH_REDIS_REST_TOKEN=your_upstash_redis_token

4. Start development server

   npm run dev

   Visit http://localhost:3000

Available Scripts

npm run dev      # Start development server
npm run build    # Build for production
npm run start    # Start production server
npm run lint     # Run ESLint
npm run type-check # Run TypeScript checks

📁 Project Structure

src/
├── app/                    # Next.js App Router pages
│   ├── api/               # API routes
│   ├── repo/              # Repository pages
│   ├── user/              # User profile pages
│   ├── badges/            # Badge gallery
│   ├── cards/             # Card examples
│   └── page.tsx           # Homepage
├── lib/                   # Core business logic
│   ├── fetchers/         # GitHub data fetching
│   ├── metrics/          # Data processing
│   ├── insights/         # Intelligence engine
│   ├── scoring/          # Health score calculations
│   ├── badges/           # Badge generation
│   └── cards/            # Card generation
├── types/                # TypeScript definitions
└── utils/                # Utilities and clients

🤝 Contributing

We welcome contributions! Here's how to get started:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

Development Guidelines

• Follow the existing code style and architecture
• Add tests for new features
• Update documentation as needed
• Ensure all linting passes: npm run lint
• Test builds work: npm run build

🗺️ Roadmap

View Full Roadmap →

Planned Features

• Enhanced user analytics and insights
• Repository comparison tools
• CLI tool for local analysis
• Advanced trend analysis
• Multi-language support
• Custom dashboard integrations

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Built with ❤️ by Manjunath and Ramkrishna.

Special thanks to the open-source community and Vercel for hosting!