Skip to content

karimaljundi/scholarship-finder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

🎓 Scholarship Search Platform

A full-stack web application that helps students find and filter scholarships from various universities. Currently supporting University of Toronto scholarships data.

🚀 Tech Stack

  • Frontend: React.js with Material-UI
  • Backend: Flask + SQLAlchemy
  • Database: SQLite
  • Web Scraping: Selenium WebDriver
  • API Communication: REST APIs with CORS support

✨ Features

  • Real-time scholarship search and filtering
  • Automated scholarship data scraping
  • Filter scholarships by:
    • 🔍 Name
    • 🌍 Citizenship requirements
    • 💰 Value range
    • 🏛️ University
    • 📚 Type (In-Course, Graduating, Admission)

🔧 Installation

Frontend Setup

cd frontend
npm install
npm start

🌐 API Endpoints

Endpoint Method Description Response
/all_scholarships GET Fetches all available scholarships Array of scholarship objects
/test_db GET Tests database connection Array of scholarship names
/test GET Basic API health check {"message": "Hello, World!"}

📊 Data Model

Scholarship Schema

  • id: Integer (Primary Key)
  • name: String
  • description: Text
  • offered_by: String
  • type: String
  • citizenship_type: String
  • application_required: String
  • nature_of_award: String
  • application_deadline: String
  • value: String
  • university: String

🔄 Web Scraping

The application includes an automated scraper that:

  • Navigates scholarship websites
  • Extracts structured data
  • Filters and processes monetary values
  • Saves to the database automatically

🚧 Future Improvements

  • Add support for more universities
  • Implement user authentication
  • Add scholarship application tracking
  • Implement email notifications
  • Add mobile responsiveness
  • Add advanced filtering options

🤝 Contributing

Feel free to open issues and pull requests for any improvements you'd like to add!


📝 License

This project is MIT licensed.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors