Skip to content

Engineering case study · Evidence pack

FM Dictionary.

An evidence-backed case study of a Flutter app for learning Facility Management terminology — from its local-first learning core to its cloud and speech boundaries.

1,847
Current terms
50
Bundled test items
27
Recorded Flutter tests
1.1.0+9
App version

Verified timeline

Git history, without the marketing leap

2026-03-22

Git 6cd2c76

First meaningful development

Flashcards, Hive persistence and text-to-speech established the first learning loop.

2026-05-19

Git a6b69ed

Speech architecture changed

The local Whisper plan moved to online speech APIs behind the proxy boundary.

2026-05-31

Git tag v1.0.0

First explicit release tag

The repository recorded its first explicit application release tag.

2026-06-05

Git tag v1.1.0

Social learning milestone

Global group leaderboard and UI fixes were included in the latest app tag.

2026-09-06

Phase 2 baseline f59332b

Production cleanup completed

Canonicalization and cleanup were completed; Phase 3 adds documentation only.

Actual role

Product owner, maintainer and AI-assisted engineering

The role covers problem definition, requirements, UX/product decisions, directing AI agents, manual testing, acceptance and release decisions. The repository is not used to infer that the maintainer personally typed or independently designed every line.

Architecture exploration

Refactoring

Automated tests

Debugging & audits

Architecture

Clear boundaries over absolute claims

Local

Hive, SharedPreferences and bundled JSON serve core learning paths.

Firebase

Auth, Firestore progress sync and RTDB social data have separate boundaries.

Cloudflare

Authenticated proxy, rate limiting and provider fallback for speech/content requests.

Engineering areas

The parts of the codebase worth showing

Local-first learning data

CODE VERIFIED

Bundled dictionary and tests are imported into Hive. Lookup, saved words, quizzes, tests and much of progress handling have local paths.

Safe content replacement

CODE + TEST VERIFIED

Updates validate IDs, stage a backup, replace the Hive box and restore the previous dictionary if a step fails.

Local and cloud boundaries

CODE VERIFIED / PARTIAL

Firebase Auth, Firestore progress sync and RTDB social data serve different paths; the documented boundaries are not presented as a fully authoritative social backend.

Pronunciation feedback

CODE + TEST VERIFIED

Temporary WAV audio goes through the authenticated proxy, while the returned transcript is scored locally by a rule-based scorer.

Claim boundary

Precision is part of the feature

Safe to say

  • A Flutter app for learning Facility Management terminology.
  • The current repository snapshot contains 1,847 terms and 50 test items.
  • The app combines external speech-to-text fallback with a local rule-based pronunciation scorer.

Do not claim

  • Public App Store, Google Play or TestFlight release without store evidence.
  • Full offline-first support, encrypted local storage or absolute privacy.
  • Authoritative private groups, production scale or a generic AI assistant feature.

FM Dictionary

Back to the product landing

View FM Dictionary