04 · WELLNESS APP (iOS / Android)

Wellex mobile application: pure wellness, WHOOP-model community, Monthly Yield display. No staking, no MLM, no financial operations.

⚠️ Wellex App is not a crypto wallet. It is a wellness application. All financial operations are performed exclusively in the WEB version. ⚠️ Target Yield is not a guarantee. APP displays yield % only — no dollar amounts. Actual yield depends on DeFi market conditions.

1. UX Philosophy

Key Principle: APP = Wellness + Community

The app does not (and will not) contain:

Staking or any staking interface
Deposits, withdrawals, financial transactions
MLM structure or partner tree
Dollar amount displays
Wallets and balances
Any financial operations

Important: Wellex App is not a crypto wallet. Users who only use the band without staking see WVI statistics and yield potential. To activate staking and start earning — switch to the WEB version.

The app includes:

WVI (Wellex Vitality Index) — unified health scale 0–100
Biometrics: emotions, sleep, activity
AI coach (video / audio / text)
WHOOP-model Community: owner discovery, groups, challenges, leaderboards
Monthly Yield display (% only, no amounts)
Button to switch to WEB version

Monthly Yield — Display Rules

User Status	Display in APP	Action on Tap
With active staking	Current Monthly Yield in percentage (e.g., "15.8%"). Green accent, large font. No amount in $.	Information block
Without staking	Dash "—". Small text "Learn more →"	Popup: "Learn more about yield" → deep link to WEB version

Lazy Factor

Opened the app → saw the score → received a recommendation → closed. Average session time: 30 seconds.

Design Principles

Principle	Implementation
Glanceable	WVI + Monthly Yield visible without scrolling
Zero-config	Band connects automatically
Proactive	AI push notifications at the right moment
Community-first	Community is a full section, not an add-on (WHOOP model)
Inclusive	WCAG 2.1 AA; VoiceOver / TalkBack
Offline-first	Full functionality without internet; sync on reconnection
No Finance	No financial elements. Pure wellness.

5 main screens:

Home · Metrics · Community · Assistant · Settings

3. Screen 1: Home

Wireframe

┌─────────────────────────────────┐
│ Status Bar                      │
│ Good morning                    │
│ Streak: 14 days                 │
│                                 │
│  ┌──────────┐                   │
│  │    72     │ ← WVI            │
│  │   /100    │   circular       │
│  │   ↑ +5   │   gauge          │
│  └──────────┘                   │
│                                 │
│ Monthly Yield: 15.8%            │
│ ─────── or ───────              │
│ Monthly Yield: — [Learn more]   │
│                                 │
│ Emotions: 62  Sleep: 78  Phys: 75│
│                                 │
│ AI recommendation               │
│ "A 20-min evening walk          │
│  will raise WVI to 78"          │
│ [Watch 1:30]                    │
│                                 │
│ WVI mini-chart (7 days)         │
│                                 │
│ Home · Metrics ·                │
│ Community · Assistant ·         │
│ Settings                        │
└─────────────────────────────────┘

Screen Elements

Block	Description	Update
WVI gauge	Circular gauge 0–100, color: red → yellow → green	Every 15 min
WVI trend	Arrow up/down + weekly delta	Daily
Monthly Yield Display	% for stakers, "—" + "Learn more" for others	Real-time
AI recommendation	Tip card (video / audio / text)	Every 4 hours
Quick metrics	3 WVI components in mini-cards	Every 15 min
Streak	Consecutive days wearing the band	Daily
Mini-chart	WVI sparkline for 7 days	Daily

4. Screen 2: Metrics

Wireframe

┌─────────────────────────────────┐
│       Metrics     [7d][30d][90d]│
│                                 │
│ Emotional — 62/100              │
│ ████████████░░░░░░░░            │
│ Line chart (7 days)             │
│ HRV: 48 ms · Stress: 42        │
│ Current emotion: Calm           │
│ Tip: Breathe 5 min → +8        │
│                                 │
│ Recovery — 78/100               │
│ ██████████████████░░            │
│ Sleep: 7h 20m · Deep: 22%      │
│ Recovery: 74 · REM: 24%        │
│ Tip: Go to bed by 11 PM        │
│                                 │
│ Physical — 75/100               │
│ █████████████████░░░            │
│ Steps: 9,240 · Cal: 420        │
│ MVPA: 35 min · Int: 68%        │
│ Tip: +2,000 steps today        │
│                                 │
│ Tab Bar                         │
└─────────────────────────────────┘

