Skip to content

Commit ea40fea

Browse files
committed
Update: Readme for release
1 parent 767ce95 commit ea40fea

File tree

1 file changed

+85
-9
lines changed

1 file changed

+85
-9
lines changed

README.md

Lines changed: 85 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,92 @@
1-
# mujslcm
1+
# SLCM SWITCH
22

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+
---
449

550
## Getting Started
651

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+
```
885

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+
```
1090

11-
- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
12-
- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)
1391

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

Comments
 (0)