Skip to content

sr-tamim/eduman.ui

Repository files navigation

EduMan UI

EduMan UI is a Next.js 15 (App Router) campus management interface that brings key student services into a single, modern dashboard. The current implementation focuses on a polished UI/UX with authentication flows and rich, interactive modules for cafeteria, transportation, schedules, and events/clubs.

✨ Highlights

  • Secure authentication flow with login, register, logout, and protected routes.
  • Dashboard experience with animated feature cards and responsive navigation.
  • Cafeteria module with menu cards, filtering, and search.
  • Transportation module with routes, schedules, and stop information.
  • Schedule module with day-based class filtering and faculty details.
  • Events & Clubs module with tabbed UI, filters, and create dialogs.
  • Reusable UI system built on Radix UI and Tailwind CSS.

🧰 Tech Stack

  • Next.js 15 (App Router)
  • React 19 + TypeScript
  • Tailwind CSS
  • Radix UI
  • React Query
  • React Hook Form + Zod
  • Axios

✅ Requirements Document

Detailed scope and roadmap are documented in REQUIREMENTS.md.

🛠️ Getting Started

Prerequisites

  • Node.js (version >= 16)
  • Git
  • A package manager (npm, yarn, pnpm, or bun)

Installation

Clone the repository:

git clone https://github.com/sr-tamim/eduman.ui.git
cd eduman.ui

Install dependencies:

yarn

Environment Variables

Create a .env.local file in the project root:

NEXT_PUBLIC_API_BASE_URL=http://localhost:3000/dev

Running the Development Server

yarn dev

Open http://localhost:3000 in your browser to view the app.

Useful Scripts

  • yarn dev — start dev server
  • yarn build — production build
  • yarn start — run production server
  • yarn lint — lint codebase
  • yarn type-check — TypeScript type check

📖 Resources

💬 Contributing

Contributions are welcome. Open an issue or submit a pull request with clear context.

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributors