BabyShopHub Documentation

Complete reference for the BabyShopHub Flutter app — covering everything from shopping to system architecture.

Welcome to BabyShopHub Docs

BabyShopHub is a full-featured, cross-platform baby products shopping app built with Flutter. It connects parents with premium baby essentials — clothing, diapers, food, toys, and bath products — through a delightful, secure, and intuitive experience.

What's in these docs?

️ User Guide

Learn how to create an account, browse products, manage your cart, track orders, and secure your account with two-factor authentication.

️ Developer Guide

Understand the architecture, Firestore schemas, service providers, admin panel, email relay system, and deployment pipeline.

Key Features at a Glance

FeatureDescription
AuthEmail/password + Google SSO + TOTP 2FA
ShoppingSearch, filter by category, product details with image gallery
CartPromo codes, stock-aware quantities, live subtotal
CheckoutSaved addresses, order confirmation email
OrdersFull history + real-time status tracking (7 stages)
WishlistSave items + automated back-in-stock email alerts
AI ChatGroq-powered LLM assistant (Llama 3.3 70B) with offline fallback
Admin PanelFull product CRUD, order management, user notifications
ProfileCustom avatar, Cloudinary photo upload, display name edit
ThemeLight/dark mode + custom color presets, persisted via SharedPreferences

Technology Stack

Flutter (Dart 3)      — Cross-platform mobile/web/desktop client
Firebase Auth         — Secure authentication (email, Google)
Cloud Firestore       — Real-time NoSQL database
Provider              — State management (ChangeNotifier)
Groq API              — LLM AI chat (Llama 3.3-70B / Llama 3.1-8B)
Cloudinary            — Cloud image upload & hosting
Node.js + Nodemailer  — SMTP email relay server (Zoho)
Fumadocs + Next.js    — This documentation site

Version

Current version: v0.1.0 (Flutter SDK ^3.11.5, Dart ^3.0)

🚀 Quick Start Guide

Getting started with BabyShopHub is incredibly easy. Whether you're a new parent looking for premium products or a developer contributing to the project, here is how you can jump right in.

For Parents (Users)

  1. Download the App: Navigate to our /downloads page to get the latest APK for Android.
  2. Create an Account: Open the app and register using your email or a Google account.
  3. Secure Your Account: Enable TOTP 2FA in your profile settings for maximum security.
  4. Shop: Browse our extensive catalog of baby essentials, add to cart, and checkout seamlessly.

For Developers

  1. Prerequisites: Ensure you have Flutter ^3.11.5 installed.
  2. Clone the Repo: Clone the repository and run flutter pub get.
  3. Environment Setup: Set up your Firebase project and add the google-services.json (Android) and GoogleService-Info.plist (iOS).
  4. Run the App: Execute flutter run to start the app in your emulator or physical device.

Check out the Developer Guide for deep dives into our state management, Firebase schemas, and the AI chatbot integration!

On this page