Studygranthub

StudyGrantHub is an automated, high-performance global scholarship aggregator web application. It monitors over 15+ government portals, university exchange programs, and international grant databases to surface fully funded scholarships, tuition waivers, stipends, and fellowship opportunities worldwide.

Developed by Agnific.

🌟 Key Features

1. Global Scholarship Discovery & Responsive Views

• Responsive 4-Column Card Grid & List Views: Instant layout switching between rich visual cards (3–4 per row on desktop) and a compact list row format.
• Status-Colored Ambient Hover Glow: Cards feature spotlight borders with color-coded ambient glows reflecting real-time application window status:
  • 🟢 Open (Emerald Green Glow)
  • 🔵 Upcoming (Sky Blue Glow)
  • ⚪ Closed (Slate Muted Glow)
• Interactive Calendar Timeline: Visual timeline grouping scholarships by opening dates and closing deadlines.

2. Intelligent Search & Granular Filtering

• Horizontal Dropdown Filter Bar: Streamlined single-row filter bar with real-time criteria selection:
  • Sort Order: Best Match, Closing Soonest, Newest Added, Highest Funding, Title (A-Z).
  • Degree Level: Bachelor's, Master's, PhD, Postdoc, Diploma.
  • Funding Type: Fully Funded, Partial, Stipend-only, Tuition Waiver, Grant.
  • Valid For (Applicant Country): Smart normalized eligibility matching for Pakistan, India, Bangladesh, Nigeria, Egypt, and global applicants.
  • Host Country & Field of Study.
  • Deadline Proximity Range: 7 days, 30 days, 90 days.

3. Smart Eligibility Parsing & Deep Links

• Dual-Layer Eligibility Storage: Separates user-facing display strings (eligibleCountriesDisplay) from normalized ISO/country search lists (eligibleCountriesList).
• Broad Keyword & Region Recognition: Recognizes broad eligibility terms ("Foreign Students", "Non-US Citizens", "Commonwealth", "Rhodes Constituencies", "EU Member States") and auto-expands them so international applicants never miss out.
• Deep-Link Sharing: Synchronizes modal states to browser URLs (?grant=<id>). Shared links automatically open the exact scholarship detail view on direct URL load. Includes Web Share API + clipboard fallback with confirmation toast.

4. Admin Portal & Data Pipeline Management

• Password-Gated Admin Portal: Secured session access backed by rate-limiting and bcrypt hash authentication.
• Multi-Source Scraper Registry: Tracks and manages 15+ live crawler sources across North America, Europe, East Asia, Oceania, Middle East, and Africa.
• Live Review Queue: Flagged ambiguous scraper records (e.g. uncertain date strings or broad country categories) are routed to a dedicated Review Queue with side-by-side raw vs. best-guess values for admin approval, inline editing, or rejection.
• Batch Scrape Sanity Reporting: Tracks real-time batch execution with live delta metrics (+N new live grants published · M pending review).
• Recurring Crawler Scheduling: Configure custom recurring crawl intervals per source (minutes, hours, days, weeks, months) or apply global default schedules.
• Feature-Flagged Email Alerts & SMTP Config: Admin toggle (emailAlertsEnabled) to show/hide deadline reminder subscription forms for students, paired with secure server-side SMTP configuration storage.

🛠️ Technology Stack

• Core Framework: React 19 + TypeScript + Vite
• Styling: Vanilla CSS design system + Tailwind CSS utilities
• Motion & Visual Effects: motion (Framer Motion v12) + Lucide Icons + Custom BorderGlow ReactBits component
• Data Persistence: LocalStorage & SessionStorage state synchronization

🚀 Local Development Setup

Prerequisites

• Node.js v18.0.0 or higher
• npm v9.0.0 or higher

Installation

1. Clone the repository:

   git clone https://github.com/Agnific/StudyGrantHub.git
   cd StudyGrantHub
   

2. Install dependencies:

   npm install
   

3. Start the local Vite development server:

   npm run dev
   

   Open your browser and navigate to http://localhost:5173.

4. Build for production:

   npm run build
   

5. Preview production build locally:

   npm run preview
   

📄 License & Attribution

Designed & Developed by Agnific.
All rights reserved © 2026 StudyGrantHub.