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.

Teaching is one of the most emotionally demanding professions. Every day, teachers navigate complex relationships with students, parents, and institutions — often suppressing how they truly feel in order to stay focused on their classroom. ErgoKawsay’s Emotions module (Salud Mental / Ñuktu Alli Kay) treats emotional well-being as foundational to physical health: recognizing what you feel is the very first step to managing stress, avoiding burnout, and building sustainable resilience in the classroom. The module gives each emotion a name and a face. Rather than presenting abstract psychological categories, ErgoKawsay introduces five characters — one for each core emotion — so teachers can identify, select, and log what they are experiencing on any given day. Tapping a character opens a detail screen with causes, coping strategies, and an affirmation phrase. Emotions can be saved to the teacher’s personal progress log.

​
The Five Characters

RumiRumi — Anger (Enojo)

RumiRumi represents the intense, burning emotion that arises from perceived injustice, frustration, or pressure overload. Like a rock under heat, the feeling builds until it needs somewhere to go.

Yaku — Sadness (Tristeza)

Yaku (water in Kichwa) embodies the slow, heavy feeling of sadness — demotivation, feeling undervalued, and emotional exhaustion that accumulates when the work feels thankless.

Inti — Joy (Alegría)

Inti (sun in Kichwa) shines through moments of deep satisfaction: a student who finally understands, a connection with a colleague, the sense of purpose that called the teacher to their vocation.

Tutam — Fear (Miedo)

Tutam (darkness/night in Kichwa) represents the quiet fears that many teachers carry alone — uncertainty about the future, fear of failure, or anxiety about new technology requirements.

Chaskym — Anxiety (Ansiedad)

Chaskym captures the restless, scattered feeling when worries and demands pile up faster than they can be processed — the sense that everything is urgent and nothing is under control.

​
Per-Emotion Detail

Each emotion card opens a full detail screen showing: a hero illustration, a “What it is” description, causes or signals (displayed as a colored dot list), coping strategies (displayed as numbered steps), and a motivational affirmation. Teachers can tap Save / Guardar to record the emotion in their progress history.
What it isAnger is an intense emotional response that emerges when a teacher feels that something unjust, unfair, or overwhelming is happening. It is not a sign of weakness — it is a signal that something important to the teacher has been violated or exceeded.Common Causes
  • Student disrespect or repeated disruptive behavior
  • Work overload: grading, planning, administrative demands piling up simultaneously
  • Feeling unheard by colleagues, management, or parents
Coping Strategies
1

4-7-8 Breathing

Inhale for 4 counts, hold for 7, exhale slowly for 8. This activates the parasympathetic nervous system and lowers physical arousal within seconds.
2

Leave the Room Briefly

If the situation allows, step out for 2–3 minutes. Physical distance from the trigger helps break the escalation cycle.
3

Write Your Feelings

Write — without censoring — exactly what you are feeling and why. Externalizing the emotion reduces its intensity.
4

Wait Before Responding

When anger peaks, postpone any reply or decision. The goal is to respond thoughtfully, not react impulsively.
Affirmation
“Recognizing my anger is wisdom. I can respond, not react.”
What it isSadness in teachers often arrives quietly, not as a dramatic breakdown but as a growing heaviness — a loss of energy, motivation, or connection to the work they once loved. It is a natural response to difficulty and deserves to be acknowledged rather than pushed away.Signals to Recognize
  • Feeling that your efforts produce no results, that students are not progressing
  • Burnout: physical and emotional exhaustion after sustained giving without recovery
  • Feeling misunderstood or invisible to the institution, colleagues, or parents
Coping Strategies
1

Talk to Someone Trusted

Share how you are feeling with a colleague, friend, or family member. Being heard — without judgment — is itself therapeutic.
2

Find One Small Daily Achievement

Sadness contracts attention toward what is not working. Deliberately identify one thing that went well today, however small.
3

Walk Outdoors

Even a 10-minute walk in natural light shifts neurochemistry, reduces rumination, and provides gentle physical activation.
Affirmation
“My sadness deserves to be understood.”
What it isJoy is the warm, expansive emotion that reminds teachers why they chose this path. It is not reserved for grand milestones — it lives in small, everyday moments of genuine human connection and growth.Sources of Joy in Teaching
  • Seeing a student grasp a concept they previously struggled with
  • A spontaneous, positive moment in the classroom — laughter, curiosity, energy
  • Sincere recognition from a student, parent, or peer
Joy is the only emotion in ErgoKawsay that has no coping-strategy steps (actionsEs and actionsQu are both empty strings in the data source). The detail screen omits the actions section entirely for this emotion — only the sources list and the affirmation phrase are shown.
Affirmation
“Every small achievement deserves to be celebrated.”
What it isFear is a protective emotion that alerts teachers to perceived threats. In the professional context, it often manifests not as acute danger but as a persistent, low-level worry about competence, stability, and the future.Common Fears in Teaching
  • Not being enough — for students, for the institution, for one’s own standards
  • Fear of criticism from parents, supervisors, or peers
  • Job loss, contract uncertainty, or institutional restructuring
  • New technology requirements that feel overwhelming or threatening
