Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Cristiang1021/ErgoKawsay/llms.txt

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

ErgoKawsay (alli kawsay, allí kana — “to live well, to be well”) is a mobile application built with Flutter for Android, designed to promote the ergonomic health and overall well-being of teachers. It brings together guidance on posture, musculoskeletal disease prevention, guided active breaks, emotional wellness, and multimedia resources — all within a single, fully offline app. ErgoKawsay was developed as an academic project under the institutional identity of ESPOCH (Escuela Superior Politécnica de Chimborazo), addressing the unique physical and mental health challenges teachers face in the classroom every day. All content is available in both Spanish (es) and Kichwa (qu), reflecting a commitment to intercultural accessibility.

Modules

ErgoKawsay is organized into eleven focused modules, each targeting a specific dimension of teacher well-being:

Ergonomics

Interactive story-deck cards, postural illustrations, and a review quiz covering classroom ergonomics for teachers.

Diseases

Information on carpal tunnel syndrome, tendinitis, lower back pain, and cervicalgia — including when to seek medical attention.

Active Breaks

A guided 5-minute break sequence covering the neck, shoulders, wrists, lower back, and breathing to relieve tension during the school day.

Exercises

Eight body-area categories: neck, shoulders, hands, back, hips, legs, vision (20-20-20 rule), and 4-7-8 breathing.

Emotions

Emotional health support for anger, sadness, joy, fear, and anxiety — each paired with a unique character (Inti, Yaku, Rumirumi, Tutam, Chaskym).

Tips

Rotating preventive tips for everyday classroom practice to maintain good ergonomic and mental habits.

Music

Ambient audio environments — forest sounds, gentle rain, and energizing music — for focus or relaxation.

Videos

Integrated video player featuring postural ergonomics and a 7-minute yoga session for teachers.

Reminders

Local notifications scheduling active-break and daily exercise reminders, with a configurable night-silence mode.

Progress

Tracks module usage and engagement so teachers can monitor their well-being habits over time.

Settings

Language selection (Spanish / Kichwa), light/dark/system theme, text-size scaling, color-blind filter, and ESPOCH institutional info.

Technology Stack

TechnologyVersionRole
Flutter3.2+Cross-platform UI framework (Android target)
Dart3.2+Programming language (included with Flutter)
Provider^6.1.2State management (locale, theme, accessibility)
shared_preferences^2.2.3Local persistence (language, progress, reminders, profile)
flutter_local_notifications^17.2.3Scheduled reminder notifications
just_audio^0.9.40Ambient audio playback
video_player^2.9.2In-app educational video playback
google_fonts^6.2.1Typography (runtime fetching disabled for offline use)
ErgoKawsay has no backend, no authentication, and no network dependency. Every module, data set, audio file, and video is bundled with the app. GoogleFonts.config.allowRuntimeFetching is explicitly set to false, ensuring the app starts correctly on devices without an internet connection.

Language Support

The app ships with full bilingual support across every screen and module:
CodeLanguage
esSpanish (Español)
quKichwa
All translatable strings are maintained in a single source file (translations.yaml) and compiled into lib/core/localization/tr.dart via a Python code-generation tool. Because Kichwa (qu) is not a supported locale in flutter_localizations, the app includes custom LocalizationsDelegate implementations that fall back to Spanish Material and Widgets localizations, ensuring dialogs, time pickers, and other system widgets render correctly in both languages.
Teachers can switch between Spanish and Kichwa at any time from the Settings module or during the initial language-selection onboarding screen — no restart required.

Build docs developers (and LLMs) love