VibeKB Stoppr

Generated output — this is a static snapshot rendered from .vibekb/. The .vibekb/ content is the source of truth. See Reference for provenance.

Functionality index

Everything the software does

Functionality is the primary unit. Each item is something the software does, with its real status and how it was verified.

Clear

Application core

Startup, routing, navigation, deep links, widgets.

  • Application startup

    Implemented

    Initializes Flutter bindings, env, RevenueCat, Firebase, analytics, notifications, and platform SDKs before runApp.

    Verification
    Verified from source
    Trigger
    User launches the app.
    Facing
    System
    Updated
    2026-07-23

  • Startup routing

    Implemented

    Chooses WelcomeVideo, onboarding resume, PrePaywall, or MainScaffold from auth, onboarding completion, and paid status.

    Verification
    Verified from source
    Trigger
    After SDKs initialize, MyApp resolves the first screen.
    Facing
    User-facing
    Updated
    2026-07-23

  • Deep link handling

    Partially implemented

    Processes payment success, home/pledge/panic/meditation schemes, share invites, and promo deep links; some declared routes lack handlers.

    Verification
    Verified from source
    Trigger
    Incoming App Link / custom scheme / AppsFlyer OneLink / widget URI.
    Facing
    User-facing
    Updated
    2026-07-23

  • Main navigation

    Implemented

    Bottom-tab MainScaffold hosts home and primary feature surfaces with an initialIndex deep-link entry.

    Verification
    Verified from source
    Trigger
    User reaches MainScaffold after onboarding/paywall.
    Facing
    User-facing
    Updated
    2026-07-23

  • Home screen widgets

    Partially implemented

    Flutter home_widget bridge syncs streak and accountability data to iOS WidgetKit and Android AppWidgets; app group id is still a placeholder.

    Verification
    Verified from source
    Trigger
    OS shows Streak/Pledge/Panic/Meditation/Accountability widgets.
    Facing
    User-facing
    Updated
    2026-07-23

Authentication

Sign-in providers and guest access.

  • Firebase authentication

    Implemented

    AuthService signs in with Google, Apple, or email via Firebase Auth, syncs RevenueCat/Mixpanel, and writes users/{uid} profiles.

    Verification
    Verified from source
    Trigger
    User taps Google, Apple, or email sign-in / sign-up.
    Facing
    User-facing
    Updated
    2026-07-23

  • Guest anonymous access

    Implemented

    Anonymous Firebase accounts are created from several entry points when no user exists, with TTL fields for guest profiles.

    Verification
    Verified from source
    Trigger
    User skips auth during onboarding or a service needs a Firebase uid.
    Facing
    User-facing
    Updated
    2026-07-23

Onboarding

New-user funnel from welcome through paywall.

  • Onboarding introduction

    Implemented

    Welcome video and early onboarding pages introduce the product and present auth or skip options.

    Verification
    Verified from source
    Trigger
    First launch or incomplete onboarding without paid bypass.
    Facing
    User-facing
    Updated
    2026-07-23

  • Onboarding questionnaire

    Implemented

    Multi-page questionnaire saves answers locally and to users/{uid}/onboarding/questionnaire with resume support.

    Verification
    Verified from source
    Trigger
    User reaches QuestionnaireScreen in the funnel.
    Facing
    User-facing
    Updated
    2026-07-23

  • Onboarding profile and goals

    Implemented

    Collects name/age/gender, symptoms, and goals into Firestore onboarding subdocuments.

    Verification
    Verified from source
    Trigger
    After questionnaire / analysis path reaches profile and goals screens.
    Facing
    User-facing
    Updated
    2026-07-23

  • Onboarding personalized analysis

    Implemented

    Animated analysis screens plus nutrition onboarding compute calorie goals before benefits and paywall.

    Verification
    Verified from source
    Trigger
    Profile completion when questionnaire answers exist, then nutrition onboarding.
    Facing
    User-facing
    Updated
    2026-07-23

Subscription & paywalls

Superwall, RevenueCat, quotas, gating.

  • Main paywall

    Partially implemented

    PrePaywall registers Superwall placements and handles purchase success, but placement IDs are mostly INSERT_YOUR_* placeholders.

    Verification
    Verified from source
    Trigger
    PrePaywallScreen after onboarding or unpaid return visits.
    Facing
    User-facing
    Updated
    2026-07-23

  • Soft paywalls and quotas

    Partially implemented

    FeatureQuotaService and contextual Superwall placements exist, but QUOTA_SYSTEM_ENABLED is false on major feature screens.

    Verification
    Verified from source
    Trigger
    User opens gated features or ratings/redownload/quick-action offers.
    Facing
    User-facing
    Updated
    2026-07-23

  • Subscription access gating

    Implemented

    Paid access is determined from Superwall subscription status and RevenueCat CustomerInfo, not Firestore alone.

    Verification
    Verified from source
    Trigger
    Any check of isPaidSubscriber / AuthCubit paid state / onboarding completion.
    Facing
    System
    Updated
    2026-07-23

Home & daily wellness

