Skip to content

AC1706-67/bioreceipt.ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

BioReceipt.AI 🧬

AI-powered health tracking platform built for the KIRO IDE Hackathon

React Native TypeScript Supabase AI Powered

πŸ† Built with KIRO IDE - A comprehensive health tracking app that combines substance logging, wearable integration, and AI-powered insights to help users make informed health decisions.


🌟 Overview

BioReceipt.AI is a mobile-first health tracking platform that revolutionizes how users monitor and understand their health data. Built during the KIRO IDE Hackathon, this app combines cutting-edge AI personalization with comprehensive health tracking to deliver actionable insights.

🎯 Mission: Empower users to make informed health decisions through intelligent data tracking and AI-powered personalization.


⚑ Key Features

πŸ€– AI-Powered Intelligence

  • 6 AI Provider Integration - OpenAI, Anthropic, Google, Hugging Face, Ollama, Local Llama
  • Personalized Health Tips - AI-curated recommendations based on user patterns
  • Predictive Analytics - Trend forecasting and health insights
  • BioReceipt AI Engine - Custom health analysis and safety alerts

πŸ“Š Comprehensive Tracking

  • Substance Intake Logging - Track medications, supplements, food, and beverages
  • Custom Substance Creation - Add personalized tracking categories
  • Photo Attachments - Visual logging with optimized image handling
  • Wearable Integration - Apple Health & Google Fit connectivity
  • Medication Reminders - Smart scheduling with custom alerts

🎨 Advanced User Experience

  • Offline-First Architecture - Full functionality without internet
  • Real-Time Sync - Seamless data synchronization across devices
  • Accessibility Compliant - WCAG 2.1 AA standards with screen reader support
  • Performance Optimized - Lazy loading, caching, and memory management
  • Dark/Light Themes - Adaptive UI with user preferences

πŸ”’ Enterprise-Grade Security

  • HIPAA Compliance - Healthcare-grade data protection
  • End-to-End Encryption - AES-256 encryption at rest and in transit
  • Row-Level Security - Granular data access controls
  • Audit Logging - Comprehensive security event tracking

πŸ“ˆ Analytics & Insights

  • Real-Time Dashboard - Live health metrics and trends
  • Progress Tracking - Streaks, achievements, and goal monitoring
  • Feedback System - User ratings and sentiment analysis
  • Admin Analytics - Comprehensive reporting and user insights

πŸ›  Tech Stack

Category Technology
Frontend React Native, TypeScript, Expo
Backend Supabase (PostgreSQL + Auth)
AI/ML Multi-provider AI integration
State Management React Context + Custom Hooks
Storage Supabase + Local Caching
Testing Jest, React Native Testing Library
Development KIRO IDE, Metro Bundler

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • React Native CLI
  • Expo CLI
  • Supabase account

Installation

# Clone the repository
git clone https://github.com/yourusername/BioReceipt-ai.git
cd BioReceipt-ai

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Add your Supabase URL and API keys

# Set up database
# Run the SQL schema in your Supabase dashboard
# File: database/supabase-production-schema.sql

# Start the development server
npx expo start

# Run on iOS
npx expo run:ios

# Run on Android
npx expo run:android

Database Setup

  1. Create a new Supabase project
  2. Copy the contents of database/supabase-production-schema.sql
  3. Paste and run in your Supabase SQL editor
  4. Update your .env file with Supabase credentials

πŸ“± App Architecture

Core Components

  • BioReceiptApp - Main application container
  • IntakeLoggingScreen - Substance tracking interface
  • PersonalizedTipsScreen - AI-powered recommendations
  • BioReceiptInsightsScreen - Analytics and trends
  • MyDayScreen - Daily overview and quick actions

AI Services

  • BioReceipt AI Service - Core AI processing engine
  • Multi-Provider AI Service - Failover AI provider management
  • Personalization Engine - User behavior analysis
  • Predictive Analytics - Health trend forecasting

Data Architecture

  • 13 Database Tables - Comprehensive data modeling
  • Row-Level Security - User data isolation
  • Real-Time Subscriptions - Live data updates
  • Offline Sync - Conflict resolution and queuing

πŸ§ͺ Testing

# Run all tests
npm test

# Run integration tests
npm run test:integration

# Run performance tests
npm run test:performance

# Test database connection
node test-supabase-connection.js

Test Coverage

  • Unit Tests - Component and service testing
  • Integration Tests - End-to-end workflow testing
  • Performance Tests - Memory and speed optimization
  • Accessibility Tests - WCAG compliance verification

πŸ“Š Features Deep Dive

AI Personalization Engine

  • Behavioral Analysis - User pattern recognition
  • Content Curation - Personalized health tip delivery
  • Risk Assessment - Safety alert generation
  • Trend Prediction - Health outcome forecasting

Photo Attachment System

  • Optimized Upload - Progressive image loading
  • Offline Queue - Background sync when connected
  • Accessibility - Screen reader descriptions
  • Performance - Memory-efficient image handling

Substance Tracking

  • 21 Pre-defined Substances - Common medications and supplements
  • Custom Categories - User-defined tracking items
  • Smart Suggestions - AI-powered recommendations
  • Intake History - Comprehensive logging and analytics

πŸ”§ Configuration

Environment Variables

EXPO_PUBLIC_SUPABASE_URL=your_supabase_url
EXPO_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key

AI Provider Setup

Configure multiple AI providers for redundancy:

  • OpenAI GPT-4
  • Anthropic Claude
  • Google Gemini
  • Hugging Face Models
  • Local Ollama
  • Custom Local Models

πŸ“ˆ Performance Metrics

  • 90%+ Cache Hit Ratio - Optimized data retrieval
  • <100ms Response Time - Lightning-fast UI interactions
  • Offline-First - Full functionality without internet
  • Memory Efficient - Optimized for mobile devices
  • Battery Optimized - Minimal background processing

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Workflow

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Submit a pull request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ™ Acknowledgments

  • KIRO IDE Team - For the amazing development platform
  • Supabase - For the robust backend infrastructure
  • React Native Community - For the excellent mobile framework
  • AI Provider Teams - For making advanced AI accessible

πŸ“ž Support


Built with ❀️ using KIRO IDE

⭐ Star this repo | πŸ› Report Bug | πŸ’‘ Request Feature

About

AI-powered intake tracker for Kiro-ide Hackathon

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors