bagisto/opensource-ecommerce-mobile-app

This repository holds an open source mobile shopping app that pairs with Bagisto. Bagisto is a separate web-based eCommerce platform written in Laravel, the popular PHP framework. By itself, Bagisto is the website where a merchant lists products and takes orders. This repo adds the matching iOS and Android app that a merchant's customers can install on their phones to browse the same catalog and place orders, with products, categories, and orders kept in sync between the website and the app. The app is written in Flutter, Google's framework for building one codebase that compiles to both Android and iOS. The programming language is Dart, which is what Flutter uses. The README lists official builds on the Google Play Store and the Apple App Store as a live demo, so prospective users can install and try it before cloning the source. The maintainer is Webkul, who runs the Bagisto project, and the app is published under the MIT license. The feature list, illustrated with screenshots, covers what you would expect from a small shopping app: a home page with search, support for the different product types Bagisto offers, dark mode, push notifications, discount coupons, guest checkout, a wishlist, browsing by category, an order details screen, and product reviews. The README does not go deeper than that, leaving the per-screen behaviour to the live demo and the screenshots. The installation guide is detailed and aimed at developers who want to rebuild and customise the app. It lists required versions, including Bagisto 2.0.0 or higher, Flutter 3.38.9, Dart 3.10.8, and recent Android Studio and Xcode releases. It assumes that the Bagisto API module has been installed on the merchant's server first. Steps cover cloning the repo, running flutter pub get to install dependencies, connecting a device or emulator, and running flutter run. Minimum target versions are Android 22 and iOS 15.5. A configuration section walks through the small changes a merchant needs in order to make the app point at their own store. The file lib/core/constants/api_constants.dart holds the Bagisto GraphQL endpoint, the storefront key, and a company name. The AppColors class controls the primary brand colour through hex values. There are also notes on swapping in google-services.json and GoogleService-Info.plist for push notifications, changing the app title, splash screen, and icon for both platforms, and a link to a YouTube installation walkthrough.