From "I want to contribute" to a real draft PR — in one click.
Find beginner-friendly issues, understand any codebase with AI, and ship your first PR.

Start Contributing • For Beginners • For Maintainers • Quick Start

---

📖 What is RepoSage?

The gap between wanting to contribute to open source and actually merging your first PR is enormous. You find an interesting issue. Then what?

• Which file do I even edit?
• How do I fork this correctly?
• What should I name my branch?
• What do I write in the PR description?

Most people quietly close the tab. RepoSage bridges that gap.

It's an intelligent open-source mentorship platform that handles everything between finding an issue and writing the actual code — the part that stops 90% of beginners.

🌱 For Beginners

• No more searching: We scan your GitHub profile and feed you good-first-issues tailored perfectly to your tech stack.
• Understand any codebase: Click an issue, and our AI instantly generates an architecture diagram and an onboarding guide for that specific repository.
• Ask questions without fear: Use the AI chat to ask "Which file do I need to edit to fix this?" before you ever write a line of code.
• Skip the setup chaos: Click "Start Contribution" and go from issue page to cloned repo in under 60 seconds.
• Interactive Learning: Learn Git, PR etiquette, and codebase navigation through our built-in educational hub.

🚀 For Advanced Users & Maintainers

• Grow your community: RepoSage lowers the barrier to entry for your repository, bringing you a steady stream of capable, well-guided contributors.
• Extensible AI: Built on a modular LLM architecture (OpenRouter/Groq), allowing you to plug in deep-context models to analyze massive codebases seamlessly.
• Modern Edge Architecture: Built with Next.js 16 App Router, edge middleware, and optimized caching for a blazing-fast, deploy-anywhere user experience.

---

⚡ The "Start Contribution" Button

The centerpiece feature. Click it on any issue and RepoSage:

