Coffiq | AI-Powered Coffee Tracker React Native App

Coffiq | AI-Powered Coffee Tracker React Native App

Coffiq is a production-ready, AI-powered multi-application platform built to simplify daily caffeine tracking, sleep health optimization, merchant loyalty reward redemptions, and system administration. The platform comprises a centralized Node.js REST API with real-time WebSockets and two high-performance React Native CLI mobile apps built with TypeScript, Redux Toolkit, NativeWind v5 (Tailwind CSS), and smooth UI animations.

Demo APKs (Download & Test)

Test the applications directly on your Android device. Use the demo credentials provided below to log in.

• Customer App: Download Customer App APK
  Demo Login: shakeelsoftwaredev@gmail.com | Password: 123456
• Admin App (Super Admin Control): Download Admin App APK
  Demo Login: sa1506758@gmail.com | Password: 123456

⚠️ AI Disclosure (Envato Policy Compliance)

AI-Assisted Development: In accordance with Envato’s AI disclosure policy, the author discloses that portions of this product’s codebase were developed with the assistance of AI coding tools (Google Gemini). All generated code has been thoroughly reviewed, tested, debugged, and validated by the author to ensure production quality and correctness.

Runtime AI Features: This application also integrates AI services (Google Gemini and Groq Cloud) as runtime features for end-users. These are application features, not development tools — see the detailed disclosure below.

Stripe Billing Engine: The complete source code for the Stripe payment integration, subscription management, and billing engine is included in the package. Buyers receive full control over all payment features under the Regular license with no external dependencies beyond the Stripe SDK.

⚠️ AI Features & API Usage Disclosure

In accordance with Envato’s item quality and disclosure requirements, please be advised that this application leverages Artificial Intelligence to power specific core features. An active API key from Groq Cloud and/or Google is required to utilize these AI functionalities.

• AI Service Providers & Models: Groq Cloud (openai/gpt-oss-120b / qwen/qwen3.6-27b) and Google Gemini (gemini-2.5-flash).
• AI Beverage & Label Scanner: Uses Google Gemini Vision models to analyze captured cup photos or nutrition label scans, automatically identifying the drink and estimating volume and caffeine.
• AI Coffee & Sleep Coach Chat: Interactive conversational assistant to advise users on bedtime schedules, caffeine half-life calculations, and recipes.
• Voice Log Command Interpreter: Uses Groq speech processing to capture spoken audio logs (e.g. “I had a double espresso”) and convert them into drink logs.

Security Note: All AI requests route securely through the Node.js backend. API keys are strictly managed via the backend .env file or dynamically via the System Settings table. They are never exposed to client devices.

Third-Party Integration Costs ($0 Upfront Setup)

Coffiq is built to be highly cost-efficient. You can deploy and run the entire platform at no upfront cost ($0) by leveraging the free developer tiers of the following integrated systems:

• MongoDB Atlas (Database): Free forever (The M0 Shared Sandbox tier is 100% free and includes 512MB storage—plenty for thousands of user accounts and logs).
• Firebase FCM & Notifee (Push Alerts): Free forever (Firebase Spark plan provides unlimited native push notifications to Android and iOS devices for free).
• Cloudinary (Image Storage): Free forever (Free tier includes 25 credits/month, equivalent to approx. 25,000 image transformations/storage slots).
• Google Gemini API (Vision Scans & Coach): Free / Pay-as-you-go (Google AI Studio free tier supports 15 requests/min. Paid keys are extremely cheap—approx. $0.075 per 1 million input tokens).
• Groq Cloud API (Audio Logging & Chat): Free / Pay-as-you-go (Developer sandbox limits are free. Paid API calls are fractional cents—e.g., GPT OSS 120B / Qwen 3.6).
• SMTP Transactional Mailer (Nodemailer): Free forever (Uses a standard Gmail account to send verification and password recovery OTP emails, supporting up to 500 emails per day for free).
• Stripe SDK (Payments): Pay-as-you-go (No monthly fee. Stripe only charges a standard transaction rate of 2.9% + $0.30 per successful customer membership purchase).

Important Note – External Services and Configuration

This platform relies on external third-party services. For full functionality, you must configure your own API keys in the environment variables:

• Payment Gateways (Stripe SDK): Handles secure subscriptions, lifetime access checkouts, and signature-verified webhook processing on client mobile Payment Sheets.
• Image & Media Hosting (Cloudinary SDK): Handles secure image uploads for user avatar profiles and Support Ticket attachments.
• Push Notifications (Firebase FCM & Notifee): Delivers native cross-platform push notifications and reminder alerts directly to user devices.
• Database: Requires a MongoDB instance (local or MongoDB Atlas).

Key Platform Features

• AI Cup & Label Vision Scanner: Instantly scan coffee cups and beverage labels with your camera to extract liquid quantity and caffeine values.
• Real-time Caffeine Clearance Charts: Visually monitors metabolic caffeine clearance curves in the body based on user weight and time elapsed.
• Daily Hydration Balance: Monitors water log history alongside caffeine counts to help users maintain fluid balance.
• Customer Loyalty Rewards: Allows partner merchant check-ins, points accruals, and free coffee catalog redemptions.
• Real-time Helpdesk Chat: Connects clients and administrators via Socket.io support tickets for real-time support.
• Premium Billing Engine: Gates historical statistics, PDF exports, and unlimited AI chatbot messaging behind a Stripe Paywall.

Included Modules & Codebase Analysis

1. Customer App (Caffeine Mobile Application)

• HomeScreen: Displays current active caffeine clearance, target bedtime timer, daily progress metrics, preset catalog shortcut buttons, and push alert logs.
• AIScreen (AI Sleep & Coffee Coach): Smart chat assistant for health guidelines and voice-activated quick drink logger.
• ScanScreen: Camera UI wrapper utilizing Gemini Vision to scan and estimate beverage metrics.
• AnalyticsScreen: Displays weekly and monthly consumption line charts comparing caffeine and water intake values.
• LoyaltyScreen: Loyalty points accumulator card, merchant check-in handler, and redemptions catalog listings.
• HistoryScreen: Searchable drink database list with advanced filters and PDF data sheet exporter.
• SupportScreen: Support ticket submission form and real-time Socket.io support chat workspace.
• PaywallScreen: Premium upgrade comparison page linked with Stripe Payment Sheets.
• RemindersScreen: Sets custom recurring alarms with push notifications.
• Auth Modules: User registration, secure login, SMTP OTP code verification, and password recovery.

2. Admin App (Platform Control Center Application)

• HomeScreen (Dashboard metrics): Displays live platform statistics: total users, logged drinks today, issued loyalty points, open support tickets, and subscriber counts.
• RevenueScreen (Finance Dashboard): Displays MRR, ARPU metrics, MRR growth spline chart, and recent subscriber checkout lists.
• UsersScreen (User Management Console): Searchable database list with capabilities to block users and manually grant/revoke Premium access.
• SystemSettingsScreen: Live administration control dashboard to update API keys, app parameters, points multipliers, and maintenance mode status.
• BillingPlansScreen: Manage billing tiers catalog, details checklist, pricing adjustments, Stripe price IDs, and plan toggles.
• BroadcastScreen: Sends global push notifications via Firebase FCM to all devices.
• SupportConversationsScreen & SupportChatScreen: Helpdesk workspace to track, open, respond to, and close support tickets.
• Auth Modules: Admin-specific secure Login, registration modules, password reset, and verification check screens.

3. Centralized Backend (Node.js REST API)

• Auth Controller: Handles user registration, password hashing (Bcrypt), JWT generation, refresh tokens, and SMTP OTP validation.
• Admin Controller: Aggregates system metrics, manages user access, blocks accounts, updates settings, and sends global broadcast alerts.
• AI Controller: Integrates Gemini and Groq APIs to process vision scans, voice logs, and companion chat sessions.
• Billing Controller: Exposes Stripe Checkout Sessions endpoints and processes webhooks securely.
• Loyalty Controller: Processes checks-in, points calculations, and catalogs redemptions.
• Support Controller: System routing for customer helpdesk, managing active conversations and ticket statuses.
• TrackingLog Controller: Processes drink logs and compiles PDF report tables.
• Upload Controller: Image upload middleware routing to secure Cloudinary buckets.
• Scheduler Service (Node-cron): Triggers automated background tasks for reminders and database cleanups.
• Socket.io Sockets: Powers real-time chat ticket communication between Admins and Parents.

Project Requirements

• Node.js (v18 or v20)
• MongoDB Instance (Local or Cloud Atlas)
• React Native CLI (JDK 17, Android Studio with SDK 34/35, Xcode for iOS)

Support & Contact

If you have any questions, require setup assistance, or need custom modifications, feel free to reach out:

• Email: shakeelsoftwaredev@gmail.com
• WhatsApp: +923136900591