IIIT Naya Raipur Attendance App

The IIIT Naya Raipur Attendance App is a simple mobile application built with React Native that allows students to easily mark their attendance for selected courses. The app offers a clean and interactive interface for managing attendance and provides real-time attendance percentage tracking.

Features:

• Mark Attendance 📝: Students can mark attendance for the courses they are enrolled in.
• View Attendance 📊: Check the current attendance percentage for each course.
• Interactive UI 🎨: The app has a clean, simple, and interactive UI that enhances usability.
• Course Management 📚: Easily manage and track attendance for selected courses.
• Cross-Platform Support 📱: Built with React Native, the app works on both Android and iOS devices.

---

Purpose

This app aims to automate and simplify the process of attendance marking, reducing manual work and helping students keep track of their attendance in real-time. It is especially useful for remote learning and maintaining up-to-date attendance records. 🚀

---

Technologies Used:

• React Native ⚛️: The app is built using React Native for cross-platform mobile development.
• Local Storage 📥: For storing and retrieving attendance data.

---

Setup Instructions

Follow the steps below to get started with the project locally:

1. Clone the Repository

First, clone the repository to your local machine:

git clone https://github.com/manaspros/AttendanceApp

2. Install Dependencies

Navigate to the project directory and install the required dependencies:

cd AttendanceApp
npm install

3. Run the App

Start the application locally:

npm start

Your app should now be running on the default browser or emulator.

Contributing

We welcome contributions from everyone to improve the app. Whether you're fixing a bug, adding a new feature, or improving documentation, your help is appreciated! Follow the steps below to contribute:

Steps to Contribute to feature

1. Fork the Repository: Click the "Fork" button at the top-right of the repository to create a copy of the repo in your GitHub account.

2. Create a Branch: Create a new branch for the feature you're working on:

   git checkout -b feature/your-feature-name

3. Make Changes: Implement your feature the bug in the code.

4. Test Your Changes: Run the app and test the changes locally to make sure everything works.

5. Commit Your Changes: Once you're satisfied with the changes, commit them to your branch:

   git add .
   git commit -m "Describe the changes you've made"

6. Push the Changes: Push your branch to your forked repository:

   git push origin feature/your-feature-name

7. Create a Pull Request: Go to the original repository and create a pull request (PR) from your forked repo to the main repository. Provide a clear description of what your PR does.

Steps to Contribute to Issues

1. Find an Issue: Browse the Issues section of the repository and choose one you'd like to work on. If you spot a bug not listed, feel free to create a new issue.

2. Comment on the Issue: Let others know you're working on it by leaving a comment on the issue, e.g.,

   "I’d like to work on this issue. Assign it to me, please!"

3. Fork the Repository: Click the "Fork" button at the top-right of the repository to create a copy in your GitHub account.

4. Create a Branch: Create a branch named after the issue number you're working on. For example:

   git checkout -b issue/#issue-number

5. Make Changes: Implement your fix or enhancement related to the issue.

6. Test Your Changes: Run the app and ensure your changes resolve the issue without introducing new bugs.

7. Commit Your Changes: Once satisfied, commit your changes with a descriptive message:

   git add .
   git commit -m "Fix: Describe what issue you resolved (#issue-number)"

8. Push the Changes: Push your branch to your forked repository:

   git push origin issue/#issue-number

9. Create a Pull Request: Go to the original repository and create a pull request (PR) from your forked branch to the main repository. Reference the issue number in your PR description (e.g., Closes #123).

By following these steps, you'll help improve the project while ensuring the community collaborates effectively! 🚀

License

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

Contact

For any questions or suggestions, feel free to reach out:

• Manas DSAI
• Email: [email protected]

---

Thanks for contributing and helping improve this project!