🎯 DevScope - Real GitHub Analytics & AI-Powered Developer Insights

Real GitHub analytics meets AI-powered insights. Track your actual coding activity, analyze GitHub data, discover community trends, and get intelligent recommendations — all with real data, no demos.

🚀 What's New in v1.1.0

✨ 100% Real Data Integration

• No More Demo Mode: Authentic GitHub OAuth authentication only
• Live GitHub Analytics: Real commit history, activity, and repository insights
• Community Discovery: Browse actual GitHub users and their projects
• AI-Powered Analysis: Groq/OpenAI integration for genuine code insights

🔐 Enhanced Security

• Zero Hardcoded Secrets: All credentials via environment variables
• Git Security: Comprehensive .gitignore prevents credential commits
• Production Ready: Secure configuration management

🎯 Key Features

📊 Real GitHub Analytics

• Activity Dashboard: Live GitHub events, commits, and repository statistics
• Language Analysis: Actual programming language usage from your repositories
• Contribution Patterns: Weekly focus charts based on real commit history
• Community Insights: Discover trending developers and repositories

🤖 AI-Powered Insights

• Code Analysis: AI-driven repository and commit analysis via Groq/OpenAI
• Quick Insights: Instant AI feedback on your coding patterns
• Development Coaching: Intelligent recommendations based on your actual activity

🔐 Secure & Private

• GitHub OAuth: Secure authentication with your GitHub account
• Local Processing: AI analysis respects your privacy
• No Demo Data: Everything you see is your real development activity

---

🏗️ Architecture & Tech Stack

Frontend (Production Ready ✅)

• Framework: Next.js 15 + React 19
• Language: TypeScript
• Styling: Tailwind CSS
• Authentication: GitHub OAuth via Supabase
• Real-time Data: GitHub API integration
• Charts: Chart.js for live data visualization

Backend (Production Ready ✅)

• Framework: FastAPI
• Database: PostgreSQL + SQLAlchemy ORM
• Authentication: JWT + GitHub OAuth
• API Integration: GitHub REST API
• Documentation: OpenAPI/Swagger

AI Engine (Production Ready ✅)

• Framework: FastAPI
• AI Providers: Groq (primary) + OpenAI (fallback)
• Features: Repository analysis, commit insights, code coaching
• Language: Python with modern async support
• Platform: Cross-platform (Windows, macOS, Linux)

VS Code Extension (Production Ready ✅)

• Language: TypeScript
• Integration: VS Code API
• Features: Activity tracking, productivity sidebar, Git integration
• Backend Sync: Real-time session synchronization

AI Engine (Production Ready ✅)

• Language: Python
• ML Libraries: OpenAI GPT integration
• Features: Commit analysis, productivity insights, activity classification

---

🎯 Current Development Stage

Stage 5: GitHub & VSCode Integration ✅ COMPLETE

Delivered Features:

🔌 VSCode Extension

• ✅ Activity Tracking - Real-time file monitoring and session detection
• ✅ Productivity Sidebar - Live productivity metrics and session stats
• ✅ Git Integration - Repository context and branch tracking
• ✅ Backend Sync - Automatic synchronization with DevScope backend
• ✅ Idle Detection - Smart idle time tracking and session management
• ✅ Error Handling - Robust offline support and error recovery

🐙 GitHub App Integration

• ✅ Webhook Processing - Automated push, PR, and review event handling
• ✅ AI Commit Analysis - GPT-powered commit message and diff analysis
• ✅ Security - GitHub signature verification and secure webhook handling
• ✅ Rate Limiting - Intelligent request management and retry logic
• ✅ Database Integration - Full activity storage and retrieval

🚀 Backend Enhancements

