VU Helping Kit
A timed Firestore quiz engine, PDF handout library and study-group directory for distance-learning students
A solo-built Flutter app for Virtual University of Pakistan students: a category-driven quiz engine pulling randomized, timed questions from Firestore, plus browsable handouts, past papers and assignment solutions delivered as cached PDFs, alongside a WhatsApp study-group directory and video-lecture links.
Source is private. The timed quiz engine and the Firestore content model behind every section are explained below.
About this project
The home screen is six function cards — Take Quiz, Assignment/GDB Solutions, View Handouts, View Past Paper/Notes, WhatsApp Groups, Video Lectures — each drilling into a category-then-subject picker before landing on content, all read from one shared Cloud Firestore database with no login of any kind; every screen is open to whoever installs the app.
The quiz engine is the deepest part: pick a subject, choose Mid Term or Final Term, and the app pulls that subject's question set live from Firestore, serving 10 randomly-ordered multiple-choice questions with a 30-second per-question countdown that auto-advances — and logs the question as missed — if the timer lapses. Each answer flashes green or red immediately, and the run ends on a two-tab Result screen: a scored summary (attempted, correct, missed, total and average time, percentage) and a full answer sheet comparing every selected answer against the correct one, with a one-tap retake.
Handouts, past papers and assignment materials are not generated in-app — they're externally-hosted PDFs referenced from Firestore, rendered through a cached in-app PDF viewer. Assignments add a live Active/Expired deadline banner computed from a stored due date, plus separate Question File and Solution File links and an optional external Solution Video link. A WhatsApp study-group directory and a video-lecture directory round out the app, each split into course-based and general categories and opening real external links.
Built and shipped solo, on Android.
Key features
- Category-driven quiz engine: subject → Mid Term/Final Term → 10 randomly-ordered MCQs pulled live from Firestore, with a 30-second per-question countdown that auto-advances (and logs the question as missed) on timeout
- Live green/red per-answer feedback, then a two-tab Result screen — scored summary (attempted/correct/missed/total & average time/percentage) plus a full answer sheet comparing every selected vs. correct answer — with one-tap retake
- Handouts and past-paper/notes browsing: category → subject → a search-filtered list of externally-hosted PDFs, rendered through a cached in-app viewer
- Assignment/GDB solutions with a live Active/Expired deadline banner computed from a Firestore due date, separate Question File and Solution File PDF links, and an optional external Solution Video link
- WhatsApp study-group directory and a video-lecture directory, each split into course-based vs. general categories, opening real external links
- Search-as-you-type filtering on every list screen (quiz subjects, handouts, past papers, assignments)
- Native share sheet and a Play Store rating deep link from the nav drawer; double-tap-back-to-exit on the home screen
More in Education
Learning Management System
AI-assisted coaching platform — student app, admin console, and a multi-provider AI backend
A Flutter learning and personal-development platform built as a student app and an admin console over one Firestore backend, with an in-app AI assistant — chat, per-lesson summaries and recommendations — powered by a dedicated OpenAI/Gemini/Groq backend with vector search over the course library.
School Management Suite
Three coordinated apps, one shared backend
A school-management platform built as three coordinated Flutter apps — a student/parent app, a teacher professional-development app and a staff operations app — sharing account and content infrastructure, with a standalone AI prototype exploring automated student-performance summaries.
Citizen Science Site
A public water-quality dashboard — an interactive grade-coded map, trend charts and a heatmap over live field data
A Next.js web dashboard for community-collected water-quality data — an interactive Leaflet map with A–F grade-coded markers and a heatmap mode, multi-parameter trend and comparison charts, and region/date/grade filtering, reading from a shared Firestore collection.
~/sherazi.dev$./say-hello
Say hello.
Questions about a case study, one of the packages, AI tooling or Flutter in general are always welcome.
// or browse the packages on pub.dev(opens in a new tab)