Skip to content

Sha1kh4/yd-checker

Repository files navigation

Semester Subject Selector

Description

This project is a React-based web application designed to help students, particularly those from MIT (DBATU), select and manage their backlog subjects across different semesters. It allows users to choose subjects, calculates total credits, and provides visual and audio feedback based on the credit load.

Features

  • Semester selection dropdown
  • Subject checkboxes for each semester
  • Real-time credit calculation
  • Visual feedback (image changes based on credit load)
  • Audio feedback (sound plays when credit load changes)
  • List of selected subjects
  • Clear selection button

Technologies Used

  • React
  • Next.js
  • TypeScript
  • Tailwind CSS

Installation

  1. Clone the repository:

    git clone https://github.com/Sha1kh4/yd-checker.git
    
  2. Navigate to the project directory:

    cd yd-checker
    
  3. Install dependencies:

    npm install
    
  4. Run the development server:

    npm run dev
    
  5. Open http://localhost:3000 with your browser to see the result.

Usage

  1. Select a semester from the dropdown menu.
  2. Check the boxes next to the subjects you want to select.
  3. The total credits will be calculated automatically.
  4. An image will display indicating whether your credit load is manageable.
  5. A sound will play when the credit load changes significantly.
  6. Use the "Clear Selections" button to reset your choices.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is open source and available under the MIT License.

Credits

Developed by SKAD for MIT Batu final year students.

Contact

For any queries, please contact Shaikh Adnan at [email protected].