https://github.com/atik203/gradplanner
Decoupled decision-support workspace for Bangladeshi CSE & Engineering students pursuing fully-funded MSc/PhD programs abroad. Built around Bangladesh visa, document, and funding realities.
https://github.com/atik203/gradplanner
bangladesh expressjs nextjs16 nodejs prisma scholarship stem studyabroad
Last synced: 7 days ago
JSON representation
Decoupled decision-support workspace for Bangladeshi CSE & Engineering students pursuing fully-funded MSc/PhD programs abroad. Built around Bangladesh visa, document, and funding realities.
- Host: GitHub
- URL: https://github.com/atik203/gradplanner
- Owner: Atik203
- License: mit
- Created: 2026-05-30T17:02:39.000Z (29 days ago)
- Default Branch: main
- Last Pushed: 2026-06-19T13:44:07.000Z (9 days ago)
- Last Synced: 2026-06-19T14:17:06.470Z (9 days ago)
- Topics: bangladesh, expressjs, nextjs16, nodejs, prisma, scholarship, stem, studyabroad
- Language: TypeScript
- Homepage: https://gradplanner-bd.vercel.app/
- Size: 3.64 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GradPlanner
The ultimate decision-support platform built specifically for Bangladeshi students pursuing graduate admissions (MSc/PhD) abroad in CS, AI, ML, and Engineering.
---
## 🌟 Why GradPlanner?
Standard study-abroad tools focus on generic dashboards and simple university rankings. But applying for a technical graduate degree under a **Bangladeshi passport** presents unique realities.
GradPlanner solves the real bottlenecks:
- **Funding > Rankings:** Prioritizes programs with active TA/RA stipends, DAAD, MEXT, and fully funded fellowship packages.
- **Bangladesh-Specific Visa Intelligence:** Tracks German APS bottlenecks (2.5+ years Dhaka waittimes), Canadian SDS requirements, and USA F-1 interview strategies.
- **Outreach Tracker:** Organizes email pipelines to prospective advisors, managing local local times, follow-up timers, and reply status tracking.
- **Document Timelines:** Schedules document gathering (police clearances, transcript requests, GIC bank transfers) matching Dhaka timeline realities.
---
## 🛠️ Technical Stack
GradPlanner is built as a highly performant, decoupled monorepo:
### Frontend
- **Framework:** Next.js 15 (App Router) with TypeScript
- **State Management:** Redux Toolkit
- **Styling:** Tailwind CSS & shadcn/ui
- **Client Authentication:** `better-auth` client instance
### Backend
- **Server:** Express.js with TypeScript
- **Database ORM:** Prisma Client
- **Database:** PostgreSQL
- **Authentication:** `better-auth` server handler
---
## 📂 Project Structure
```
├── backend/ # Express.js REST API server
│ ├── prisma/ # Database schemas and seeding scripts
│ └── src/ # Controllers, routes, and lib instances
├── frontend/ # Next.js 15 public & dashboard app
│ ├── public/ # Static country and salary JSON metadata
│ └── src/ # Page routers, Redux slices, and UI components
├── AGENTS.md # Product guidance for AI agents
├── CONTRIBUTING.md # Contribution workflows & guidelines
├── LICENSE # MIT License
└── README.md # Main workspace documentation
```
---
## 🚀 Getting Started
### 1. Installation
Install dependencies for both frontend and backend using `pnpm` from the root directory:
```bash
pnpm install
```
### 2. Database Setup & Seeding
Ensure you have a PostgreSQL database running. Create a `.env` file in the `backend/` folder and supply the credentials:
```env
DATABASE_URL="postgresql://user:password@localhost:5432/gradplanner?schema=public"
BETTER_AUTH_SECRET="your-super-secret-auth-key"
```
Apply database migrations:
```bash
cd backend
pnpm exec prisma migrate dev
```
Seed the reference country intelligence and university ranking datasets:
```bash
pnpm exec prisma db seed
```
### 3. Running Locally
Start both services in development mode:
- **Backend Server:**
```bash
cd backend
pnpm dev
```
_(Starts API on `http://localhost:5000`)_
- **Frontend Client:**
```bash
cd frontend
pnpm dev
```
_(Starts Next.js on `http://localhost:3000`)_
---
## 🤝 Contributing
Contributions to GradPlanner are highly welcome! Please read our [CONTRIBUTING.md](file:///e:/PROJECT/GradPlanner/CONTRIBUTING.md) to understand branch conventions, coding guidelines, and PR procedures.
---
## ⚖️ License
Distributed under the MIT License. See [LICENSE](file:///e:/PROJECT/GradPlanner/LICENSE) for more details. Copyright (c) 2026 Atik203.