GitGrade is an AI-driven GitHub Portfolio Analyzer designed to simulate how hiring managers evaluate GitHub profiles in under 60 seconds.
It converts raw repository data into structured hiring signals, objective scoring, and actionable improvement insights.
Built for the GitHub Portfolio Analyzer & Enhancer Hackathon 2026.
Most GitHub profiles fail to clearly communicate:
- Real engineering depth
- Consistent activity
- Documentation quality
- Community impact
Recruiters typically scan GitHub profiles quickly and form immediate impressions.
GitGrade bridges the gap between raw code and hiring signals.
GitGrade evaluates GitHub profiles using structured recruiter-style metrics across:
- Documentation Quality
- Project Depth (Original vs Forked Work)
- Activity Consistency
- Impact Signals (Stars & Engagement)
- Profile Completeness
It then generates:
- Overall Score (0–100)
- Letter Grade (A+ to D)
- Internship Readiness Level
- Confidence Indicator
- Hiring Signals
- Risk Indicators
- Prioritized Growth Recommendations
- 30-Day Upgrade Plan
- Featured Project Highlight
- Recruiter Summary
- Live URL: https://gitgrade-vxg4.onrender.com/
- Demo Video: https://drive.google.com/file/d/1tlsXgfrGu7hdurqcE2ES9ULtWwXXCiqd/view?usp=sharing
- LinkedIn : https://www.linkedin.com/posts/shreejahebbar676_hackathon-github-webdevelopment-activity-7429205427533520896-QF2I?utm_source=share&utm_medium=member_desktop&rcm=ACoAAFslmPoBTABDozy0D-_vvy8hebzjTpzivLU
Total Score (0–100) is calculated using weighted structured metrics:
| Category | Max Score |
|---|---|
| Documentation | 20 |
| Depth | 25 |
| Consistency | 20 |
| Impact | 20 |
| Completeness | 15 |
- README presence detection
- Recent commit analysis (last 6 months)
- Fork contribution bonus
- Star-based impact scaling
- Profile bio & metadata completeness check
Score Classification:
- 90+ → A+ (Advanced)
- 80–89 → A
- 70–79 → B
- 60–69 → C
- <60 → D
GitGrade includes:
Simulates a 60-second recruiter review:
- Overall Score
- Top Hiring Signals
- Top Risk Indicators
- Verdict
Comprehensive evaluation with breakdown, growth plan, and featured project.
Frontend
- HTML5
- CSS3 (Custom design system + animations)
- Vanilla JavaScript
Backend
- Node.js
- Express.js
- Axios
- GitHub REST API
- dotenv (for secure token handling)
GitGrade uses GitHub's REST API to fetch:
- User profile data
- Public repositories
- README availability
- Commit history (last 6 months)
- Star counts
- Fork data
A GitHub Personal Access Token is supported to avoid API rate limits.
git clone https://github.com/Shreeja-88/github-portfolio-analyzer.git
cd github-portfolio-analyzer
npm install
Create a .env file in the root:
GITHUB_TOKEN=your_personal_access_token
(Optional but recommended to avoid API rate limits)
npm start
Open:
http://localhost:5000
- Structured recruiter-aligned scoring
- Confidence level indicator
- Benchmark comparison (Top 10% scoring insight)
- Featured project auto-detection
- Prioritized improvement system (HIGH / MEDIUM / LOW)
- 30-Day Upgrade Plan
- Clean premium UI
- Quick Scan simulation mode
This project directly addresses:
- Recruiter-style evaluation logic
- Signal clarity
- Actionable improvement feedback
- Engineering quality and reliability
- Clear structured scoring methodology
GitGrade transforms GitHub from a code repository into a recruiter-readable professional proof.
Shreeja Hebbar Built for GitHub Portfolio Analyzer & Enhancer Hackathon 2026