# 🌿 Gentle Companion: A Compassionate Path to Mental Well-being

Introduction

In a world that often demands constant productivity and relentless positivity, it's easy to feel overwhelmed by the weight of depression. Many digital tools promise solutions, but few offer true understanding and gentle support. Enter Gentle Companion, a web app designed to be a safe, evidence-based, and deeply compassionate ally in your journey towards mental well-being. It aims to make therapeutic skills, self-tracking, and micro-actions accessible to everyone, every day, without judgment or pressure.

My Vision: No One Faces Depression Alone

Gentle Companion was born from a singular, powerful principle: any action is worthy of celebration. My vision is a world where every person has a gentle, effective, private companion that helps them reclaim hope, one tiny step at a time. The app never scolds, never punishes missed days, and never demands more than you can give. It's about meeting you where you are, with kindness and understanding.

Thoughtful Features for Gentle Progress

Gentle Companion offers a suite of carefully crafted features, all designed to support you without overwhelming you. Here are some of the key functionalities:
| Feature | Description |
| - -| - -|
| Mood & Energy Check-in | A daily slider for energy/weight (1–10) and a "mood weather" selector (stormy → sunny). Skippable with a "Just let me in" button, ensuring no pressure. |
| Daily Micro-Plan | Three randomly selected tiny tasks from a curated library. You can swap any task for a different one. Completion triggers a gentle celebration, focusing on progress, not perfection. |
| Thought Untangler | A 4-step guided Cognitive Behavioral Therapy (CBT) reframing tool. Sessions are persisted, allowing you to revisit past reflections. |
| Glimmer Catcher | A space to log anything even slightly okay - one sentence is enough. These small moments of positivity are displayed in reverse-chronological order. |
| Soothing Toolkit | Includes a box breathing pacer (4–4–4–4 animated circle), 5–4–3–2–1 senses grounding exercise, and a safe place visualization. |
| Crisis Button | An always-visible "I need help" button that provides immediate access to crisis lines (988, Samaritans, IASP), SMS options, and a pre-written message to a trusted contact. |
| Adaptive Quiet Mode | When your logged energy is ≤ 3, the home screen automatically switches to a minimal layout with only two gentle options, surfacing your "Letter to Myself" if one exists. |
| Letter to Myself | Write a compassionate note to yourself on a stable day, which is automatically surfaced on low-energy days for gentle encouragement. |
| Weekly Insights | Passive mood bar charts, glimmer correlation insights (e.g., "on days you caught a glimmer, your energy was higher"), and a virtual garden that grows with your engagement. |
| Virtual Garden | One element grows per week of engagement, never lost on missed days. A wildflower for the messy weeks, symbolizing growth even through challenges. |

Privacy-First Design: Your Data, Your Control

In an age where data privacy is paramount, Gentle Companion stands out with its unwavering commitment to user privacy. This app is designed with privacy as a first-class feature, not an afterthought. Here's how:

• No server, no network requests: All your data is stored exclusively in your browser's local storage. Nothing is transmitted anywhere, ensuring complete confidentiality.
• Consent before storage: No data is read from or written to local storage until you explicitly give consent on the privacy screen.
• Right to erasure: A two-step "Delete everything" option in the settings allows you to remove all your data and withdraw consent with a single tap.
• No third-party data sharing: There are no analytics, error tracking, advertising SDKs, or external CDNs (like Google Fonts) that could potentially leak your IP address or data.
• Content Security Policy: A robust Content-Security-Policy meta tag restricts all sources to 'self', enhancing security. ## Grounded in Evidence: Our Therapeutic Framework Every feature and interaction within Gentle Companion is grounded in evidence-based therapeutic approaches, ensuring that the support you receive is both gentle and effective: | Framework | Where Used in Gentle Companion | | - -| - -| | Behavioural Activation (BA) | Daily Micro-Plan: Encourages scheduling small, rewarding activities. | | Cognitive Behavioural Therapy (CBT) | Thought Untangler: Guides you in identifying and gently challenging unhelpful thought patterns. | | Self-Compassion (Kristin Neff) | Letter to Myself, all app copy tone, and celebration language: Fosters self-kindness and understanding. | | Acceptance & Commitment Therapy (ACT) | Glimmer Catcher: Promotes noticing experiences without judgment; also integrated into Thought Untangler. | | Polyvagal-inspired grounding | Box Breathing, 5–4–3–2–1 Senses, Safe Place Visualisation: Techniques to regulate the nervous system. | | Self-Determination Theory | No streaks, no leagues: Emphasizes autonomy (choosing tasks), competence (celebrating completion), and relatedness (virtual garden). | Important Note: Gentle Companion is a supportive companion, not a medical device or a substitute for professional mental health care. The crisis button is always visible and connects users to real human support when needed. ## Tech Stack Highlights For those interested in the technical underpinnings, Gentle Companion is built with a modern, dependency-light stack:
• UI Framework: React 18.2
• Language: TypeScript 5.3
• Routing: React Router DOM 6.20
• Styling: Pure CSS Custom Properties (no CSS-in-JS library)
• State Management: React Context + useState (no external state library)
• Persistence: Browser localStorage Notably, the project boasts zero runtime dependencies beyond React, React Router, and Lucide, emphasizing performance and maintainability. ## Trying out GitHub - OnkarBhattacharya/gentle-companion Contribute to OnkarBhattacharya/gentle-companion development by creating an account on GitHub.github.com Gentle Companion A compassionate path to mental wellbeing. gentlecompanion.netlify.app

Join the Journey

Gentle Companion is more than just an app; it's a philosophy of kindness and support. We invite you to explore this compassionate tool and join us in building a world where mental well-being is accessible to all, one gentle step at a time.
 - -
Author: Onkar Bhattacharya
License: MIT © Gentle Companion Contributors
"You don't have to fix anything right now. Just being here is enough."