Dashboard, streak, check-in, pledge, panic, relapse.

  • Home dashboard

    Implemented

    Central dashboard orchestrating streak display, check-in widgets, panic entry, banners, and feature shortcuts.

    Verification
    Verified from source
    Trigger
    User opens the Home tab in MainScaffold.
    Facing
    User-facing
    Updated
    2026-07-23

  • Sugar streak tracking

    Implemented

    Persists streak counters in SharedPreferences and Firestore and syncs values to home widgets.

    Verification
    Verified from source
    Trigger
    App open, check-in success/failure, relapse, or post-purchase init.
    Facing
    User-facing
    Updated
    2026-07-23

  • Daily check-in and pledge

    Implemented

    Daily pledge/check-in records success or failure with feelings/notes and can reset streak on relapse indication.

    Verification
    Verified from source
    Trigger
    User interacts with daily check-in or pledge widgets/screens.
    Facing
    User-facing
    Updated
    2026-07-23

  • Panic intervention

    Implemented

    Guided multi-step panic flow with randomized tricks and breathing/meditation helpers.

    Verification
    Verified from source
    Trigger
    User taps Panic from home, widget deep link, or notification.
    Facing
    User-facing
    Updated
    2026-07-23

  • Relapse recovery flow

    Implemented

    Relapse UI collects reason/help chips, resets streak, and may schedule recovery-challenge notifications; detailed reason chips are not fully persisted.

    Verification
    Verified from source
    Trigger
    User indicates relapse from check-in or related entry points.
    Facing
    User-facing
    Updated
    2026-07-23

Community & accountability

Forum, chat, partners.

  • Community forum

    Implemented

    Firestore-backed posts and nested comments; blocked-user filtering is incomplete on the current Cubit stream path.

    Verification
    Verified from source
    Trigger
    User opens Community and browses or posts.
    Facing
    User-facing
    Updated
    2026-07-23

  • Community chat

    Implemented

    Realtime chat collections official_chat and official_chat_{lang}; Crisp provides separate support chat.

    Verification
    Verified from source
    Trigger
    User opens official or language chat rooms.
    Facing
    User-facing
    Updated
    2026-07-23

  • Accountability partners

    Implemented

    Partnerships and matching pool in Firestore; joining the pool requires an active subscription.

    Verification
    Verified from source
    Trigger
    User requests, accepts, or matches an accountability partner.
    Facing
    User-facing
    Updated
    2026-07-23

Education & content

Videos, articles, chatbot.

  • Learn video lessons

    Implemented

    Hardcoded Mux HLS lesson catalog with local subtitle assets and completion tracked in SharedPreferences.

    Verification
    Verified from source
    Trigger
    User opens Learn videos.
    Facing
    User-facing
    Updated
    2026-07-23

  • Articles education

    Implemented

    Loads article content from assets and syncs reading progress to SharedPreferences and Firestore.

    Verification
    Verified from source
    Trigger
    User opens Articles list/detail.
    Facing
    User-facing
    Updated
    2026-07-23

  • Melinda chatbot assistant

    Implemented

    CBT-oriented AI assistant using Groq chat/transcription and OpenAI speech, limited to 20 API interactions per day.

    Verification
    Verified from source
    Trigger
    User opens the Melinda chatbot screen.
    Facing
    User-facing
    Updated
    2026-07-23

Nutrition & food

Scanning, calories, recipes, Rate My Plate.

  • Sugar food scanning

    Implemented

    Vision analysis via Groq-compatible endpoint with local image cache and optional Firebase Storage fallback; nutrition path uses ApiRateLimitService (not FeatureQuota soft-paywall).

    Verification
    Verified from source
    Trigger
    User opens food scanner and captures or selects an image.
    Facing
    User-facing
    Updated
    2026-07-23

  • Calorie nutrition tracking

    Implemented

    Firestore food_logs, daily_summaries, nutrition goals, body metrics, and workout logs under the user document.

    Verification
    Verified from source
    Trigger
    User views calorie dashboard or logs food/workouts.
    Facing
    User-facing
    Updated
    2026-07-23

  • Recipe discovery

    Implemented

    Searches Edamam first with Spoonacular fallback; favorites stored under users/{uid}/favorite_recipes.

    Verification
    Verified from source
    Trigger
    User browses or favorites recipes.
    Facing
    User-facing
    Updated
    2026-07-23

  • Rate My Plate

    Implemented

    Plate photo scoring via Groq vision and OpenAI results; quota gate present but disabled.

    Verification
    Verified from source
    Trigger
    User opens Rate My Plate scan/results.
    Facing
    User-facing
    Updated
    2026-07-23

Wellness tools

Meditation, breathing, challenge, fasting.

  • Meditation and breathing

    Implemented

    In-app meditation and breathing exercise UIs, also reachable via stoppr://meditation.

    Verification
    Verified from source
    Trigger
    User opens meditation/breathing screens or widget deep link.
    Facing
    User-facing
    Updated
    2026-07-23

  • Twenty-eight day challenge

    Implemented

    Day/task progression stored in SharedPreferences and users/{uid}/challenges with varied task types.

    Verification
    Verified from source
    Trigger
    User starts or continues the 28-day challenge.
    Facing
    User-facing
    Updated
    2026-07-23

  • Fasting tracker

    Implemented

    Local-only fasting logs in SharedPreferences with scheduled reminder notifications.

    Verification
    Verified from source
    Trigger
    User configures or monitors a fast.
    Facing
    User-facing
    Updated
    2026-07-23

Platform services

Notifications, analytics, settings.

  • Notifications

    Implemented

    Local notifications and FCM with preference storage; some payloads map to placeholder Superwall placements.

    Verification
    Verified from source
    Trigger
    Permission grant, schedule points, FCM messages, or preference changes.
    Facing
    User-facing
    Updated
    2026-07-23

  • Analytics and telemetry

    Implemented

    Mixpanel primary product analytics, AppsFlyer attribution, Crashlytics error reporting, Firebase Analytics purchase events.

    Verification
    Verified from source
    Trigger
    App events throughout user journeys.
    Facing
    System
    Updated
    2026-07-23

  • User profile and settings

    Implemented

    Profile editing, notification preferences, and RevenueCat Customer Center for subscription management.

    Verification
    Verified from source
    Trigger
    User opens profile/settings screens.
    Facing
    User-facing
    Updated
    2026-07-23