Charts and Trends

Period	Chart Type	Data
7 days	Line chart	Daily sub-scores
30 days	Line chart + trend line	Average + forecast
90 days	Bar chart (grouped)	Weekly averages

Drill-down on Component Tap

Each component expands into a full-screen view with:

Detailed metrics
Daily histograms
AI insights
Personalized recommendations

5. Screen 3: Community — WHOOP Model

A full-featured community section, inspired by WHOOP Teams + Strava Clubs + Oura Community. The central element is band owner discovery and uniting around wellness goals, including emotional well-being.

Wireframe

┌─────────────────────────────────┐
│       Community                 │
│                                 │
│ [Search groups and people]      │
│                                 │
│ Nearby Wellex owners            │
│ ┌─────────────────────────┐     │
│ │ @sofia · WVI 85 · 1.2 km│    │
│ │ @ethan_fit · WVI 78 · 3 km│  │
│ │ [Find more →]            │    │
│ └─────────────────────────┘     │
│                                 │
│ My Groups                       │
│ ┌─────────────────────────┐     │
│ │ Morning Yoga (23)        │    │
│ │ Avg WVI: 71 · You: 72   │    │
│ └─────────────────────────┘     │
│ ┌─────────────────────────┐     │
│ │ London Runners (156)     │    │
│ │ Avg WVI: 68 · You: 72   │    │
│ └─────────────────────────┘     │
│ [+ Create Group]                │
│                                 │
│ Active Challenges               │
│ ┌─────────────────────────┐     │
│ │ Team WVI ≥ 70            │    │
│ │ 5 days · 68/70           │    │
│ │ ████████████████░░       │    │
│ └─────────────────────────┘     │
│                                 │
│ Leaderboards                    │
│ 1. @health_pro   WVI: 94       │
│ 2. @yoga_daily   WVI: 91       │
│ 3. @run_master   WVI: 89       │
│ ...47. @you      WVI: 72       │
│ [All leaderboards →]            │
│                                 │
│ Social Feed                     │
│ @sofia reached WVI 85!          │
│ @ethan_fit: 100-day streak      │
│ Team "London Runners" — top 3   │
│                                 │
│ Tab Bar                         │
└─────────────────────────────────┘

Community Features (WHOOP Model)

Block	Description
Discovery: Nearby People	Find Wellex band owners by geolocation and interests. Cards: avatar, WVI, distance, interests. Add as friend option. Filters: radius, WVI level, interests.
Wellness Groups	Interest-based groups: yoga, running, meditation, biohacking, breathwork, stress management, emotional wellness. Open and closed. Up to 500 members.
Team Challenges	Team competitions: "Team WVI ≥ 70 for a week", "100K steps per team in 3 days", "7 days of meditation". Rewards: badges, NFT achievements.
Leaderboards	Global, regional, friends, within group — ranked by WVI.
Social Feed	Achievements, records, participant milestones. Reactions: support, motivation.
Friend Challenges	1-on-1 WVI duels over 7 days.
Wellness Teams	Teams of 5–50 people with shared WVI and joint goals.

Community vs WHOOP / Oura / Strava

Feature	Wellex	WHOOP Teams	Oura	Strava
Owner discovery	Geolocation + interests	—	—	—
Interest-based groups	Wellness + emotional	Teams only	—	Clubs
Team challenges	By WVI	By Strain	—	By activity
Leaderboards	WVI (health + emotions)	Strain	Readiness	Activity
Social feed	Yes	—	—	Yes
1v1 Challenges	Yes	—	—	Partial
Emotional wellness focus	Central	—	—	—

Wellex Community's unique advantage: members are united not only by physical activity, but also by emotional well-being — meditation groups, stress management, emotional wellness. The first wellness community where mental health is a central element.

6. Screen 4: AI Assistant

Wireframe

