# 📱 GrowApp Mobile App & Botble CMS Connector
### *Turn Your Botble eCommerce Store into a Premium Native Mobile App Instantly!*

---

## 🌟 Introduction

Stop spending thousands of dollars and months of development time building custom mobile apps for your eCommerce store.

**GrowApp Mobile App & Botble CMS Connector** is a complete, production-ready, white-label solution that lets you launch a beautiful, high-performance native iOS and Android app for your Botble CMS eCommerce platform.

This package contains two components:
1. **Laravel/Botble Plugin (Mobile App Connector)**: Installs directly on your Botble CMS platform. It exposes optimized, secure REST APIs with high-speed performance and security settings.
2. **React Native Mobile App (Expo Framework)**: A premium, ready-to-customize mobile application built with React Native, TypeScript, and Expo. It features smooth UI/UX animations, off-white sleek styling, and complete database sync.

---

## ⚡ Core Value Propositions (Why Buyers Love GrowApp)

* **Save 90%+ Development Costs**: No need to hire expensive native iOS and Android developers. Customize once, build for both.
* **Expo EAS Build Ready**: Built on top of Expo SDK. Build your `.apk` or `.ipa` files in the cloud with a single command—no complex Android Studio or Xcode setup required!
* **Blazing Fast Response Times**: API endpoints are optimized with Laravel best practices, database indexing, and eager loading to serve queries in milliseconds.
* **Apple App Store Compliant**: Features secure account deletion out-of-the-box (`DELETE /api/v1/app/account/delete`) to pass Apple's strict review guidelines effortlessly.
* **Secure Token Authentication**: Powered by Laravel Sanctum token validation, protecting user data and orders.

---

## 🛠️ Mobile App Key Features

* **Sleek Onboarding & Auth**: Beautiful login & registration screens with proper input validation and error feedback.
* **Promotional Banner Sliders**: Showcase active offers and campaigns dynamically in the home slider.
* **Nested Categories Carousel**: Circular category badges allowing customers to navigate products quickly.
* **Two-Column Product Grid**: Responsive product list showcasing item image, title, and price in local currency (`₹`).
* **Live Product Search**: Filter and search the entire product catalog in real time.
* **Premium Details Page**: Swipe-friendly product image, wishlist toggle, structured description, and floating bottom CTA bar.
* **Wishlist & Cart Management**: Instant add-to-wishlist and quick cart actions.
* **Loyalty Wallet Balance**: Shows current store credit or wallet balance directly in the customer profile.
* **User Profile Hub**: Dedicated center for managing user settings, order tracking, and account management.

---

## 🔌 API Reference (Botble Plugin Endpoints)

All endpoints are securely routed under the `/api/v1/app` prefix for clean API versioning.

### 🔓 Public Endpoints (No Token Required)
* `GET /api/v1/app/init` — Initial configurations, system settings, and app maintenance status.
* `GET /api/v1/app/home` — Slider banners, categories carousel, and featured products.
* `GET /api/v1/app/products` — Paginated and filterable product catalog.
* `GET /api/v1/app/products/{slug}` — In-depth details of a specific product.
* `GET /api/v1/app/products/search-suggest` — Live autocomplete search suggestions.
* `GET /api/v1/app/categories` — Nested categories hierarchy.
* `POST /api/v1/app/login` — Secure email/password login.
* `POST /api/v1/app/register` — Quick signup/registration.
* `POST /api/v1/app/social-login` — Social OAuth login support.

### 🔒 Secured Endpoints (Requires Bearer Token)
* `GET /api/v1/app/me` — Read logged-in customer profile.
* `POST /api/v1/app/logout` — Secure session revocation.
* `DELETE /api/v1/app/account/delete` — GDPR-compliant immediate account deletion.
* `GET /api/v1/app/wishlist` — Retrieve customer wishlist items.
* `POST /api/v1/app/wishlist/add` — Add/remove item to wishlist.
* `POST /api/v1/app/checkout` — Place orders through the integrated checkout flow.
* `GET /api/v1/app/orders` — Customer order history and fulfillment statuses.
* `GET /api/v1/app/wallet/balance` — Check customer wallet balance.

---

## 🚀 Step-by-Step Installation Guide

### Part 1: Install the Botble CMS Plugin
1. **Upload**: Upload the folder `mobile-app` (or zip file `mobile-app.zip`) to your Botble site under `platform/plugins/`.
2. **Activate**: Head to **Admin Panel > Plugins**, locate "Mobile App Connector", and click **Activate**.
3. **Configure**: Customize your API credentials and endpoints settings directly from the **Admin Panel > Mobile App > Settings** screen.

### Part 2: Running the React Native Mobile App
1. **Prerequisites**: Make sure you have Node.js and Git installed. Install Expo CLI globally:
  ```bash
  npm install -g expo-cli