Welcome to the Exam Day Finder application! This tool helps students quickly find their exam schedule by simply entering their roll number.
https://giaic-exams-schedule.vercel.app/
- Easy to Use: Enter your roll number to search for your exam date, day, and time.
- Responsive Design: Accessible on both desktop and mobile devices.
- Frontend: Next.js, TypeScript, Tailwind CSS
- Backend: Node.js, Express.js
- Database: MongoDB
- Validation: Zod
Follow these steps to set up the project locally.
Make sure you have the following installed:
- Node.js
- npm (Node Package Manager)
- MongoDB
-
Clone the Repository:
git clone https://github.com/yourusername/giaic-exams-schedule.git cd giaic-exams-schedule
-
Install Dependencies:
npm install
-
Set Up Environment Variables: Create a
.env
file in the root directory and add the following:MONGODB_URI="your_mongodb_connection" BASE_URI="http://localhost:3000"
-
Run the Application:
npm run dev
- Open your browser and navigate to
http://localhost:3000
. - Enter your roll number in the input field.
- Click the "Search" button to find your exam date, day, and time.
pages/
: Contains Next.js pages.components/
: Contains React components.lib/
: Contains utility functions and validation schemas.public/
: Contains static assets.
- Fork the repository.
- Create a new branch (
git checkout -b feature/your-feature-name
). - Commit your changes (
git commit -m 'Add some feature'
). - Push to the branch (
git push origin feature/your-feature-name
). - Open a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.
Happy coding! If you have any questions or need further assistance, feel free to open an issue or contact us.