Skip to content

Happiesamuel/mealio-fullstack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

128 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ” Mealio

A modern food ordering app built with React Native and Expo, featuring real-time order tracking, push notifications, and Users authentication and authorization.

React Native Expo TypeScript Appwrite

✨ Features

🍽️ Core Features

  • Browse Restaurants - Discover local restaurants and explore their menus
  • Food Ordering - Simple and intuitive food ordering experience
  • Real-time Order Tracking - Live updates on order status (Pending β†’ Shipped β†’ Delivered)
  • Multiple Payment Methods - Support for various payment options
  • Order History - View all your past orders with detailed information

πŸ”” Notifications

  • Real-time Push Notifications - Instant updates on order status changes
  • In-app Notifications - Notification center with unread badge indicators
  • Toast Messages - Non-intrusive status updates within the app
  • Notification History - Complete history of all notifications

πŸ‘€ User Management

  • User Authentication - Secure login and registration
  • Guest Mode - Order without creating an account
  • Profile Management - Update personal information and preferences
  • Multiple Addresses - Save and manage delivery addresses

πŸ“¦ Order Management

  • Smart Cart System - Add, remove, and modify cart items
  • Order Scheduling - Automatic status updates based on time
  • Order Tracking - Visual progress indicator for order status
  • Time Estimates - Real-time countdown to delivery

🎨 UI/UX

  • Modern Design - Clean and intuitive interface
  • Dark Mode Support - (Optional) Toggle between light and dark themes
  • Smooth Animations - Polished user experience with animations
  • Responsive Layout - Works seamlessly on different screen sizes

πŸš€ Tech Stack

Frontend

  • React Native - Cross-platform mobile framework
  • Expo - Development and build toolchain
  • TypeScript - Type-safe code
  • NativeWind (Tailwind CSS) - Styling
  • React Navigation - Navigation library
  • Expo Router - File-based routing

Backend & Services

  • Appwrite - Backend as a Service (BaaS)
    • Database
    • Authentication
    • Storage
    • Real-time subscriptions
    • Cloud Functions

State Management

  • React Query (TanStack Query) - Server state management
  • Zustand - Client state management

Notifications

  • Expo Notifications - Local and push notifications
  • Appwrite Real-time - Live updates via WebSocket

Additional Libraries

  • React Native Toast Message - Toast notifications
  • Zod - Form vaildation
  • OTP Email Provider & Backend for OTP Config - Plunk & Next Js
  • AsyncStorage - Local data persistence

πŸ“± Screenshots

Home Screen Restaurants Food Detail

πŸ› οΈ Installation

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn
  • Expo CLI
  • iOS Simulator or Android Emulator (optional)
  • Expo Go app (for testing on physical devices)

Real-time Order Status Updates

Orders automatically transition through statuses:

  1. Pending β†’ Order placed
  2. Shipped β†’ Rider assigned (after 30 minutes)
  3. Delivered β†’ Order delivered (after 2 hours)

The app uses:

  • Client-side interval checks (every 12 seconds when app is active)
  • Appwrite real-time subscriptions for instant UI updates
  • Optional: Appwrite Cloud Functions for 24/7 updates

Notification System

Three-layer notification system:

  1. Database notifications - Persistent notification records
  2. Toast notifications - In-app visual feedback
  3. Push notifications - Native OS notifications

Notifications include:

  • Unread badge on notification bell
  • Real-time count updates
  • Mark as read functionality
  • Notification history

Order Tracking

Visual progress tracker showing:

  • Order placed
  • Order confirmed
  • Order processed
  • Out for delivery
  • Order delivered

With live time estimates and status-based styling.

πŸ‘¨β€πŸ’» Author

Your Name

πŸ™ Acknowledgments

πŸ“ž Support

For support, email odionsamuel2005@gmail.com or open an issue on GitHub.

πŸ—ΊοΈ Roadmap

  • Add restaurant reviews and ratings
  • Implement favorites system
  • Add promo codes and discounts
  • Support for multiple languages
  • Restaurant dashboard for order management
  • Delivery driver app
  • Table reservations
  • Loyalty rewards program

πŸ“₯ Download

Android

Download APK

Latest Version: v1.0.0
File Size: ~141MB
Minimum Android: 6.0+

View All Releases

Installation Instructions

  1. Download the APK from the link above
  2. Go to Settings β†’ Security β†’ Enable Install from unknown sources
  3. Open the downloaded APK file
  4. Tap Install
  5. Open Mealio and start ordering! πŸ•




Made with ❀️ and β˜• by Hs_the_dev