An Android app that makes assignment submission and grading simple for lecturers and students. Lecturers create courses and assignments, track deadlines, grade work with a rubric, and view analytics. Students browse their courses and submit assignments from their phones.
- Admin dashboard: a central overview of courses, assignments, and submissions
- Navigation drawer: quick access to every lecturer screen
- My Courses: manage the courses you teach
- All Assignments: browse every assignment with live search
- Grading screen: grade submissions using a four-criteria rubric
- Analytics screen: bar charts showing performance and submission data
- Calendar screen: view assignments and deadlines by date
- Browse enrolled courses and assignments
- Submit files for an assignment
- Track deadlines
| Area | Technology |
|---|---|
| Language | Kotlin |
| IDE | Android Studio |
| Database | Firebase Firestore (cross-device sync) |
| File storage | Supabase Storage (free tier) |
| Networking | OkHttp |
- The app originally used a local Room database. It was migrated to Firestore so data syncs across devices.
- Firebase Storage was replaced by Supabase Storage for file uploads, to stay on a free tier.
- Android Studio (latest stable)
- A Firebase project with Firestore enabled
- A Supabase project with a storage bucket
- An Android device or emulator
-
Clone the repository
git clone <your-repo-url> cd SubmitHub
-
Open the project in Android Studio and let Gradle sync finish.
-
Connect Firebase
- In the Firebase Console, add an Android app using this project's package name.
- Download
google-services.json. - Place it in the
app/folder.
-
Connect Supabase
- Create a storage bucket for submissions.
- Add your Supabase URL, API key, and bucket name where the app expects them (for example
local.propertiesor a config file). Do not commit these keys.
-
Run the app
- Select a device or emulator and click Run.
app/
└── src/main/java/.../
├── ui/ # Screens: dashboard, grading, analytics, calendar, courses, assignments
├── data/ # Firestore and Supabase access
├── model/ # Data classes
└── util/ # Helpers
Adjust the folder names above to match your actual package layout.
- Firestore seed guard: prevent sample data from being seeded more than once
- Parallel batch queries for the Analytics screen to speed up loading
- Streaming uploads via OkHttp so large files are not buffered fully in RAM
The app has been tested on a physical Xiaomi device. Please report bugs with clear steps to reproduce, the screen you were on, and what you expected to happen.
- Fork the repository
- Create a branch:
git checkout -b feature/your-feature - Commit your changes:
git commit -m "Add your feature" - Push the branch:
git push origin feature/your-feature - Open a pull request
Add your license here (for example MIT).