|
1 | | -# mujslcm |
| 1 | +# SLCM SWITCH |
2 | 2 |
|
3 | | -mujSCLM but better |
| 3 | +A mobile application designed to provide a modern, accessible interface for the university's SLCM website. Built using Flutter and FastAPI, this app allows students to view attendance, grades, timetable. |
| 4 | + |
| 5 | +--- |
| 6 | + |
| 7 | +## Project Goal |
| 8 | + |
| 9 | +To build a secure, responsive, and user-friendly app that replicates and enhances the functionality of the university's existing SLCM web system, making it more accessible for students and class representatives on mobile devices. |
| 10 | + |
| 11 | +--- |
| 12 | + |
| 13 | +## Installation |
| 14 | + |
| 15 | +### Android |
| 16 | +- Download the latest release APK from the [Releases](https://github.com/DK10WS/SLCM_APP/releases) section. |
| 17 | +- Install it on your device. Make sure to enable "Install from Unknown Sources" in your settings. |
| 18 | + |
| 19 | +### iOS |
| 20 | +- Visit [https://betterslcm.whyredfire.tech](https://betterslcm.whyredfire.tech) in Safari. |
| 21 | +- Tap the **Share** icon and select **“Add to Home Screen”** to install it as a Web App. |
| 22 | + |
| 23 | +## Features |
| 24 | + |
| 25 | +- **Login System** |
| 26 | + Secure email/password authentication with Student and Parents Login. |
| 27 | + |
| 28 | +- **Timetable & Calendar View** |
| 29 | + View your class schedule. |
| 30 | + |
| 31 | +- **Grades and Attendance** |
| 32 | + Automatically fetch and display grades, GPA/CGPA, and subject-wise attendance from the SLCM system. |
| 33 | + |
| 34 | +- **Modern UI** |
| 35 | + Responsive Flutter UI with dark mode and glassmorphic design for enhanced user experience. |
| 36 | + |
| 37 | +--- |
| 38 | + |
| 39 | +## Tech Stack |
| 40 | + |
| 41 | +| Layer | Technologies | |
| 42 | +|---------------|----------------------------------| |
| 43 | +| **Frontend** | Flutter, Dart | |
| 44 | +| **Backend** | FastAPI (Python) | |
| 45 | +| **Auth** | Email & Password (custom logic) | |
| 46 | +| **Deployment**| Docker | |
| 47 | + |
| 48 | +--- |
4 | 49 |
|
5 | 50 | ## Getting Started |
6 | 51 |
|
7 | | -This project is a starting point for a Flutter application. |
| 52 | +### Prerequisites |
| 53 | + |
| 54 | +- Flutter SDK |
| 55 | +- Python 3.9+ |
| 56 | +- Docker (optional for deployment) |
| 57 | + |
| 58 | +### Installation |
| 59 | + |
| 60 | +1. **Clone the Repository** |
| 61 | + |
| 62 | +```bash |
| 63 | +git clone https://github.com/DK10WS/SLCM_APP.git |
| 64 | +cd SLCM_APP |
| 65 | +flutter pub get |
| 66 | +flutter build apk |
| 67 | +``` |
| 68 | + |
| 69 | + |
| 70 | +## Contributing |
| 71 | + |
| 72 | +We welcome contributions! To get started: |
| 73 | + |
| 74 | +1. **Fork** the repository to your own GitHub account. |
| 75 | + |
| 76 | +2. **Clone** your forked repo and create a new feature branch: |
| 77 | + ```bash |
| 78 | + git checkout -b feature/YourFeatureName |
| 79 | + |
| 80 | +3. Make your changes and commit them with clear messages: |
| 81 | + |
| 82 | + ``` bash |
| 83 | + git commit -m "Add YourFeatureName" |
| 84 | + ``` |
8 | 85 |
|
9 | | -A few resources to get you started if this is your first Flutter project: |
| 86 | +4. Push the changes to your GitHub fork: |
| 87 | + ``` bash |
| 88 | + git push origin feature/YourFeatureName |
| 89 | + ``` |
10 | 90 |
|
11 | | -- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab) |
12 | | -- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook) |
13 | 91 |
|
14 | | -For help getting started with Flutter development, view the |
15 | | -[online documentation](https://docs.flutter.dev/), which offers tutorials, |
16 | | -samples, guidance on mobile development, and a full API reference. |
| 92 | +5 .Open a Pull Request from your branch to the main branch of this repository. |
0 commit comments