Coping Strategies
1

Analyze Whether the Fear Is Real

Ask: Is this threat actually happening right now, or is it a projected scenario? Many professional fears are anticipatory rather than immediate.
2

Take Small Steps

Break the feared situation into the smallest possible action. Fear shrinks when confronted incrementally rather than all at once.
3

Remember Past Successes

Recall specific moments when you faced something difficult and moved through it. Evidence of past resilience builds confidence in present capacity.
Affirmation
“Fear doesn’t stop me. I am capable and brave.”
What it isAnxiety is what happens when worry becomes anticipatory and pervasive — the mental load of teaching (lesson plans, student needs, evaluations, administrative duties) feels like it exceeds the teacher’s available resources. Unlike fear, which has a clear object, anxiety is often diffuse and hard to pin down.
Anxiety has no causes or signals list in the data source (causesEs and causesQu are empty strings). The detail screen skips the causes section entirely for this emotion and proceeds directly to coping strategies.
Coping Strategies
1

Deep Breathing

Slow, diaphragmatic breathing is the fastest evidence-based way to lower anxiety. Inhale for 4 counts, exhale for 6. Repeat 5–6 times.
2

Prioritize Urgent Tasks

Write down everything on your mind, then mark only what is genuinely urgent today. Anxiety thrives on the feeling that everything must be done at once.
3

5-4-3-2-1 Grounding Technique

This sensory grounding exercise interrupts anxious thought spirals by anchoring attention in the present moment:
  • 5 things you can see right now
  • 4 things you can touch (feel their texture)
  • 3 things you can hear
  • 2 things you can smell
  • 1 thing you can taste
Affirmation
“Take it easy. You can do it.”

​
Mood Check

The emotions list screen functions as a mood check for teachers. At the top of the screen, a header invites: “Tap the emotion you feel right now” (or its Kichwa equivalent). Each emotion card is tappable and leads to the detail screen, where the teacher can read the content and — once ready — tap Save to log the emotion to their personal history. Saved emotions are stored locally on the device and are reflected in the Progress module, allowing teachers to observe their emotional patterns over time without any data ever leaving the device.

​
Image Assets

Each emotion character has a custom full-color illustration rendered at 90 × 110 dp on the list card and 96 × 116 dp on the detail screen hero. Assets are declared in pubspec.yaml and loaded with Image.asset().
EmotionCharacterAsset path
AngerRumiRumiassets/emotions/enojo_Rumirumi.png
SadnessYakuassets/emotions/tristeza_YAKU.png
JoyIntiassets/emotions/alegría_Inti.png
FearTutamassets/emotions/miedo_Tutam.png
AnxietyChaskymassets/emotions/ansiedad_Chaskym.png
If an image asset is unavailable at runtime, the UI falls back to a neutral Icons.sentiment_neutral_rounded icon at 56 dp in the emotion’s accent color.

​
Accent Colors

Each emotion has a dedicated colorHex integer used for the detail-screen hero tint and dot/step accent. Values match the Emotion model in local_data_repository.dart exactly.
EmotionCharactercolorHexRendered color
AngerRumiRumi0xFFE57373Soft red
SadnessYaku0xFF64B5F6Light blue
JoyInti0xFFFFB74DWarm amber
FearTutam0xFF9575CDMedium purple
AnxietyChaskym0xFF4DB6ACTeal

​
Technical Reference

PropertyValue
Route/emotions
Category eyebrowSalud Mental / Ñuktu Alli Kay
State managementStatelessWidget (list) + StatefulWidget (detail)
PersistenceStorageServiceScope.of(context).recordEmotion(id)
Data sourceLocalDataRepository.instance.emotions
ModelEmotion (see below)
Emotion model fields: 
class Emotion {
  final String id;
  final String nameEs;        // Spanish name
  final String nameQu;        // Kichwa name
  final String whatIsEs;      // "What it is" description (ES)
  final String whatIsQu;      // "What it is" description (Kichwa)
  final String? causesTitleEs; // Section header for causes (optional)
  final String? causesTitleQu;
  final String causesEs;      // Newline-separated causes/signals (ES)
  final String causesQu;
  final String? actionsTitleEs; // Section header for strategies (optional)
  final String? actionsTitleQu;
  final String actionsEs;     // Newline-separated coping strategies (ES)
  final String actionsQu;
  final String phraseEs;      // Motivational affirmation (ES)
  final String phraseQu;      // Motivational affirmation (Kichwa)
  final int colorHex;         // Accent color as 0xFFRRGGBB integer
  final String iconName;      // Icon identifier string
  final String? imageAsset;   // Asset path for character illustration
}

Build docs developers (and LLMs) love

Get started for freeTalk to us