Flut - ENT ISEN is a mobile application developed by students for students, aimed at simplifying access to ISEN's digital workspace (ENT). The app allows users to:
- Check Grades: View your latest grades and academic performance.
- Track Absences: Stay updated with your attendance records.
- View the Agenda: Never miss a class or event by syncing with the school agenda.
The application is built using Flutter and Dart, ensuring a seamless cross-platform experience for both Android and iOS devices.
Make sure you have the following installed on your machine:
- Flutter SDK (v3.0.0 or higher)
- Dart SDK
- An IDE with Flutter support (e.g., Android Studio or VSCode)
- A connected Android/iOS device or emulator for testing
We welcome all contributions from the community, whether it's fixing bugs, adding new features, or improving the documentation. Follow these steps to get started:
-
Fork the Project:
- Click the "Fork" button at the top right of this repository to create your own copy.
-
Clone the Repository:
- Clone the forked repository to your local machine:
git clone https://github.com/JacksonKyoshi/ENT-ISEN-FLUT.git cd Flut-ENT-ISEN
- Clone the forked repository to your local machine:
-
Create a New Branch:
- Create a new branch to work on your feature or bug fix:
git checkout -b feature/your-feature-name
- Be sure to name your branch descriptively (e.g.,
feature/add-login-screen,bugfix/fix-logout-issue).
- Create a new branch to work on your feature or bug fix:
-
Install dependencies: Ensure all required packages are installed by running the following command in the project directory:
flutter pub get
-
Run the app: Launch the app on an emulator or connected device:
flutter run
-
Make Changes:
- Work on your feature or fix within your new branch. Be sure to write clean, readable, and well-documented code.
- If you're fixing a bug, try to include a test case that reproduces the bug to ensure it's fixed.
-
Commit Changes:
- Commit your changes with a meaningful commit message:
git add . git commit -m "Add feature: implement login screen"
- Commit your changes with a meaningful commit message:
-
Push to GitHub:
- Push your changes to the feature branch in your forked repository:
git push origin feature/your-feature-name
- Push your changes to the feature branch in your forked repository:
-
Submit a Pull Request:
- Go to the original repository and click "New Pull Request".
- Select the correct branches for the comparison (e.g.,
yourusername:feature/your-feature-nameagainstmainof the original repository). - Provide a detailed description of your changes, including the reason behind them.
- Code Style: Follow the established code style guidelines for the project.
- Commit Messages: Write clear and concise commit messages. Use present-tense and imperative mood (e.g., "Fix bug", "Add new feature").
- Pull Request Reviews: Be prepared for feedback and changes requested in your pull request. It's a collaborative process, and every suggestion aims to improve the codebase.
If you find any bugs or have feature requests, please open an issue on the Issue Tracker with detailed information about the problem or idea.
This project is licensed under the MIT License - see the LICENSE file for details.
For any questions or suggestions, feel free to open an issue or reach out support@isenengineering.fr