DevGrade is a modern, responsive GitHub Portfolio Analyzer built with Next.js. It evaluates a developer's engineering health by analyzing repository data, commit velocity, code complexity, and security practices, ultimately generating a personalized roadmap using Google's Gemini AI.
- Live GitHub Ingestion: Fetches real-time profile, repository, and commit data utilizing the GitHub REST API.
- Advanced Scoring Heuristics: Calculates customized scores for Project Quality, Tech Diversity, Documentation, and Security.
- User Authentication: Supports seamless Email/Password and Google OAuth sign-in flows using Firebase Authentication.
- Session History & Sharing: Automatically saves all analyses evaluated while logged in to Firestore, and allows generating public, immutable shareable snapshot links.
- AI Engineering Roadmap: Dynamically generates actionable career and technical advice tailored to your specific repository metrics using Google Gemini AI.
- Visual Analytics: Beautiful, interactive Radar Charts powered by Recharts.
- Sleek Aesthetic: Minimalist dark-mode UI with a high-tech glowing radial background, smooth entry animations powered by Tailwind CSS and Framer Motion, and custom scrollbars.
- Framework: Next.js (App Router, React 19)
- Styling: Tailwind CSS v4,
clsx,tailwind-merge - Animations & Icons: Framer Motion, Lucide React
- Data Visualization: Recharts
- Database & Auth: Firebase (Authentication, Firestore)
- AI Integration:
@google/genai(Gemini API)
Ensure you have Node.js (v18+) installed.
Create a .env.local file at the root of the project and add your API keys:
GEMINI_API_KEY=your_gemini_api_key_here
GITHUB_TOKEN=your_github_personal_access_token_here
NEXT_PUBLIC_FIREBASE_API_KEY=your_firebase_api_key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_firebase_auth_domain
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_firebase_project_id
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_firebase_storage_bucket
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_firebase_messaging_sender_id
NEXT_PUBLIC_FIREBASE_APP_ID=your_firebase_app_id(Note: Generate your GitHub token from Developer Settings. Generate your Gemini API Key from Google AI Studio. Fetch your Firebase config from the Firebase Console Project Settings.)
Install the dependencies:
npm installStart the development server:
npm run devOpen http://localhost:3000 with your browser to see the result!
Run unit & component tests (Jest):
npm run testRun End-to-End tests (Playwright):
npx playwright install # First time only
npm run test:e2e© 2024 DevGrade Engineering. All rights reserved.