Scientific evaluation tool to help you make informed decisions when choosing an academic advisor.
Visit: https://ktwu01.github.io/advisor-calculator/
Available in 5 languages: English | 中文 | Español | Français | 日本語
Comprehensive assessment across four major categories:
- Personality (4 metrics): Character, communication, management style, relationships
- Academic (4 metrics): Research strength, reputation, funding, career prospects
- Work Environment (6 metrics): Work-life balance, lab conditions, location, team size
- Career Development (6 metrics): Graduation difficulty, mentorship, compensation, peer relationships
- 🎯 Intelligent Weight System - Auto-adjusts based on degree type (Master's/PhD/Postdoc)
- 📊 Risk Analysis - Automatically identifies potential red flags
- 💾 Data Management - Import/export comparisons, local storage
- 🌍 Multi-language - Full support for 5 languages
- 📱 Responsive Design - Works perfectly on desktop and mobile
- 🔒 Privacy First - All data stored locally, never uploaded
Simply visit the live site: ktwu01.github.io/advisor-calculator
No installation required!
# Clone the repository
git clone https://github.com/ktwu01/advisor-calculator.git
cd advisor-calculator
# Install dependencies
npm install
# Start development server
npm run devVisit http://localhost:3000
Build for production:
npm run build
npm start- Deployment Guide - Complete GitHub Pages deployment instructions
- Project Structure - Technical architecture
- Local Preview Guide - How to test builds locally
- Setup Summary - Quick reference for deployment
- Framework: Next.js 15 + TypeScript
- UI Library: shadcn/ui (Radix UI + Tailwind CSS)
- Internationalization: next-intl (5 languages)
- Icons: Lucide React
- Deployment: GitHub Pages + GitHub Actions
- Enter Basic Info - Advisor type, field, title, school level
- Rate 20 Metrics - Use intuitive sliders with descriptive labels
- Get Analysis - Instant score with detailed breakdown
- Compare Advisors - Evaluate up to 3 advisors side-by-side
- Export Data - Save and share your comparisons
- 90-100: ⭐⭐⭐ Excellent Advisor - Highly Recommended
- 80-89: ⭐⭐ Good Advisor - Generally Recommended
- 70-79: ⭐ Average - Consider specific strengths/weaknesses
- 60-69:
⚠️ Somewhat Problematic - Proceed with caution - <60: 🚨 Major Red Flags - Strongly not recommended
Contributions are welcome! Please follow these steps:
- Fork the repository
- Create your feature branch:
git checkout -b feature/AmazingFeature - Commit your changes:
git commit -m 'Add some AmazingFeature' - Push to the branch:
git push origin feature/AmazingFeature - Open a Pull Request
- Use TypeScript for type safety
- Follow ESLint + Biome code standards
- Write functional React components
- Use Tailwind CSS for styling
- Test on both desktop and mobile
This project is licensed under CC BY-NC-ND 4.0
- ✅ Free to use and share
- ❌ No commercial use
- ❌ No modifications/derivatives
- Reference Tool Only - Use as one factor among many in your decision-making
- Privacy Protected - All data stored locally in your browser
- Subjective Evaluation - Results based on your personal judgment
- Your Responsibility - Final decision rests with you
- ✅ 5-language support (EN, ZH, ES, FR, JA)
- ✅ 20-dimension evaluation system
- ✅ Smart risk identification
- ✅ Collapsible detailed analysis
- ✅ GitHub Pages deployment
- ✅ Import/export functionality
- ✅ Multi-advisor comparison
If this tool helps you, please give it a ⭐ Star!
May every student find their ideal advisor and thrive in their academic journey! 🎓