Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AlonsoSam/vozi-android/llms.txt

Use this file to discover all available pages before exploring further.

VOZI is an educational Android app built with Flutter that guides children ages 4–7 through a structured path of Spanish phoneme practice. It combines image-based word cards, native on-device speech recognition, audio playback, animated character rewards, and a PIN-protected adult dashboard — all designed to be engaging for young learners while giving parents and educators clear visibility into progress.

Introduction

Learn what VOZI is, how the phoneme learning path works, and what makes it privacy-first.

Quickstart

Clone the repo, configure Supabase, and run VOZI on a physical Android device in minutes.

Phoneme Practice

Understand how VOZI evaluates pronunciation using on-device speech-to-text and the WordEvaluator.

Backend & Sync

Set up the Supabase backend, run the SQL schema, and enable optional cloud sync.

How VOZI Works

VOZI structures phoneme learning as a progressive path — children unlock new sounds by practicing the previous one, with each sound (R, RR, S, L, TR, PR, PL, BR, BL) containing 10 practice words. The app runs fully offline and only syncs to Supabase when an adult explicitly initiates it.
1

Set up your environment

Install Flutter, clone the repository, and run flutter pub get to fetch all dependencies.
2

Configure Supabase

Create a Supabase project, run the SQL scripts in supabase/final_reset/, and create a .env file with your URL and anon key.
3

Run on a physical Android device

Connect your Android device with USB debugging enabled and run flutter run. The app works fully offline without Supabase.
4

Explore the adult dashboard

Tap the menu in the child’s home screen, enter PIN 1234 (demo), and explore the parent dashboard to view progress and manage profiles.

Key Features

9-Phoneme Learning Path

R, RR, S, L, TR, PR, PL, BR, BL — each with 10 curated words, images, and MP3 audio.

On-Device Voice Recognition

Speech recognition runs entirely on-device. No audio or transcript is ever uploaded.

Animated Rewards

Rive character animations unlock when a child scores ≥90% correct in a session.

Adult Dashboard

PIN-protected panel with per-phoneme summaries, attempt history, and progress tracking.

Local-First Storage

All data lives on-device with shared_preferences. Supabase sync is optional and manual.

Multi-Child Profiles

Create and manage multiple child profiles with custom avatars and age bands.

Build docs developers (and LLMs) love