User Guide
App Features

App Features

BetterStep offers a comprehensive set of features to support your recovery journey.

Health Dashboard

View core metrics on your home screen based on psychometric and behavioral data:

MetricData SourceScale
RecoveryRisk score from check-insCritical → Stable
SleepSelf-reported duration and qualityPoor → Excellent
Mental HealthDASS-21 assessment resultsSevere → Normal
StressDaily check-in stress ratingsCritical → Low
ActivitySelf-reported movementSedentary → Active

Each metric displays a 0-100 score with trend indicators showing improvement or decline.

Coming Soon - Future versions will incorporate biomarker data from connected devices for objective health tracking.

AI Companion

Access your AI coach anytime via the chat button:

Capabilities

  • Real-time streaming - Responses appear as they're generated
  • Context-aware - Knows your health data and conversation history
  • Personalized - Adapts to your communication style preference

What the AI Coach Can Help With

AreaDescription
Craving ManagementStrategies and techniques to handle urges
Stress ReductionBreathing exercises and coping techniques
Recovery PlanningGoal setting and milestone planning
Emotional SupportEmpathetic listening and encouragement

Crisis Mode

Immediate support when you're struggling. Tap the SOS button to activate Crisis Mode.

Quick Assessment

A brief questionnaire helps determine the best intervention:

QuestionPurpose
What are you experiencing?Identify crisis type (craving, anxiety, panic, thoughts)
How intense is it? (1-10)Gauge severity level
Are you in a safe environment?Assess immediate safety
How long have you been feeling this way?Determine urgency

Intervention Options

Based on your responses, Crisis Mode offers three pathways:

OptionWhen RecommendedWhat It Does
AI CompanionModerate distress, need to talkImmediate conversation with your AI coach in crisis-support mode
Distraction ToolsCravings, urges, racing thoughts20-minute mini-games (Tetris, 2048) to redirect focus
Emergency ContactSevere distress, safety concernsDirect connection to clinic, rehab, or local crisis line

The Science Behind Distraction Tools

Why 20 Minutes? Research shows that most cravings and urges peak and subside within 15-20 minutes. The built-in games are designed to occupy your mind through this critical window, giving the urge time to naturally decrease.

Distraction Mini-Games

GameHow It Helps
TetrisRequires spatial reasoning and quick decisions—proven to reduce intrusive thoughts and cravings
2048Engages problem-solving focus, redirecting mental energy away from urges

Emergency Contacts

Pre-configured contacts for immediate help:

Contact TypeDescription
Connected ClinicDirect line to your treatment provider
Personal Emergency ContactFamily member or sponsor you've designated
Crisis HotlineLocal or national addiction/mental health crisis line

All crisis interactions are logged (with your consent) to help your care team understand and support your recovery.

Clean Days Tracker

Monitor your sobriety journey:

  • Total clean days displayed prominently on homescreen
  • Calendar view of your recovery timeline
  • Automatic tracking from your registered quit date

Health Recovery Timeline

As you stay clean, your body and mind heal. BetterStep shows scientifically proven health benefits at each stage:

Time CleanHealth Benefits
24 hoursBlood pressure begins normalizing, anxiety from withdrawal peaks then starts declining
48-72 hoursNerve endings start regenerating, sense of taste and smell improve
1 weekSleep quality improves, energy levels increase, lung function begins recovery
2 weeksCirculation improves, physical withdrawal symptoms largely subside
1 monthLung capacity increases, cognitive clarity improves, skin appearance recovers
3 monthsBrain dopamine receptors begin healing, emotional regulation improves significantly
6 monthsRisk of relapse decreases substantially, stress response normalizes
1 yearBrain chemistry largely restored, heart disease risk significantly reduced

Personalized Insights - The app displays relevant health benefits based on your specific addiction type and time clean, giving you tangible reasons to celebrate your progress.

Milestone System

Achieve milestones at key recovery points:

DaysMilestoneThemeReward
1First StepAncient Moon+100 XP
7One WeekRising Sun+100 XP
14Two WeeksGrowing Tree+100 XP
30One MonthMountain Peak+100 XP
60Two MonthsFlowing River+100 XP
90Three MonthsGolden Phoenix+100 XP
180Six MonthsDiamond Heart+100 XP
365One YearEternal Dragon+100 XP

Quest Library

Quests are evidence-based therapeutic interventions assigned based on your risk level and recovery stage. Unlike Daily Tasks which you can customize, Quests are designed by clinical professionals.

Quest Categories

CategoryDescriptionExamples
PsychoeducationalEducational readingsUnderstanding triggers, addiction science
MindfulnessMeditation and breathingGuided meditations, breathing exercises
PhysicalMovement activitiesWalking, stretching, exercise prompts
CBTCognitive behavioralThought reframing, journaling
MotivationalEncouragement focusedAffirmations, goal review

Interactive Elements

  • Multiple choice reflections - Process what you've learned
  • Timed exercises - Guided activities with countdowns
  • Before/after mood tracking - Measure quest effectiveness
  • Helpfulness ratings - Improve future recommendations

Quest Replacement

If a quest feels overwhelming or isn't suitable for your current situation, you can request an alternative:

ReasonSystem Response
Physical limitationOffers seated or low-impact alternative
Environmental constraintSuggests indoor or equipment-free option
Feeling overwhelmedProvides shorter or easier variation
Already completed similarAssigns different quest type

How it works:

  1. Tap "Can't do this" on any quest
  2. Select your reason from the list
  3. System suggests a relevant alternative
  4. Accept the new quest or request another option

No Penalty - Replacing a quest doesn't affect your progress or XP. The goal is to find what works for you.

Upcoming Features

For upcoming features like Daily Tasks Scheduler, BetterStep Health Device, and third-party integrations, check the Roadmap Overview.