ScholarSeeker AI 🎓

A modern scholarship discovery platform powered by AI, helping international students locate funding opportunities at top U.S. universities.

---

Table of Contents 📑

• Features
• Tech Stack
• Getting Started
  • Prerequisites
  • Installation
  • Running Locally
• Project Structure
• Deployment
• Contributing
• License

---

Features ✨

• 🔍 AI-powered scholarship search
• 🎯 Advanced filtering (location, degree level, award amount)
• 🏫 Detailed university profiles
• 📊 Scholarship insights and visual statistics
• 💻 Fully responsive, mobile-first design
• 🚀 Performance optimized with Next.js Image & CDN caching
• ✨ Interactive UI animations powered by Framer Motion

Tech Stack 🛠️

• Framework: Next.js (App Router)
• Language: TypeScript
• Styling: Tailwind CSS + shadcn/ui
• Animations: Framer Motion
• Icons: Lucide
• Deployment: Vercel

Getting Started 🚀

Prerequisites

• Node.js v18.x or higher
• pnpm v7.x or higher (or yarn & npm)

Installation

1. Clone the repository:

   git clone https://github.com/Davidson3556/ScholarSeeker-AI.git
   cd ScholarSeeker-AI

2. Install dependencies:

   pnpm install

Running Locally

pnpm dev

Open http://localhost:3000 in your browser.

Project Structure 🗂️

.
├── app/                   # Next.js App Router pages & layouts
│   ├── about/
│   ├── construction/
│   ├── school/
│   └── search/
├── components/            # Reusable UI components
│   ├── home/
│   ├── scholarship/
│   └── ui/
├── lib/
├── services/
├── types/                 # TypeScript interfaces & types
├── public/                # Static assets (images, fonts)
└── styles/                # Global & theme styles

Deployment 🚀

This project is configured for seamless deployment on Vercel:

1. Push your code to GitHub.
2. Log in to Vercel and create a new project.
3. Select your GitHub repository.
4. Deploy with the default settings.

Vercel will automatically:

• Detect the Next.js framework
• Build & optimize assets
• Enable HTTPS and CDN caching
• Provide deployment previews and analytics