Skip to content

AI-powered calorie tracking app using Google's Gemini AI for accurate food recognition from text & images. Features real-time calculations, cultural food awareness, and smart portion detection. Built with React, TypeScript & Supabase.

License

Notifications You must be signed in to change notification settings

Rkcr7/VitalBite

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 

Repository files navigation

๐ŸŽฏ Overview

VitalBite revolutionizes nutrition tracking by combining AI with a powerful Progressive Web App (PWA) experience. Whether you're tracking meals through text, images, or real-time camera capture, VitalBite delivers a native app-like experience with the convenience of a web app.

โœจ Why VitalBite?

  • ๐Ÿค– AI-Powered Precision: Leverages Google's Gemini AI for accurate food recognition
  • ๐Ÿ“ฑ Native App Experience: Install and use like a native app with full offline support
  • ๐ŸŽจ Beautiful Interface: Fluid animations and responsive design for all devices
  • ๐Ÿ”„ Always Available: Complete offline functionality with automatic background sync
  • ๐ŸŒ Culturally Aware: Recognizes dishes from various cuisines
  • โšก Lightning Fast: Instant loading and native-like performance

๐Ÿ“ฒ Installation

Install VitalBite on Your Device

Experience VitalBite like a native app by installing our PWA on your device:

๐Ÿ“ฑ Android Installation

  1. Visit VitalBite in Chrome
  2. Tap the menu (three dots) in the upper right corner
  3. Select "Install app" or "Add to Home Screen"
  4. Tap "Install" to confirm
  5. Find VitalBite on your home screen or app drawer

๐ŸŽ iOS Installation

  1. Visit VitalBite in Safari
  2. Tap the share icon (square with arrow) at the bottom center
  3. Scroll down and select "Add to Home Screen"
  4. Tap "Add" in the upper right corner
  5. VitalBite will appear on your home screen like a native app

Once installed, you'll enjoy:

  • Offline access to your nutrition data
  • Faster loading times
  • Full-screen experience without browser controls
  • Native app-like notifications (coming soon)

๐ŸŽจ Features

๐Ÿค– Intelligent Food Recognition

Multi-Modal Input

  • ๐Ÿ“ Text Recognition

    • Natural language food description
    • Smart portion estimation
    • Ingredient breakdown
    • Nutritional analysis
  • ๐Ÿ“ธ Image Recognition

    • Real-time food detection
    • Photo upload support
    • Nutritional estimation
    • Visual portion sizing

๐Ÿ“Š Advanced Statistics

Interactive Visualizations

  • ๐Ÿ“ˆ Progress Tracking

    • Daily calorie trends
    • Weekly/monthly views
    • Goal progress tracking
    • Animated charts
  • ๐Ÿ—“๏ธ Calendar View

    • Daily meal history
    • Quick entry access
    • Visual progress
    • Date navigation

๐ŸŽจ Modern User Experience

Fluid Interface

  • โœจ Animations

    • Smooth transitions
    • Loading states
    • Interactive elements
    • Progress indicators
  • ๐Ÿ“ฑ Responsive Design

    • Mobile-first approach
    • Desktop optimization
    • Cross-device support
    • Touch-friendly

Smart Features

  • ๐ŸŒ™ Dark Mode (Upcoming)
    • System preference sync
    • Eye-friendly design
    • Custom theming
    • Automatic switching

๐Ÿ‘‘ Admin Dashboard

API Key Management

  • ๐Ÿ”‘ Global API Key

    • Enable/disable global API key
    • Set shared API key for all users
    • Secure key storage
    • Real-time updates
  • ๐Ÿ”„ Key Rotation

    • Fallback API key configuration
    • Automatic key rotation
    • Key status monitoring
    • Error handling

Security Features

  • ๐Ÿ›ก๏ธ Access Control
    • Admin-only access
    • Secure route protection
    • Role-based authorization
    • Session management

๐Ÿ“ฑ Progressive Web App (PWA)