┌─────────────────────────────────┐
│       AI Assistant              │
│                                 │
│ ┌─────────────────────────┐     │
│ │ Morning recommendation   │    │
│ │ HRV dropped 15%.         │    │
│ │ 4-7-8 breathing for 5 min│   │
│ │ [Video 1:30] [Audio]     │    │
│ │ [Text]                   │    │
│ └─────────────────────────┘     │
│                                 │
│ ┌─────────────────────────┐     │
│ │ Evening plan             │    │
│ │ 1. Walk 20 min           │    │
│ │ 2. No screens after 10 PM│   │
│ │ 3. Sleep by 11 PM        │    │
│ │ Forecast: WVI +5 tomorrow│   │
│ └─────────────────────────┘     │
│                                 │
│ ┌─────────────────────────┐     │
│ │ Weekly report            │    │
│ │ Sleep +12%, stress +8%   │    │
│ │ [Watch report 3:00]      │    │
│ └─────────────────────────┘     │
│                                 │
│ Ask AI...                       │
│                                 │
│ Tab Bar                         │
└─────────────────────────────────┘

Content Formats

Format	Description	Duration	When
Video	Short instructions (breathing, warm-up, stretching)	1–3 min	Morning, evening
Audio	Voice recommendations, meditations	1–5 min	Anytime
Text	Checklists, plans, tips	—	Always
Report	Weekly / monthly analytics	2–5 min	Weekly

Recommendation Types

Type	Example	Trigger
Preventive	"Stress rising — breathe for 5 min"	HRV drop > 15%
Corrective	"Low sleep last night — go to bed earlier"	Sleep < 6 h
Motivational	"Only +8 WVI to reach 18% Monthly Yield!"	WVI near threshold
Educational	"How Emotional Mining works"	First week
Congratulatory	"30-day streak!"	Milestone

7. Screen 5: Settings

Features

Block	Details
Band	BLE connect / disconnect, battery status, OTA update
Subscription	$19/mo subscription status, management
Profile	Account, notifications, language, theme (dark / light)
Privacy	Data management, export, account deletion (GDPR)
WEB Version	"Go to WELLEX WEB version" button → deep link to web application

Button to WEB

Prominent button in settings and on the home screen (on Monthly Yield "—" tap):

┌─────────────────────────────────┐
│ Go to WELLEX WEB Version        │
│ Staking · Yield · Partners      │
│ [Open →]                        │
└─────────────────────────────────┘

8. User Flows

8.1 Onboarding (New User)

Download app → Splash screen
Registration: Email / Apple ID / Google (1 tap)
Non-custodial wallet: upon email registration the system automatically generates a non-custodial wallet. Private keys belong to the user and can be exported to any compatible external application. The user retains full control of the wallet regardless of the platform.
- When registering via external Web3 wallet (WalletConnect / MetaMask) — the user's own wallet is used.
Screen: "Connect Wellex Band" → NFC tap or BLE scan → pairing (15 sec)
Quick tour (3 swipe screens): WVI · Community · AI Coach
Calibration begins (7 days, WVI = 50)
Push: "Wear the band 24/7 for accurate calibration"
Home screen

Non-custodial wallet: created automatically upon email registration. Hidden in APP — full functionality in WEB. Key export available via WEB → Settings → Security → Export Private Key.

8.2 Daily Cycle (Active User)

07:00 Push: "Good morning! Recovery 82. Great day for a workout"
 → Action: read (5 sec)
12:00 Push: "WVI today 74. A 20-min walk → +5"
 → Action: optional
19:00 Push: "Your WVI today: 76 (+3 from yesterday)"
 → Action: none
22:00 Push: "Sleep plan: go to bed by 11 PM, no screens"
 → Action: none or follow

Total: 0–2 actions per day, 30 seconds in the app.

8.3 Transition to WEB (Financial Operations)

Scenario A: Band-only user (no staking)

Users who only use the Wellex Band and have no funds in staking see:

WVI statistics and three components (emotions, recovery, physical activity)
Monthly Yield: "—" with hint "Learn about yield"
Yield potential at their current WVI: "Your WVI 72 → potential 12%/mo"

Motivation mechanism for transition:

On the home screen — Monthly Yield "—", small text "Learn more →"

Tap → Motivational popup:

┌─────────────────────────────────┐
│ 💰 Your WVI 72 = 12%/mo        │
│                                 │
│ At your health level you        │
│ can earn up to 12% per month    │
│ on your funds.                  │
│                                 │
│ [Activate yield →]              │
│ Open Wellex WEB version         │
└─────────────────────────────────┘

"Activate yield" button → deep link to WEB
In WEB: authorization (same account) → directly to Staking screen
Full financial functionality: deposit, staking, partner program

Scenario B: Active staker

User sees Monthly Yield "15.8%" on the home screen
Tap → information block with breakdown and link to WEB for management

8.4 Discovery: Find Nearby Band Owners

Community → "Nearby Wellex owners"
Map / list of owners with WVI, distance, interests
Tap on profile → shared groups, WVI chart, interests
[Add as friend] → invite to team or challenge

8.5 Joining a Community Group

Community → Search → "Yoga"
List of groups with description, member count, avg WVI
Tap on group → Preview → [Join]
Group added to "My Groups" → challenges and group feed available

8.6 Participating in a Team Challenge

Community → Active Challenges → "Team WVI ≥ 70"
View details: rules, deadlines, participants, progress
[Join] → select team or create your own
Daily progress + push notifications → final result

9. Dark / Light Theme

Element	Light	Dark
Background	#FFFFFF	#0D0D0D
Surface (cards)	#F5F5F5	#1A1A2E
Primary accent	#4CAF50 (green)	#66BB6A
Text primary	#1A1A1A	#F0F0F0
Text secondary	#666666	#AAAAAA
WVI ring	Gradient green → yellow → red	Same, +10% brightness

Auto mode: follows device system theme.

10. Accessibility (WCAG 2.1 AA)

Requirement	Implementation
VoiceOver / TalkBack	All elements with accessibility labels
Contrast	Minimum 4.5:1 for body text
Dynamic Type	System font scaling support
Motion sensitivity	"Reduce Motion" → disable animations
Touch targets	Minimum 44×44 pt
Screen reader order	WVI → Monthly Yield → recommendation → metrics

11. Offline Mode

Feature	Offline	Sync
Band data collection	Yes	On reconnection
WVI calculation (approximate)	On-device	Server-side recalculation
AI recommendations	Cached	Updated on reconnection
History and charts	Local DB	Delta sync
Community / Leaderboard	Requires internet	—

12. Push Notifications

Category	Frequency	Example	Dismissable
Health (AI)	2–4/day	"HRV dropped — breathe 5 min"	Yes
WVI progress	1/day	"WVI today: 76 (+3)"	Yes
Community	1–2/day	"Your team is in 2nd place!"	Yes
Motivation (streaks)	1/day	"14 days in a row!"	Yes
Band	On event	"Battery at 10%"	No
Security	On event	"New account login"	No

Smart scheduling: notifications are not sent during nighttime; time zone is automatically accounted for.

13. Technical Requirements

Parameter	iOS	Android
Minimum version	iOS 16+	Android 11+
BLE	5.3	5.3
App size	~85 MB	~65 MB
Framework	SwiftUI	Kotlin / Jetpack Compose
Authentication	Email, Apple ID, Google	Email, Google, Apple ID
Web3	Hidden (ERC-4337)	Hidden (ERC-4337)
Local DB	Core Data / SQLite	Room / SQLite
Analytics	Mixpanel	Mixpanel
Crash reporting	Sentry	Sentry

14. Summary Table: APP vs WEB

Feature	APP	WEB
WVI (0–100)	✅	✅
Biometrics (3 components)	✅	Widget
AI coach	✅	—
Community (WHOOP model)	✅	—
Owner discovery	✅	—
Monthly Yield % display	✅	✅
Monthly Yield $ amounts	—	✅
Staking / Deposit / Withdrawal	—	✅
MLM / Partner Network	—	✅
Wallet	—	✅
Promo materials	—	✅
Band connection	✅	—
Push notifications	✅	—

14a. v6.0 Updates — Pricing & UX

Updated to v6.0 per Alexander directives 12.03.2026

Community Entry Pricing (NOT subscription tiers)

Package	Price	Includes
Community Entry Tier 1	$49	Join the Wellex community + 2-month subscription + band free
Community Entry Tier 2	$99	Join the Wellex community + 5-month subscription + band free
After included period	$19/month	Standard subscription

PROHIBITED: calling $49/$99 "subscription tiers", "subscription plans", "pricing plans". CORRECT: "joining the Wellex community", "community entry".

Trust Moment UX Protocol

When WVI rate < 4% after grace period — mandatory 6-step protocol:

Show current WVI (specific number)
Show current rate and why it is at that level
Show what specifically to improve (sleep, activity, stress)
Show realistic path to the next tier
AI assistant with personalized action plan
Progress bar to next yield level

15. Help Center & Support

15.1 In-App Support Flow

The user gets help without leaving the app:

Channel	Description	Response Time
AI Help Bot	First line — answers 80%+ of requests instantly	< 5 sec
In-App Chat	Live support agent (text)	< 2 hours
Email	support@wellex.ai — for complex cases	< 24 hours
FAQ	Built-in knowledge base with search	Instant

