Empowering high school counselors to guide students toward their future with AI-powered insights and comprehensive college planning tools.
PathFinder isn't just another student tracking tool—it's an AI-powered college counseling platform that helps students make better decisions and avoid costly mistakes.
- Comprehensive Profile Analysis: AI evaluates 40+ data points across academics, extracurriculars, character, and milestones
- Overall AI Score (0-100): Instant assessment of college readiness
- Personalized Recommendations: AI-generated college suggestions based on student profile
- Admission Chance Prediction: Data-driven probability estimates for target schools
- Interactive AI Advisor: Chat with AI to ask questions about student profiles and college planning
- 15 Real Universities: Curated database with admission requirements and financial data
- 50+ Scholarship Programs: Automatically match students to relevant scholarships
- Smart Categorization: Reach, Target, Safety school recommendations
- Financial Aid Calculator: Estimate net costs and scholarship eligibility
- Match Scoring: Proprietary algorithm scores fit based on GPA, test scores, interests, and more
- Future Failure Simulation: Imagine decisions already failed—what went wrong?
- Risk Assessment (0-100%): Calculate probability of regret for major decisions
- Scenario Generation: See realistic failure scenarios (debt spiral, academic overwhelm, culture mismatch, etc.)
- Early Warning Signs: Red flags to watch for after making a decision
- Mitigation Strategies: Actionable steps to reduce risk with pros/cons analysis
- Decision Types: College choice, major selection, financial decisions, career paths
- Academic Evolution: GPA tracking, class rank, course rigor, test scores
- Extracurricular Impact: Activities, leadership roles, hours, impact statements
- Character & Skills: Observations, soft skills, teacher feedback
- Milestones: Awards, certifications, projects, achievements
- AI-Powered Analytics: Overall cohort insights and top performers
- Progress Tracking: Visual completion indicators for each student
- Search & Filter: Instant student lookup
- Multi-Sort: By leadership, community service, academic excellence, or AI score
- Node.js 16+ and npm
- Git
# Clone the repository
git clone https://github.com/Saunders-Trinity/theFuture.git
cd theFuture
# Install dependencies
npm install
# Start development server
npm startThe app will automatically open at http://localhost:3000 🚀
npm run buildOptimized production build will be in the build/ directory.
- React 18.2 - Modern UI framework
- Tailwind CSS 3.3 - Utility-first CSS framework
- Lucide React - Beautiful icon library
- date-fns - Date formatting and manipulation
- jsPDF + html2canvas - PDF export for college resumes
- Custom AI Algorithms - Profile analysis, college matching, pre-mortem decision analysis
- Clerk Authentication - Secure user management
- React Router - Client-side routing
hackathon/
├── public/
│ └── index.html # HTML template
├── src/
│ ├── components/
│ │ ├── Common/ # Shared components
│ │ │ ├── Header.jsx # Navigation header
│ │ │ ├── Footer.jsx # Footer component
│ │ │ ├── ProgressBar.js # Progress indicator
│ │ │ ├── SearchBar.js # Student search
│ │ │ ├── AIAssistant.js # AI chat interface
│ │ │ ├── AIInsightsPanel.js # AI insights display
│ │ │ ├── CollegeScholarshipFinder.js # College matching UI
│ │ │ └── PreMortemAnalyzer.js # Decision autopsy UI
│ │ ├── Dashboard/ # Dashboard components
│ │ │ ├── Dashboard.js # Main dashboard
│ │ │ └── StudentCard.js # Student summary cards
│ │ └── StudentProfile/ # Profile builder
│ │ ├── StudentProfile.js # Main profile container
│ │ ├── AcademicSection.js # Academic data
│ │ ├── ExtracurricularSection.js # Activities
│ │ ├── CharacterSection.js # Character traits
│ │ └── MilestonesSection.js # Achievements
│ ├── pages/
│ │ ├── Landing.js # Landing page
│ │ ├── GetStarted.js # Onboarding
│ │ └── Dashboard.js # Dashboard page
│ ├── data/
│ │ ├── mockData.js # Sample student data
│ │ └── collegeDatabase.js # 15 universities + scholarships
│ ├── utils/
│ │ ├── aiInsights.js # AI analysis engine (700+ lines)
│ │ ├── collegeMatching.js # Matching algorithm (600+ lines)
│ │ ├── preMortemAnalysis.js # Decision autopsy (700+ lines)
│ │ └── pdfExport.js # PDF generation
│ ├── App.js # Main app logic
│ ├── index.js # Entry point
│ └── index.css # Global styles
├── README.md
├── package.json
└── tailwind.config.js
-
Dashboard Overview
- View all students with completion percentages
- See AI-powered analytics (average AI score, top performers, students needing attention)
- Search and filter students
-
Student Profiles
- Click any student card to open their profile
- Fill in data across 4 pillars: Academic, Extracurricular, Character, Milestones
- Add class rank and GPA trends
-
AI Insights (Tab 5)
- View overall AI score (0-100)
- See identified strengths and growth opportunities
- Get college recommendations with admission chances
- Chat with AI Advisor for personalized advice
-
College & Scholarship Finder (Tab 6)
- See top 5 college matches automatically
- View reach, target, and safety schools
- Browse 50+ matching scholarships
- Calculate net costs with financial aid estimates
-
Pre-Mortem Decision Autopsy (Tab 7)
- Help students analyze major decisions (college choice, major selection, loans, etc.)
- See realistic failure scenarios and risk scores
- Get mitigation strategies and alternative options
- Prevent costly mistakes before they happen!
-
Export PDFs
- Generate professional college resumes
- Include all profile data in clean format
What it does:
- Analyzes student profile across 40+ data points
- Calculates weighted score: Academic (40%), Extracurricular (30%), Character (20%), Milestones (15%)
- Generates personalized recommendations
Example Output:
{
overallScore: 82,
strengths: ["Strong STEM coursework", "Consistent leadership roles"],
growthOpportunities: ["Limited community service", "No major competitions"],
collegeRecommendations: [
{ name: "MIT", admissionChance: 45%, fit: 88% },
{ name: "Georgia Tech", admissionChance: 72%, fit: 91% }
]
}Matching Criteria:
- Academic match (GPA, test scores, course rigor)
- Interest alignment (major, extracurriculars)
- Geographic preference
- Financial fit (cost, scholarships)
- Diversity factors
Categorization:
- Reach: Admission chance < 30%
- Target: Admission chance 30-70%
- Safety: Admission chance > 70%
How Pre-Mortem Works: Instead of asking "What could go right?" we ask: "Imagine this decision failed. What went wrong?"
Example: Expensive Dream School
Decision: "Attend Stanford with $120k in loans vs. UC Berkeley with $20k in loans"
Analysis:
- Overall Risk: 78% (RED LIGHT)
- Top Failure: Debt Death Spiral (80% probability)
"You graduate with $180k debt. Monthly payment is $2,100 for 10 years.
After taxes, you have $2,000/month for everything in San Francisco
where rent is $2,500/month. You're forced to live with parents and
work 2 jobs while friends from cheaper schools enjoy their 20s."
Warning Signs:
- "It's my dream school, money doesn't matter" thinking
- Assuming "I'll definitely get a $150k job at Google"
- Parents borrowing against retirement
Recommendation: Choose UC Berkeley - same CS education, 1/4 the debt
- 15 Universities: Harvard, Stanford, MIT, UC Berkeley, UCLA, Georgia Tech, UIUC, UW-Madison, Penn State, Wisconsin, Purdue, ASU, U of Arizona, Iowa State
- Real Admission Data: GPA/SAT ranges, acceptance rates, application deadlines
- 50+ Scholarships: Merit-based, need-based, diversity, STEM, arts, athletics
Overall Score (0-100):
├── Academic (40%)
│ ├── GPA (weighted by rigor)
│ ├── Test scores (SAT/ACT)
│ ├── AP/IB courses
│ └── Grade trends
├── Extracurricular (30%)
│ ├── Leadership positions
│ ├── Time commitment
│ ├── Impact & achievements
│ └── Variety of activities
├── Character (20%)
│ ├── Soft skills
│ ├── Teacher feedback
│ └── Personal qualities
└── Milestones (15%)
├── Awards & honors
├── Certifications
└── Notable projects
(Add screenshots here when available)
- Landing Page - Beautiful hero section with feature highlights
- Dashboard - Student cards with AI analytics
- Student Profile - Comprehensive data entry
- AI Insights - Profile analysis with recommendations
- College Finder - University matches with scholarships
- Pre-Mortem - Decision risk analysis
We welcome contributions! Here's how to get started:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with ❤️ by the PathFinder team
- Inspired by the need to democratize college counseling
- Special thanks to all educators who guide students toward their dreams
- GitHub Issues: Report bugs or request features
- Repository: https://github.com/Saunders-Trinity/theFuture
- MongoDB integration for data persistence
- Real-time collaboration for counselor teams
- Parent portal for family involvement
- Mobile app (React Native)
- Integration with Common App API
- Advanced analytics dashboard
- Email notifications and reminders
- Document upload (transcripts, essays)
Made with 💙 to help every student find their path