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.

The best ergonomic intervention is a consistent daily habit. ErgoKawsay’s Tips module (Kunaykuna / Bienestar) delivers six preventive ergonomic tips sourced directly from occupational health guidelines — not as a static list to be read once, but as a rotating daily tip that keeps the guidance fresh and relevant. Each time a teacher opens the app, a different tip is highlighted based on the current day of the year, ensuring that all six recommendations receive equal visibility over the course of a week.

Tip of the Day

The featured tip is selected deterministically by LocalDataRepository.instance.tipOfDay():
Tip tipOfDay([DateTime? date]) {
  final now = date ?? DateTime.now();
  final dayOfYear = now.difference(DateTime(now.year, 1, 1)).inDays;
  return tips[dayOfYear % tips.length];
}
The selected tip is displayed as a large featured card at the top of the screen, showing the tip icon, a “CONSEJO DESTACADO” (or “SUMAK KUNAY” in Kichwa) eyebrow label, the full title, and the first line of content. Tapping the card opens a bottom sheet with the complete detail. The five remaining tips are shown below in a 2-column grid, each tappable to reveal full content.
The rotation is day-of-year based — the same tip appears all day, then advances at midnight. This is entirely deterministic: no network call or server state is involved.

All Six Tips

Icon: Icons.chair_alt_outlinedProper workstation setup is the foundation of ergonomic health for teachers who spend significant time grading, planning, and using a computer.
  • Screen height: Position the top of the monitor at eye level to prevent neck flexion.
  • Back support: The chair back should support the lumbar curve; feet flat on the floor, knees at 90°.
  • Elbow angle: Forearms resting on the desk with elbows at approximately 90° and shoulders relaxed.
  • Lighting: Light source should come from the side to eliminate screen glare.
Tip ID: chair_desk · Icon name: chair
Icon: Icons.draw_outlinedWriting on a blackboard or whiteboard is one of the most common causes of shoulder and neck fatigue in teachers. Repeatedly elevating both arms above shoulder height loads the rotator cuff and trapezius muscles.
  • Avoid sustained arm elevation: Do not keep both arms raised for extended writing sessions.
  • Alternate arms: When writing long passages, switch the writing arm periodically to distribute load.
  • Write at chest-to-shoulder height when possible; reserve overhead writing for brief headings only.
  • Take micro-breaks: Lower arms fully between sections.
Tip ID: blackboard · Icon name: blackboard
Icon: Icons.laptop_outlinedLaptop computers, by design, force a compromise: either the screen is too low (causing neck flexion) or the keyboard is too high (causing shoulder elevation). Teachers who use laptops for planning and grading need a simple workaround.
  • Elevate the screen: Use a laptop stand or a stack of books to raise the screen to eye level.
  • External keyboard: Use a separate keyboard so hands can rest at elbow height while the screen is elevated.
  • External mouse: Reduces wrist deviation and forearm strain compared to a trackpad.
  • Result: Neutral neck posture + relaxed shoulders + correct elbow angle — all simultaneously.
Tip ID: laptop · Icon name: laptop
Icon: Icons.checklist_roundedThe body fatigues fastest when the same muscles perform the same movement repeatedly without recovery. Task variety is one of the most effective ergonomic interventions because it distributes load across different muscle groups without requiring the teacher to stop working.
  • Alternate activity types: Cycle between writing on the board (standing, arms active), computer use (seated, fine motor), reading/reviewing work (seated, minimal movement), and standing classroom instruction (dynamic, varied).
  • Set a rough rotation: Aim not to spend more than 30–45 minutes in any single posture or activity type before switching.
  • Include standing activities: Even brief periods of standing instruction provide meaningful lumbar relief after seated grading.
Tip ID: vary_tasks · Icon name: tasks
Icon: Icons.accessibility_new_outlinedThis is the single most important ergonomic principle for teachers — and the most counterintuitive. Many people believe there is a “correct” posture to hold. In reality, no posture is correct if it is held for too long. The body needs movement, not perfection.
  • After 30 minutes standing: Sit down for at least 5 minutes.
  • After 45 minutes sitting: Stand up, walk briefly, and change position.
  • The key insight: “There is no perfect posture, only variation.” Alternating between postures prevents the cumulative loading that causes musculoskeletal disorders.
Set a phone timer or use ErgoKawsay’s Reminders module to prompt posture changes at regular intervals throughout the school day.
Tip ID: posture · Icon name: posture
Icon: Icons.hiking_outlinedTeachers spend more time on their feet than almost any other office-based professional. The shoes they wear directly affect their feet, knees, hips, and lower back — yet footwear is rarely discussed in ergonomic training.
  • Choose supportive shoes: Look for good arch support, cushioned soles, and a secure fit.
  • Avoid high heels: Heels shift body weight forward, increasing lumbar lordosis and loading the forefoot.
  • Avoid completely flat, hard soles: Flat shoes with no cushioning transmit impact shock directly to joints.
  • Ideal: A low, wide heel (1–3 cm) with cushioning and lateral stability.
  • Consider insoles: If standing for long periods, quality insoles provide extra cushioning and arch support.
Tip ID: footwear · Icon name: shoes

Icon Mapping

The TipsScreen maps each iconName string to a Material icon:
iconNameIconData
chairIcons.chair_alt_outlined
blackboardIcons.draw_outlined
laptopIcons.laptop_outlined
tasksIcons.checklist_rounded
postureIcons.accessibility_new_outlined
shoesIcons.hiking_outlined
(fallback)Icons.lightbulb_outline_rounded

Tip Model

Tips are immutable value objects defined in lib/data/models/tip.dart and instantiated in LocalDataRepository.
class Tip {
  const Tip({
    required this.id,         // Unique identifier string (e.g., 'chair_desk')
    required this.titleEs,    // Short title in Spanish
    required this.titleQu,    // Short title in Kichwa
    required this.contentEs,  // Full content in Spanish (newline-separated points)
    required this.contentQu,  // Full content in Kichwa
    required this.iconName,   // Icon key string (see mapping above)
  });

  final String id;
  final String titleEs;
  final String titleQu;
  final String contentEs;
  final String contentQu;
  final String iconName;

  // Language-aware accessors
  String title(bool isKichwa) => isKichwa ? titleQu : titleEs;
  String content(bool isKichwa) => isKichwa ? contentQu : contentEs;
}
Content strings may contain newline characters (\n). The UI uses a SmartBulletList widget to parse these into formatted bullet points inside the detail bottom sheet.

Technical Reference

PropertyValue
Route/tips
Category eyebrowBienestar / Kunaykuna
State managementStatelessWidget
Data sourceLocalDataRepository.instance.tips
Daily selectionLocalDataRepository.instance.tipOfDay()
Detail UIModal bottom sheet (showModalBottomSheet)
Total tips6

Build docs developers (and LLMs) love