An open API service indexing awesome lists of open source software.

https://github.com/andriamahay11master/devscope

An AI-powered GitHub analytics platform that transforms developer profiles into insightful dashboards, showcasing repository activity, coding trends, top technologies, and intelligent developer summaries through modern data visualization.
https://github.com/andriamahay11master/devscope

axios fastapi framer-motion python react react-router recharts rest-api tailwindcss vite

Last synced: 20 days ago
JSON representation

An AI-powered GitHub analytics platform that transforms developer profiles into insightful dashboards, showcasing repository activity, coding trends, top technologies, and intelligent developer summaries through modern data visualization.

Awesome Lists containing this project

README

          

# DevScope

An AI-powered GitHub analytics platform that transforms developer profiles into insightful dashboards, showcasing repository activity, coding trends, top technologies, and intelligent developer summaries through modern data visualization.

---

## ๐Ÿš€ Features

- ๐Ÿ” Search any GitHub developer profile
- ๐Ÿ“Š Interactive analytics dashboard
- ๐Ÿง  AI-generated developer insights
- ๐Ÿ“ Repository explorer
- ๐ŸŒ Most used programming languages
- โญ Stars, forks, followers, and activity metrics
- ๐Ÿ“ˆ Charts and visual statistics
- ๐ŸŒ™ Dark / Light mode
- โšก Fast and responsive interface

---

## ๐Ÿ› ๏ธ Tech Stack

### Frontend

- React
- Vite
- TailwindCSS
- Axios
- React Router
- Framer Motion
- Recharts

### Backend

- FastAPI
- Python
- GitHub REST API

### Deployment

- Frontend: Vercel
- Backend: Render

---

## ๐Ÿ“‚ Project Structure

```bash
DevScope/
โ”œโ”€โ”€ client/
โ””โ”€โ”€ server/
```

---

## ๐Ÿงฉ Architecture

```text
React Frontend
โ†“
FastAPI REST API
โ†“
GitHub REST API
```

---

## ๐Ÿ“ธ Planned Dashboard Analytics

- Total repositories
- Total stars
- Followers & following
- Most used languages
- Repository activity
- Most starred repositories
- Account creation timeline
- AI profile summary

---

## โš™๏ธ Installation

### 1. Clone the repository

```bash
git clone https://github.com/yourusername/devscope.git
cd devscope
```

---

## ๐Ÿ–ฅ๏ธ Frontend Setup

```bash
cd client

npm install

npm run dev
```

Frontend runs on:

```bash
http://localhost:5173
```

### ๐Ÿงช Run Frontend Tests

```bash
cd client

npm run test
```

Run test for one component:

```bash
cd client

npm run test -- src/components/loader/Loader.test.tsx
```

Run tests in interactive mode:

```bash
npm run test:ui
```

Generate coverage report:

```bash
npm run coverage
```

---

## ๐Ÿง  Backend Setup

```bash
cd server

python -m venv venv
```

### Activate virtual environment

#### Windows

```bash
venv\Scripts\activate
```

#### macOS / Linux

```bash
source venv/bin/activate
```

### Install dependencies

```bash
pip install -r requirements.txt
```

### Run FastAPI server

```bash
uvicorn app.main:app --reload
```

Backend runs on:

```bash
http://localhost:8000
```

---

## ๐Ÿ”‘ Environment Variables

Create a `.env` file inside the `server/` folder.

```env
GITHUB_TOKEN=your_github_token
```

---

## ๐Ÿ“Œ API Endpoint Example

```http
GET /api/github/{username}
```

Example:

```http
GET /api/github/gaearon
```

---

## ๐ŸŽฏ Project Goals

- Practice REST API integration
- Learn full-stack architecture
- Build production-ready React applications
- Integrate AI into developer tooling
- Create a strong portfolio project

---

## ๐Ÿšง Roadmap

### Version 1

- [x] Project setup
- [ ] GitHub user search
- [ ] Profile dashboard
- [ ] Repository listing

### Version 2

- [ ] Charts and analytics
- [ ] AI-generated summaries
- [ ] Favorites system
- [ ] Authentication

### Version 3

- [ ] Compare multiple developers
- [ ] Export analytics reports
- [ ] Team analytics dashboard

---

## ๐Ÿค Contributing

Contributions, ideas, and feedback are welcome.

---

## ๐Ÿ“„ License

This project is licensed under the MIT License.