1. Forks the repo to your GitHub account (if you haven't already)
2. Creates a descriptive branch named from the issue context
3. Opens a draft PR with a pre-filled description linked to the issue
4. Gives you a single command to clone and checkout — ready to paste into your terminal

# What you see after clicking "Start Contribution":
git clone git@github.com:yourusername/repo.git && cd repo && git checkout fix/issue-123-button-alignment

Setup that used to take 20 confused minutes now takes under 60 seconds.

---

✨ Key Features

	Feature	What it does
🎯	Smart Issue Matching	Scans your GitHub profile and surfaces good-first-issues matched exactly to your tech stack and languages. No more endless scrolling.
📐	Automated Architecture Diagrams	Click any issue and get a real-time Mermaid architecture diagram for that repository. Understand the codebase before you touch a file.
🤖	Context-Aware AI Chat	Ask "which file do I edit to fix this?" and get a real answer. DeepSeek/Qwen models read the repo and respond with actual context.
⚡	Start Contribution Button	One click. Fork → branch → draft PR → clone command. The entire setup flow in under 60 seconds.
🛤️	Kanban Progress Tracker	Track every issue across four stages: Saved → Working → PR Submitted → Merged.
🎓	Educational Hub	6 structured guides covering 50+ modules on Git, PR etiquette, and the philosophy of open source.

---

🧠 How It Works

flowchart TD
    A[👤 Sign in with GitHub] --> B(🔍 RepoSage Scans Profile);
    B -->|Analyzes languages & history| C[📋 Personalized Issue Feed];
    C --> D{Select an Issue};
    
    D -->|Instant Context| E[🤖 AI Issue Analysis];
    E --> F[📐 Auto-Gen Architecture Diagram];
    E --> G[📖 Repo Onboarding Guide];
    E --> H[💬 Interactive 'What to change?' Chat];
    
    D -->|One-Click Setup| I[⚡ Start Contribution];
    I --> J[Fork → Branch → Draft PR → Clone Command];
    J --> K[✏️ You write the fix];

    D -->|Track Progress| L[📌 Save to Kanban Board];
    L --> M[🚀 Submit PR];
    M --> N[🎉 Merged!];
    
    style A fill:#000,color:#fff,stroke:#333,stroke-width:2px
    style N fill:#2ea043,color:#fff,stroke:#333,stroke-width:2px
    style I fill:#4f46e5,color:#fff,stroke:#4338ca,stroke-width:2px

Loading

---

📁 Project Structure

RepoSage/
│
├── app/                    # Next.js App Router pages & API routes
│   ├── api/                #     API endpoints (feed, start-contribution)
│   ├── dashboard/          #     Dashboard page
│   ├── issue/              #     Issue detail page
│   ├── learn/              #     Learning hub + guides
│   ├── repo/               #     Repository insights page
│   ├── settings/           #     AI provider settings
│   ├── layout.tsx          #     Root layout
│   └── globals.css         #     Global styles
│
├── components/             # React components
│   ├── dashboard/          #     Issue feed, filters, sidebar, onboarding
│   ├── issue/              #     Arch diagram, AI chat, setup guide
│   ├── landing/            #     Landing page sections
│   ├── learn/              #     Guide content, progress, navigation
│   ├── repo/               #     File viewer, skill match, activity chart
│   └── ui/                 #     shadcn primitives (button, sonner)
│
├── lib/                    # Business logic & utilities
│   ├── github/             #     Octokit wrappers (issues, profile, ingest)
│   ├── llm/                #     AI providers (OpenRouter/Groq), prompts
│   ├── auth.ts             #     NextAuth v5 configuration
│   ├── difficulty.ts       #     Issue difficulty scoring
│   ├── env.ts              #     Zod env validation
│   ├── markdown.ts         #     Markdown → HTML renderer
│   ├── rate-limit.ts       #     GitHub API rate limit check
│   └── utils.ts            #     cn() helper (clsx + tailwind-merge)
│
├── data/                   # Static content (learning guides)
├── types/                  # TypeScript module augmentations
├── tests/                  # Test files (vitest)
├── public/                 # Static assets (robots.txt, sitemap)
│
├── package.json
├── tsconfig.json
├── vitest.config.ts
└── .env.local.example

---

⚡ Quick Start

Get your local environment up and running in under 2 minutes.

1. Clone & Install

git clone https://github.com/yourusername/reposage.git
cd reposage
npm install

2. Configure Environment

cp .env.local.example .env.local

Fill in your keys in .env.local:

# GitHub OAuth (required)
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
NEXTAUTH_SECRET=
NEXTAUTH_URL=http://localhost:3000

# AI (required for chat + diagrams)
OPENROUTER_API_KEY=

# Caching (optional but recommended)
UPSTASH_REDIS_REST_URL=
UPSTASH_REDIS_REST_TOKEN=

Need help setting up GitHub OAuth? Click here

1. Go to GitHub Settings > Developer Settings > OAuth Apps
2. Click New OAuth App
3. Set Homepage URL to http://localhost:3000
4. Set Authorization callback URL to http://localhost:3000/api/auth/callback/github
5. Copy the Client ID and Client Secret into your .env.local file.

3. Run

npm run dev

Visit http://localhost:3000 — you're ready to contribute.

---

🛠️ Tech Stack

Layer	Technology
Framework	Next.js 16 (App Router) + React 19
Language	TypeScript (Strict Mode)
Styling	Tailwind CSS v4 + shadcn/ui
AI	OpenRouter + Groq (DeepSeek V3 / Qwen 2.5)
Auth	NextAuth v5 — GitHub OAuth
GitHub API	Octokit (REST)
Caching	Upstash Redis
Deployment	Vercel (Edge Runtime)

---

🗺️ Roadmap

• GitHub OAuth integration
• Intelligent issue matching algorithm
• AI-generated codebase onboarding & chat
• Interactive open-source learning hub
• One-click Start Contribution → draft PR
• Automated PR status tracking via Webhooks
• Multi-repo favorite collections
• Weekly customized email digests

---

🤝 Contributing

RepoSage is built for contributors — it's only right that contributing to RepoSage itself is painless.

1. Find an open issue that interests you
2. Click Start Contribution (yes, we use our own tool)
3. Write your fix
4. Push to your branch — your draft PR is already waiting

First time contributing to open source? RepoSage will walk you through it. That's the whole point.

Check out our Contributing Guide and please read our Code of Conduct to keep our community approachable and respectable.

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

Built with obsession for the people who want to contribute but don't know where to start.

Try RepoSage →