ClubhouseAmit / ClubhouseAmit/LivingPositively
[Enhancement LP 1.0] Implement "Remember to Breathe" (לזכור לנשום) Feature
- Dominant language
- Dart
- Stars
- 7
- Forks
- 0
- Avg merge
- 21h 37m
- Merged PRs (30d)
- 16
Description
אני לא בטוח שהצלחתי שיראו את הדברים כמו שרציתי פה בבקשה אז אני מוסיף את הקובץ
שם כתוב בעברית, באנגלית ובשפה שלי על בקשת אפיון הפיצ'ר - כולל תמונות לדוגמא
[תרגול נשימות מונחות.pdf](https://github.com/user-attachments/files/31940076/default.pdf)
[תרגול נשימות מונחות.docx](https://github.com/user-attachments/files/31940075/default.docx)
מקווה ש\ה מספיק ברור ויהיה לעזר
תודה
ליאור
### Enhancement LP 1.0: Implement "Remember to Breathe" (לזכור לנשום) Feature
**1. Overview**
* **Feature Name:** לזכור לנשום / Remember to Breathe
* **Goal:** Provide a fast, accessible physiological regulation tool to reduce stress and anxiety in real-time, while strengthening the user's sense of capability and self-control.
* **Core Structure:** The practice is based on exactly **8 full breathing cycles** (rather than a time limit in seconds/minutes). This creates an achievable goal, increases the feeling of success ("I finished the exercise end-to-end"), and makes it easy for the user to start another round if desired.
**2. Credibility & Provenance**
At the bottom of the onboarding screen and inside the info (`i`) modal, display the following professional credit/disclaimer:
* **Hebrew UI String:** "התרגול 'לזכור לנשום' פותח בהשראת אפליקציית Breathe2Relax מבית ה-T2 / משרד הביטחון האמריקאי (US Department of Defense). הפיצ'ר נשען על פרוטוקולים מחקריים לוויסות המערכת הפיזיולוגית, בשילוב תובנות וליווי של מומחים מניסיון אישי בשטח בתחום בריאות הנפש והשיקום, לחיזוק החוסן הנפשי באפליקציית Living Positively."
* **English Context:** *"The 'Remember to Breathe' practice was inspired by the Breathe2Relax app by T2 / US Department of Defense. The feature relies on research protocols for physiological regulation, combined with insights and guidance from lived-experience experts in mental health and rehabilitation, to strengthen mental resilience in the Living Positively app."*
**3. Onboarding & Practical Guidance**
* **Explanation:** A short, inviting text explaining the difference between shallow chest breathing and diaphragmatic nose breathing (inhaling through the nose and expanding the stomach).
* **Practical Recommendation UI String:** "בפעמים הראשונות, מומלץ מאוד לתרגל בשכיבה או בישיבה נינוחה. הניחו בעדינות יד אחת על הבטן ויד שנייה על החזה, והרגישו כיצד היד שעל הבטן עולה בשאיפה ושוקעת בנשיפה."
* **English Context:** *"For the first few times, it is highly recommended to practice lying down or sitting comfortably. Gently place one hand on your stomach and the other on your chest, and feel how the hand on your stomach rises on the inhale and sinks on the exhale."*
* **Info Icon (`i`):** Clicking this allows the user to choose between an extended textual explanation or a short instructional video.
**4. User Flow & Customization**
The user can click **"התחל תרגול מהיר"** (Quick Start - default) or **"התאמה אישית"** (Customization).
During Customization, show a progress bar (e.g., Step 2 of 4) with a **"דלג"** (Skip) button on each step:
1. **Visual Background:** Choose from CC0 royalty-free images (Forest/Rain, Mountains, Cosmos, Beach, Flowers, Sunset, Minimalist House, Monastery) or upload a personal photo from the device.
2. **Audio/Voice:** Choose looping CC0 audio (Water stream, Ocean waves, Calming wind, Relaxing music) or custom device music.
3. **Inhale (שאיפה) Duration:** Default is 3 seconds. Allow "Press & Hold" measurement: user presses the screen while inhaling and releases when done (range: 3-9 seconds max). The measured time is saved.
4. **Exhale (נשיפה) Duration:** Same mechanism as Inhale (3-9 seconds max).
**5. Breathing Types (All set to 8 Cycles)**
Upon starting, the user selects their preferred breathing pattern:
| Type (Hebrew) | Technical Spec | User Experience |
| --- | --- | --- |
| **תרגול בסיסי** (Basic) | 8 cycles: 3s Inhale $\rightarrow$ 3s Exhale | Quick, simple, and accessible for any situation. |
| **נשימה מרובעת** (Box Breathing) | 8 cycles: 4s Inhale $\rightarrow$ 4s Hold $\rightarrow$ 4s Exhale $\rightarrow$ 4s Hold | Designed to calm heart rate and deeply regulate the nervous system. |
| **תרגול מותאם אישית** (Custom) | 8 cycles based on Customization times. Allow adjustment via `+` and `-` mid-practice. | Full user control over their breathing pace. |
**6. Stress Tracker & Strength-Based Messaging**
**A. Pre-Session:**
* **Action:** Quick slider/selector for current stress level (1-10 or emojis).
* **Hebrew UI String:** "בואו נבדוק מה שלומכם ברגע זה. התרגול הוא הזמנה להירגע ולהאט את הקצב."
* **English Context:** *"Let's check how you're doing right now. This practice is an invitation to relax and slow down."*
**B. Post-Session (Completed all 8 cycles):**
* **Action:** Prompt to log current stress level again.
* **Hebrew UI String:** "כל הכבוד. הענקתם לגוף ולנפש רגע של שקט, הרגעה והאטת הקצב. כל תרגול כזה מחזק אתכם."
* **English Context:** *"Well done. You gave your body and mind a moment of peace, relaxation, and slowing down. Every practice like this strengthens you."*
**C. Post-Session (Early Stop / Quit before 8 cycles):**
* **Action:** Optional prompt to log stress level.
* **Hebrew UI String:** "כל נשימה מודעת שלקחתם היא רווח נקי עבורכם. מצוין שהקשבתם לגוף ועצרתם כשזה הרגיש נכון. אפשר לחזור ולתרגל שוב בכל זמן שתרצו."
* **English Context:** *"Every conscious breath you took is pure profit for you. It's excellent that you listened to your body and stopped when it felt right. You can come back and practice again anytime you want."*
**7. Real-Time Breathing Interface**
* **Progress Indicator:** Clear display of cycle count (e.g., מעגל 3 מתוך 8 / Cycle 3 of 8).
* **Visual Representation:** A balloon/circle shape that expands on Inhale, stays fixed on Hold, and shrinks on Exhale.
* **Floating Controls (Toggleable):**
* **Eye Icon:** Show/Hide the visual animation (balloon).
* **Text Icon:** Show/Hide subtitles ("להכניס אוויר" / Inhale, "להשהות" / Hold, "להוציא אוויר" / Exhale).
* **Voice Icon:** Mute/Unmute the human guiding voice.
* **Sound Icon:** Mute/Unmute background audio (ocean, wind, etc.).
* **Pause Button:** Pauses practice and opens a menu: Continue (המשך), Restart (התחל מחדש), or End Practice (סיום תרגול).
**8. Tracking & Results**
* **Personal Area (יומן תרגולים):** A practice log showing when the user practiced, how many cycles were completed, and a visual comparison of their stress levels (Before vs. After) to prove the tool's effectiveness over time.
**Acceptance Criteria:**
* [ ] Onboarding screens include diaphragmatic breathing explanations and DoD/T2 credit.
* [ ] Customization flow allows visual/audio selection and press-and-hold duration setting.
* [ ] Real-time interface correctly scales the visual expanding/contracting circle based on the selected breathing type timings.
* [ ] Floating controls correctly toggle their respective UI/Audio elements.
* [ ] Pre and Post-session stress trackers accurately save data to the user's history/log.
* [ ] All Hebrew text strings are implemented exactly as specified above.
Contributor guide
Assessment
This issue has not been assessed yet.