A community-built alumni platform for IIIT Lucknow — a central hub where graduates and current students can find each other, share opportunities, and stay connected after college. Built by Axios, IIITL.
Project status: Early — help wanted! See open issues to contribute.
Screenshots will be added once the UI stabilises. Below are placeholder descriptions of the key pages.
| Page | Description |
|---|---|
| Home | Hero section, upcoming events, alumni spotlight, latest news |
| Directory | Searchable alumni list filtered by batch, branch, company, or city |
| Events | Reunions, meetups, and community calls |
| Jobs board | Roles and internships shared by IIITL alumni |
| Giving | Donate to student innovation funds |
- Node.js ≥ 18
- pnpm ≥ 8 (
npm install -g pnpm) - Git
git clone https://github.com/MrImmortal09/alumni.git
cd alumnipnpm installCopy the example file and fill in values (see Environment Variables below):
cp .env.example .env.localpnpm devOpen http://localhost:3000 in your browser.
| Command | Description |
|---|---|
pnpm dev |
Start Next.js dev server with hot-reload |
pnpm build |
Production build |
pnpm start |
Start production server (requires pnpm build first) |
pnpm lint |
Run ESLint across the project |
The test suite is being set up — tracking issue coming soon.
Once tests are added, run them with:
pnpm testLint checks (which CI enforces) can be run at any time:
pnpm lintalumni/
├── app/ # Next.js App Router pages & layouts
│ ├── layout.tsx # Root layout (fonts, Navbar, Footer)
│ ├── page.tsx # Home page
│ ├── about/
│ ├── directory/
│ ├── events/
│ ├── jobs/
│ ├── news/
│ └── ...
├── components/ # Shared UI primitives
│ ├── Navbar.tsx
│ ├── Footer.tsx
│ └── Section.tsx
├── lib/ # Data helpers and utilities
└── public/ # Static assets
Please read CONTRIBUTING.md before opening a pull request. It covers branch naming, commit style, code style, and how to pick up issues.
This project is open-source under the MIT License.