Native App Experience

  • ๐Ÿ“ฒ Install & Launch

    • Add to home screen
    • Launch like native app
    • Full-screen experience
    • Custom app icon & splash screen
  • ๐Ÿš€ Performance

    • Instant loading
    • Smooth animations
    • Native-like transitions
    • Optimized caching

Offline Capabilities

  • ๐Ÿ’พ Data Management

    • Complete offline functionality
    • Background data sync
    • Automatic conflict resolution
    • Seamless online/offline switching
  • ๐Ÿ”„ Real-time Updates

    • Silent background updates
    • Automatic version management
    • Update notifications
    • Service worker optimization

Mobile Integration

  • ๐Ÿ“ฑ Device Features

    • Camera access for food photos
    • Push notifications (Upcoming)
    • Share functionality
    • Touch-optimized UI
  • ๐ŸŽจ Responsive Design

    • Mobile-first approach
    • Adaptive layouts
    • Native-like gestures
    • Cross-device sync

๐Ÿ› ๏ธ Technical Stack

Frontend

const frontend = {
  framework: 'React 18 + TypeScript',
  styling: ['Tailwind CSS', 'Shadcn UI'],
  state: ['React Query', 'Context API'],
  animations: 'Framer Motion',
  charts: 'Recharts'
};

Backend

const backend = {
  auth: 'Supabase Auth',
  database: 'PostgreSQL',
  storage: 'Supabase Storage',
  ai: 'Google Gemini AI'
};

PWA Features

const pwa = {
  serviceWorker: 'Custom implementation',
  storage: 'IndexedDB',
  sync: 'Background Sync API',
  cache: 'Cache Storage API'
};

๐Ÿ—บ๏ธ Roadmap

โœ… Completed

  • Core Features

    • โœ“ AI-powered food recognition with Gemini
    • โœ“ Real-time calorie tracking
    • โœ“ Interactive statistics with animations
    • โœ“ PWA implementation with offline support
    • โœ“ Dark mode & responsive design
    • โœ“ Admin dashboard & user management
  • Technical Improvements

    • โœ“ Performance optimizations
    • โœ“ Loading states & animations
    • โœ“ Error handling & recovery
    • โœ“ Data synchronization
    • โœ“ Service worker implementation

๐Ÿšง In Progress

  • AI Enhancements

    • ๐Ÿ”„ Multi-cuisine recognition improvements
    • ๐Ÿ”„ Portion size estimation accuracy
    • ๐Ÿ”„ Nutritional advice generation
    • ๐Ÿ”„ Custom food database integration
  • User Experience

    • ๐Ÿ”„ Enhanced graph statistics
    • ๐Ÿ”„ Better offline functionality
    • ๐Ÿ”„ Accessibility improvements

๐ŸŽฏ Upcoming

  • New Features

    • ๐Ÿ“… Meal planning & scheduling
    • ๐Ÿค Social sharing & communities
    • ๐Ÿ“Š Advanced analytics dashboard
    • ๐Ÿ”” Smart notifications & reminders
  • Platform Expansion

    • ๐ŸŒ Multi-language support
    • ๐Ÿค Health app integrations
    • ๐Ÿ”„ API for third-party apps

๐ŸŒŸ Future Vision

  • Innovation

    • ๐Ÿค– Advanced AI personalization
    • ๐ŸŽฎ Gamification elements
    • ๐Ÿง  Machine learning improvements
    • ๐ŸŒ Regional cuisine specialization
  • Community

    • ๐Ÿ‘ฅ User communities & groups
    • ๐Ÿ“š Recipe sharing platform
    • ๐Ÿ‘จโ€๐Ÿณ Nutritionist integration
    • ๐Ÿ† Achievement system

๐Ÿ“„ License

This project is licensed under the MIT License.

๐Ÿ™ Acknowledgments

  • Google Gemini AI team
  • Supabase team
  • Open source community

Made with โค๏ธ by the VitalBite Team - Rkcr7

About

AI-powered calorie tracking app using Google's Gemini AI for accurate food recognition from text & images. Features real-time calculations, cultural food awareness, and smart portion detection. Built with React, TypeScript & Supabase.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published