ErgoKawsay Settings: Language, Theme, Accessibility

The Settings screen is the single place where teachers can tailor every aspect of ErgoKawsay to suit their classroom environment, device preferences, and individual needs. From choosing a language to activating a colorblind color filter, each preference is written to SharedPreferences immediately on change — there is no save button to forget. The screen is also available as an embedded widget for use inside the home tab without a navigation push.

Settings Categories

Language
Theme
Accessibility
Teacher Profile

ErgoKawsay ships with full bilingual support for Spanish (es) and Kichwa (qu). The current language is displayed in the row’s subtitle and tapping opens the LanguageSelectionScreen as a full-screen modal dialog.

// Persist a language selection
await storage.setLanguage('qu'); // 'es' or 'qu'

// Read the active language
final lang = storage.getLanguage(); // returns null if unset

Changing the language immediately reloads all UI strings from the app’s localization layer (AppLocalizations). The entire widget tree rebuilds with the new locale — no restart required.A secondary “Reset language” row (shown in a destructive red style) clears the persisted language via storage.clearLanguage() and navigates back to the initial /language onboarding screen, allowing the teacher to pick a different language from scratch.

The language selection screen (/language) also appears during first launch. Returning to it from Settings does not reset any other preferences.

Three theme modes are available, presented as a segmented pill selector:

Option	`ThemeMode` value	Behavior
System	`ThemeMode.system`	Follows the Android system dark/light setting
Light	`ThemeMode.light`	Forces the light palette
Dark	`ThemeMode.dark`	Forces the dark palette

// Set theme mode (persisted to SharedPreferences key keyThemeMode)
await storage.setThemeMode(ThemeMode.dark);

// Read theme mode (defaults to ThemeMode.system)
final mode = storage.getThemeMode();

The app uses Material 3 with a custom AppPalette theme extension, so both palettes share the same component geometry and typography — only colors change. Tapping any segment applies the change instantly via ThemeControllerScope.

Two accessibility controls are available, each stored as part of the AccessibilitySettings model.Text SizeThree named presets drive a global text scale factor applied via TextScaler.linear:

Option	`TextSizeOption`	`textScale`
Normal	`TextSizeOption.normal`	`1.0`
Large	`TextSizeOption.large`	`1.18`
Extra-large	`TextSizeOption.extraLarge`	`1.38`

Tapping the row opens a bottom sheet with the three options. Selecting one calls AccessibilityControllerScope.of(context).updateSettings(a), which propagates the new textScale to the root MediaQuery so every text widget in the app scales immediately.Colorblind ModeA toggle row enables or disables a color filter for color vision accessibility. When active, a ColorFiltered widget wraps the entire app tree and applies a color matrix. The toggle calls:

await storage.saveAccessibilitySettings(
  _accessibility.copyWith(colorBlind: true),
);

Both settings are persisted together under the SharedPreferences key AppConstants.keyAccessibility ("accessibility") as a JSON object.

// Read accessibility settings
final a11y = storage.getAccessibilitySettings();
// a11y.textScale  → double (1.0 / 1.18 / 1.38)
// a11y.colorBlind → bool

// Save updated settings
await storage.saveAccessibilitySettings(a11y.copyWith(colorBlind: true));

The teacher’s display name and avatar are shown on the home screen greeting. Tapping “Edit profile” opens TeacherProfileScreen as a full-screen modal.

// Persist profile fields
await storage.setProfileName('Ana Torres');
await storage.setProfileAvatar('/data/user/0/.../avatar.jpg');

// Read profile fields
final name   = storage.getProfileName();   // String?
final avatar = storage.getProfileAvatar(); // String? (file path)

An additional boolean flag profileCompleted tracks whether the teacher has gone through the initial profile setup flow:

await storage.setProfileCompleted(true);
final done = storage.getProfileCompleted(); // bool (default false)

Profile data is stored in SharedPreferences under AppConstants.keyProfileName ("profile_name"), AppConstants.keyProfileAvatar ("profile_avatar"), and AppConstants.keyProfileCompleted ("profile_completed").

AccessibilitySettings Model

enum TextSizeOption { normal, large, extraLarge }

class AccessibilitySettings {
  final TextSizeOption textSize; // default: TextSizeOption.normal
  final bool colorBlind;        // default: false

  // Derived scale factor consumed by MediaQuery via TextScaler.linear
  double get textScale => switch (textSize) {
    TextSizeOption.normal     => 1.0,
    TextSizeOption.large      => 1.18,
    TextSizeOption.extraLarge => 1.38,
  };
}

The model serializes to JSON as { "textSize": "normal", "colorBlind": false } and is stored under the "accessibility" SharedPreferences key. Deserialization is null-safe and falls back to defaults for any missing field.

Active Break Notifications (Settings Screen Controls)

The Settings screen also exposes the full reminders configuration as a dedicated “Active breaks” section, surfacing the same data as the standalone /reminders screen through a set of tappable rows and a master toggle:

Master Notifications Toggle

A Switch row bound to storage.notificationsEnabled. When turned off, NotificationService.instance.cancelAll() is called and no new notifications are scheduled — regardless of the individual ReminderSettings.notificationsActive flag. When turned back on, the stored ReminderSettings are immediately re-applied.

await storage.setNotificationsEnabled(false); // cancels all
await storage.setNotificationsEnabled(true);  // re-schedules

Work Schedule

Opens a bottom sheet with two time pickers (start and end hour). Updates ReminderSettings.workStartHour and ReminderSettings.workEndHour, then re-schedules all notifications for the new window.

Break Frequency

Opens a bottom sheet with presets (every 30 min, 45 min, 60 min) and a custom slider (10–120 min). Updates ReminderSettings.breakFrequencyMinutes and, for custom values, ReminderSettings.customFrequencyMinutes.

Reminder Types

Opens a bottom sheet with five checkboxes: neck, shoulders, vision, breathing, hydration. Updates ReminderSettings.reminderTypes.

Test Notification

Calls NotificationService.instance.showTestNotification(locale) immediately and shows a confirmation snackbar. Useful for verifying that the Android notification channel is correctly registered on the device.

All settings are persisted immediately on change via their respective StorageService methods. No save button is required anywhere on the Settings screen.

SharedPreferences Keys

All Settings-related data uses the following keys from AppConstants:

Constant	Key string	Used for
`AppConstants.keyLanguage`	`"language"`	Selected locale (`"es"` or `"qu"`)
`AppConstants.keyThemeMode`	`"theme_mode"`	Active `ThemeMode`
`AppConstants.keyNotificationsEnabled`	`"notifications_enabled"`	Master notifications toggle
`AppConstants.keyReminders`	`"reminders"`	`ReminderSettings` JSON
`AppConstants.keyAccessibility`	`"accessibility"`	`AccessibilitySettings` JSON
`AppConstants.keyProfileName`	`"profile_name"`	Teacher display name
`AppConstants.keyProfileAvatar`	`"profile_avatar"`	Avatar file path
`AppConstants.keyProfileCompleted`	`"profile_completed"`	Profile setup completion flag

App Information

At the bottom of the Settings screen a read-only info block displays the app logo, name, subtitle (AppConstants.appSubtitle), version (AppConstants.appVersion), and the ESPOCH institutional logo. This section has no interactive controls.

Route

Navigate to the Settings screen via the named route /settings. The screen can also be embedded within a parent Scaffold by constructing it with embedded: true, which renders the screen without its own navigation bar.

Get Started

Core Modules

Well-being & Media

Productivity & Settings

ErgoKawsay Settings: Language, Theme, Accessibility

Settings Categories

AccessibilitySettings Model

Active Break Notifications (Settings Screen Controls)

SharedPreferences Keys

App Information

Route

Build docs developers (and LLMs) love

Get Started

Core Modules

Well-being & Media

Productivity & Settings

Documentation Index

​Settings Categories

​AccessibilitySettings Model

​Active Break Notifications (Settings Screen Controls)

​SharedPreferences Keys

​App Information

​Route

Build docs developers (and LLMs) love

Settings Categories

AccessibilitySettings Model

Active Break Notifications (Settings Screen Controls)

SharedPreferences Keys

App Information

Route