RGV_Tutor

RGV Tutor is an offline-first Flutter study app with quizzes, skill tracking, library, and a local AI Helper Bot (Ollama). It supports planning, quizzes, flashcards, and sharing no API keys needed.

Comment

RGV Tutor

Inspiration

RGV Tutor came from seeing how often students in the Rio Grande Valley (and similar communities) get the least consistent academic support—especially when reliable internet isn’t a given. Most “online tutoring” assumes Wi‑Fi; we wanted an offline-first tutor that still helps students practice, track progress, and build confidence even with zero connectivity.

What It Does

  • Provides guided practice by subject/topic with repeatable problem sets
  • Tracks progress over time (what you’ve mastered vs. what needs work)
  • Avoids endless repetition by remembering “seen” questions locally
  • Includes a simple planner so students can turn goals into daily tasks
  • Works fully offline via local persistence (no internet required)

How We Built It

  • Flutter app with a layered structure: Models → State → Screens → Persistence
  • State-driven tutoring loop: serve a problem, record correctness, update progress/mastery, pick the next best item
  • Offline storage with Hive for user data, progress, planner entries, and “seen” question IDs
  • Test coverage focused on real workflows: auth state, planner behavior, and a widget test for the Auth UI toggle

Challenges We Ran Into

  • Flutter/SDK drift (deprecations + theme API type changes) causing build and analyzer issues
  • Offline-first testing complexity: isolating Hive storage and keeping tests deterministic
  • Quality debt piling up (unused imports, deprecated APIs, async context warnings) that slowed iteration
  • Removing “unused” code safely without breaking runtime navigation or indirect references

Accomplishments We’re Proud Of

  • True offline-first behavior: the app stays usable without connectivity
  • Cleaner, more reliable codebase (analyzer/lint issues addressed)
  • Persistence-backed progress + planner that survives restarts seamlessly
  • A small but meaningful test suite that protects the core user journey

What We Learned

  • Offline-first isn’t a toggle—it changes modeling, migrations, loading states, and test strategy
  • UI polish comes from consistency (theme cleanup, simpler widget trees, avoiding deprecated patterns)
  • Tests are easiest when core logic lives in state/services rather than the UI
  • “It works” isn’t enough—cleaning lints and dead code dramatically speeds up future development

What’s Next for RGV Tutor

  • Expand the content pipeline: more subjects, difficulty tiers, and tagged skills
  • Smarter adaptation: adjust problem selection using recent accuracy + spacing/review intervals
  • Add richer offline analytics (streaks, mastery breakdowns, weak-skill recommendations)
  • Optional sync when internet exists (backup/restore, multi-device continuity) without breaking offline-first
  • Improve accessibility and UX (reader mode, larger text controls, clearer feedback after answers)

Built With

Share this project:

Updates