• ✅ VSCode API Endpoints - Complete /vscode/* API suite
• ✅ GitHub Event Processing - Enhanced /github-events handling
• ✅ Authentication Improvements - Dev/prod mode support
• ✅ Error Handling - Comprehensive logging and monitoring

Previous Stages:

Stage 3: Smart Focus Timer + Mood Tracker ✅ COMPLETE

Delivered Features:

• ✅ Pomodoro Timer with 25/5 minute focus/break cycles
• ✅ Real-time Activity Monitoring (keyboard/mouse tracking)
• ✅ Idle Detection with 30-second threshold and notifications
• ✅ Comprehensive Mood Tracking with post-session analytics
• ✅ Offline Support with localStorage and automatic sync
• ✅ Session Statistics with real-time updates
• ✅ Production APIs with full authentication and security

Technical Achievements:

• Complete offline-first architecture with sync capabilities
• Real-time activity monitoring with efficient event handling
• Comprehensive analytics engine with mood-productivity correlations
• Production-ready security with JWT, rate limiting, and CORS
• Type-safe development with TypeScript throughout

---

📂 Project Structure

DevScope/
├── 🌐 frontend/          # Next.js web application (✅ Complete)
│   ├── src/app/          # App router with dashboard
│   ├── src/components/   # Reusable UI components
│   ├── src/lib/          # API client & utilities
│   └── src/hooks/        # Custom React hooks
│
├── ⚡ backend/           # FastAPI server (✅ Complete)
│   ├── app/api/          # API endpoints & routing
│   ├── app/auth/         # Authentication logic
│   ├── app/models/       # Database models
│   └── app/schemas/      # Pydantic schemas
│
├── 🖥️ desktop/          # Tauri desktop app (🚧 In Progress)
│   ├── src/              # React frontend
│   └── src-tauri/        # Rust backend
│
├── 🔌 extension/         # VS Code extension (✅ Complete)
│   ├── src/              # TypeScript extension code
│   ├── package.json      # Extension manifest
│   └── README.md         # Extension documentation
│
└── 🤖 ai-engine/         # ML analytics (✅ Complete)
    ├── analyzer.py       # AI commit analysis
    ├── git_parser.py     # Git repository processing
    └── main.py           # Analysis pipeline

---

🚀 Getting Started

Prerequisites

• Node.js 18+
• Python 3.12+
• PostgreSQL (or SQLite for development)
• Supabase account (for authentication)

Quick Start

1. Clone the repository

   git clone https://github.com/MananVyas01/DevScope.git
   cd DevScope

2. Install dependencies

   # Frontend
   cd frontend && npm install
   
   # Backend
   cd ../backend && pip install -r requirements.txt

3. Set up environment variables## 🚀 Quick Start

Prerequisites

• Node.js 18+ and npm
• Python 3.8+ with pip
• GitHub Account (for authentication and data)
• Groq or OpenAI API Key (for AI features)

Setup Instructions

1. Clone the repository

   git clone https://github.com/your-username/devscope.git
   cd devscope

2. Install dependencies

   # Root dependencies
   npm install
   
   # Frontend
   cd frontend && npm install && cd ..
   
   # Backend Python dependencies
   cd backend && pip install -r requirements.txt && cd ..
   
   # AI Engine dependencies
   cd ai-engine && pip install -r requirements.txt && cd ..

3. Setup Environment Variables

   Frontend (.env.local):

   # Copy example and configure
   cp frontend/.env.example frontend/.env.local
   
   # Add your Supabase credentials
   NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

   Backend (.env):

   # Copy example and configure
   cp backend/.env.example backend/.env
   
   # Configure Supabase
   SUPABASE_URL=your_supabase_project_url
   SUPABASE_ANON_KEY=your_supabase_anon_key
   SUPABASE_SERVICE_KEY=your_supabase_service_key
   JWT_SECRET=your_jwt_secret
   
   # Optional: GitHub OAuth (for enhanced features)
   GITHUB_CLIENT_ID=your_github_oauth_client_id
   GITHUB_CLIENT_SECRET=your_github_oauth_client_secret

   AI Engine (.env):

   # Copy example and configure
   cp ai-engine/.env.example ai-engine/.env
   
   # Add at least one AI provider (Groq recommended)
   GROQ_API_KEY=your_groq_api_key_here
   # OR
   OPENAI_API_KEY=your_openai_api_key_here

4. GitHub OAuth Setup (Required)

   Create a GitHub OAuth App:

   • Go to GitHub Settings → Developer settings → OAuth Apps
   • Create new OAuth App with:
     • Homepage URL: http://localhost:3000
     • Authorization callback URL: your_supabase_url/auth/v1/callback
   • Add Client ID and Secret to your environment files

5. Start All Services

   # Option 1: Start everything with turbo (recommended)
   npm run dev
   
   # Option 2: Start individually
   # Terminal 1: AI Engine
   cd ai-engine && python main.py
   
   # Terminal 2: Backend
   cd backend && python -m app.main
   
   # Terminal 3: Frontend
   cd frontend && npm run dev

6. Access the Application

   • Frontend: http://localhost:3000
   • Backend API: http://localhost:8000/docs
   • AI Engine: http://localhost:8001/docs

First-Time Setup

1. Visit http://localhost:3000
2. Sign in with your GitHub account
3. Authorize DevScope to access your GitHub data
4. Explore your real analytics and community features
5. Try AI insights from the analytics dashboard

---

🎮 Features Overview

📊 Real GitHub Analytics

• Live Activity Dashboard: Your actual GitHub events, commits, and contributions
• Repository Insights: Language usage, commit patterns, and project statistics
• Weekly Focus Charts: Visual representation of your coding activity over time
• Contribution Streaks: Track your consistency and productivity patterns

🌐 Community Discovery

• Developer Profiles: Browse real GitHub users and their activity
• Repository Exploration: Discover trending and interesting repositories
• Language Statistics: See what technologies the community is using
• Activity Feeds: Real-time GitHub activity from discovered users

🤖 AI-Powered Insights

• Repository Analysis: AI-driven analysis of your repositories and coding patterns

• Quick Insights: Instant AI feedback on your development workflow

• Code Quality Tips: Intelligent suggestions based on your actual commits

• Productivity Coaching: AI recommendations for improving your development process

• Post-Session Tracking: Modal after each focus session

• Multi-Dimensional Metrics: Mood (1-5), Energy (1-5), Stress (1-5)

• Correlation Analysis: Understand relationships between mood and productivity

• Historical Trends: Track patterns over time with beautiful charts

VSCode Extension Integration

• Real-time Activity Tracking: Monitors file changes and coding sessions
• Productivity Sidebar: Live metrics panel with daily statistics
• Git Integration: Automatic repository and branch context detection
• Session Management: Smart idle detection and session boundaries
• Offline Support: Works without internet, syncs when available

GitHub App Integration

• Automatic Webhook Processing: Handles push, PR, and review events
• AI-Powered Commit Analysis: GPT-based analysis of commit quality and patterns
• Security: GitHub signature verification and secure webhook handling
• Activity Correlation: Links GitHub activity with productivity sessions

Offline-First Architecture

• Complete Offline Support: Works without internet connection
• Automatic Sync: Data synchronizes when connection is restored
• Network Status Indicators: Visual feedback for online/offline state
• Data Persistence: localStorage with intelligent sync mechanisms

---

🛠️ Development Roadmap

✅ Completed Stages

• Stage 1: Project setup and architecture design
• Stage 2: Backend API with authentication and database
• Stage 3: Smart Focus Timer with mood tracking
• Stage 4: AI-powered activity analysis and commit insights
• Stage 5: GitHub App integration and VSCode extension

🚧 Current Development

• Stage 6: Desktop application enhancement with Tauri

📋 Planned Features

• Enhanced Team Analytics: Collaborative productivity insights
• Calendar Integration: Meeting and schedule awareness
• Custom Workflows: Personalized productivity patterns
• Export & Reporting: Comprehensive productivity reports
• Mobile App: React Native productivity companion

---

🚀 Deployment

Production Ready

• Frontend: Vercel deployment configured
• Backend: Railway deployment with PostgreSQL
• Database: Production-ready with migrations
• Authentication: Supabase integration complete
• Monitoring: Health checks and logging implemented

Environment Support

• Development: Local development with hot reload
• Staging: Testing environment with real data
• Production: Scalable cloud deployment

---

👨‍💻 About the Creator

DevScope is created and maintained by Manan Vyas, a passionate developer focused on building tools that enhance developer productivity and workflow optimization.

• GitHub: @MananVyas01
• Project Repository: DevScope

🤝 Contributing

We welcome contributions from the community! Here's how you can get involved:

🚀 Quick Start for Contributors

1. Fork the repository
2. Clone your fork: git clone https://github.com/your-username/DevScope.git
3. Install dependencies: npm install (in root for workspaces)
4. Copy environment template: cp .env.example .env
5. Set up your API keys (see Setup Guide)
6. Create a feature branch: git checkout -b feature/amazing-feature
7. Make your changes and test thoroughly
8. Commit your changes: git commit -m 'Add amazing feature'
9. Push to your branch: git push origin feature/amazing-feature
10. Open a Pull Request

🎯 Areas for Contribution

• 🐛 Bug Fixes: Found an issue? We'd love your help fixing it
• ✨ New Features: Ideas for productivity tracking improvements
• 📚 Documentation: Help improve our guides and API docs
• 🧪 Testing: Add tests to improve code coverage
• 🎨 UI/UX: Design improvements and accessibility enhancements
• 🚀 Performance: Optimization and speed improvements
• 🔌 Integrations: New service integrations (Slack, Discord, etc.)

📋 Development Guidelines

• Follow the existing code style and patterns
• Add tests for new features
• Update documentation for API changes
• Ensure all tests pass before submitting PR
• Use meaningful commit messages
• Keep PRs focused and reasonably sized

🌟 Code of Conduct

We're committed to providing a welcoming and inclusive environment. Please be respectful and professional in all interactions.

💬 Get Help

• Issues: Report bugs or request features via GitHub Issues
• Discussions: Join community discussions for questions and ideas
• Security: For security issues, please email security@devscope.dev

---

📝 License

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

---

🙏 Acknowledgments

Built with amazing open source technologies:

• Next.js - React framework
• FastAPI - Python web framework
• Supabase - Backend as a service
• Tauri - Desktop app framework
• Groq - AI inference platform
• TailwindCSS - Utility-first CSS

⭐ Star History

If this project helped you, please give it a star! ⭐

---