15.2 Help Center — Categories

▸ Band — connection, sync, battery, OTA, returns ▸ WVI — how it's calculated, why it dropped, calibration ▸ Yield — how it's accrued, when it's paid, why % changed ▸ Staking — deposit, withdrawal, lock-up periods (in WEB) ▸ Account — password, 2FA, deletion, GDPR ▸ Wallet — key export, multi-chain, transactions ▸ Partner Program — ranks, bonuses, payouts ▸ Community — groups, challenges, moderation

15.3 Escalation Path

User → AI Help Bot (auto, instant)
 ↓ if not resolved (< 5% of cases)
In-App Chat → Live Agent
 ↓ if technical issue
Tier 2 Support (blockchain, wallet)
 ↓ if critical (loss of funds)
War Room Protocol → CTO + Head of Support

15.4 Proactive Support (AI-driven)

▸ WVI dropped >15 in a day → automatic tip from AI Coach ▸ Band not synced >24 hours → push notification with instructions ▸ Yield not accrued → proactive notification + explanation of reason ▸ Lock-up expires in 3 days → reminder with options (withdraw / reinvest)

→ Related documents: 03_WELLNESS_SCORE.md (WVI) · 05_DASHBOARD.md (WEB Dashboard) · 26_COMMUNITY.md (Community spec) · 07_AI_SYSTEM.md (AI Assistant)

1. UX Philosophy​

Key Principle: APP = Wellness + Community​

Monthly Yield — Display Rules​

Lazy Factor​

Design Principles​

2. Navigation (Bottom Tab Bar)​

3. Screen 1: Home​

Wireframe​

Screen Elements​

4. Screen 2: Metrics​

Wireframe​

Charts and Trends​

Drill-down on Component Tap​

5. Screen 3: Community — WHOOP Model​

Wireframe​

Community Features (WHOOP Model)​

Community vs WHOOP / Oura / Strava​

6. Screen 4: AI Assistant​

Wireframe​

Content Formats​

Recommendation Types​

7. Screen 5: Settings​

Features​

Button to WEB​

8. User Flows​

8.1 Onboarding (New User)​

8.2 Daily Cycle (Active User)​

8.3 Transition to WEB (Financial Operations)​

8.4 Discovery: Find Nearby Band Owners​

8.5 Joining a Community Group​

8.6 Participating in a Team Challenge​

9. Dark / Light Theme​

10. Accessibility (WCAG 2.1 AA)​

11. Offline Mode​

12. Push Notifications​

13. Technical Requirements​

14. Summary Table: APP vs WEB​

14a. v6.0 Updates — Pricing & UX​

Community Entry Pricing (NOT subscription tiers)​

Trust Moment UX Protocol​

15. Help Center & Support​

15.1 In-App Support Flow​

15.2 Help Center — Categories​

15.3 Escalation Path​

15.4 Proactive Support (AI-driven)​

1. UX Philosophy

Key Principle: APP = Wellness + Community

Monthly Yield — Display Rules

Lazy Factor

Design Principles

2. Navigation (Bottom Tab Bar)

3. Screen 1: Home

Wireframe

Screen Elements

4. Screen 2: Metrics

Wireframe

Charts and Trends

Drill-down on Component Tap

5. Screen 3: Community — WHOOP Model

Wireframe

Community Features (WHOOP Model)

Community vs WHOOP / Oura / Strava

6. Screen 4: AI Assistant

Wireframe

Content Formats

Recommendation Types

7. Screen 5: Settings

Features

Button to WEB

8. User Flows

8.1 Onboarding (New User)

8.2 Daily Cycle (Active User)

8.3 Transition to WEB (Financial Operations)

8.4 Discovery: Find Nearby Band Owners

8.5 Joining a Community Group

8.6 Participating in a Team Challenge

9. Dark / Light Theme

10. Accessibility (WCAG 2.1 AA)

11. Offline Mode

12. Push Notifications

13. Technical Requirements

14. Summary Table: APP vs WEB

14a. v6.0 Updates — Pricing & UX

Community Entry Pricing (NOT subscription tiers)

Trust Moment UX Protocol

15. Help Center & Support

15.1 In-App Support Flow

15.2 Help Center — Categories

15.3 Escalation Path

15.4 Proactive Support (AI-driven)