AwardScope is an AI-powered financial aid discovery platform designed to help students unlock their funding potential. By leveraging advanced matching algorithms and generative AI, AwardScope connects students with high-value scholarships and bursaries they actually qualify for—and helps them write the winning essays.
- Real-Time Eligibility: Instantly filters hundreds of awards based on your GPA, faculty, year, and demographic profile.
- Precision Scoring: categorizes opportunities into Perfect Matches (90%+ fit), Good Matches, and Partial Matches.
- Zero Noise: Hides awards you aren't eligible for, saving you hours of searching.
- Instant Blueprints: Generates personalized essay outlines, hooks, and talking points for any specific award.
- Typewriter Effect: Watch as the AI "thinks" and types out your essay strategy in real-time.
- Tailored Content: Analyzes the award's criteria to suggest the most impactful angles for your application.
- Cosmic Aesthetic: A deep, immersive dark mode with rich gradients and floating background elements.
- Interactive Glass Cards: Frosted glass effects with dynamic hover glows and lighting.
- Fluid Animations: Smooth transitions and entrance effects powered by
framer-motion.
- React 18 (TypeScript)
- Tailwind CSS (Styling & Design System)
- Framer Motion (Advanced Animations)
- Lucide React (Iconography)
- Vite (Build Tool)
- Framer Motion (Animation)
- Node.js & Express
- MongoDB (Database)
- Google Gemini API (Generative AI)
- Docker & Docker Compose (Containerization)
- Docker Desktop installed and running.
-
Clone the repository:
git clone https://github.com/Tjindl/AwardScope.git cd AwardScope -
Set up Environment Variables:
- Create a
.envfile in theBackenddirectory. - Add your MongoDB URI and Gemini API Key:
MONGODB_URI=your_mongodb_connection_string GEMINI_API_KEY=your_gemini_api_key
- Create a
-
Run with Docker:
docker-compose up --build
-
Access the App:
- Frontend:
http://localhost:8080 - Backend API:
http://localhost:3001
- Frontend:
- Select Your University: Choose from supported institutions (currently UBC) on the home page.
- Create Your Profile: Enter your academic details, affiliations, and demographics. No account needed.
- View Your Matches: Automatically see the top awards you qualify for, sorted by match strength.
- Draft Your Essay: Click the "AI Architect" button on any award card to generate a winning essay structure instantly.
- Multi-University Support: Expanding database to SFU, UVic, and BCIT.
- User Accounts: Save your profile and track applied scholarships.
- Deadline Reminders: Email notifications for upcoming award deadlines.
- Alumni Success Stories: ML-based recommendations from successful past applicants.
This project is open-source and available under the MIT License.
Built with ❤️ for Hack the Coast