opensource-ecommerce-mobile-app README

The project's README from github.com/bagisto/opensource-ecommerce-mobile-app. As one markdown file: README.md.

Total Downloads

Ask DeepWiki

Open Source eCommerce Mobile App

Bagisto revolutionizes the world of mobile commerce with its open-source eCommerce mobile app solution. This open-source mobile ecommerce app seamlessly transforms your Bagisto store into a powerful mobile platform, providing real-time synchronization of products and categories. With a user-friendly interface, managing orders becomes a breeze, making it an essential tool for tech-savvy individuals and those new to eCommerce.

This mobile app, built on the foundation of the Bagisto eCommerce framework and leveraging the robust Laravel stack, offers many features for a comprehensive and efficient mobile shopping experience. The app ensures easy product information management and accelerates time-to-market for your products, all while giving you complete control over your store.

Live Demo

Android: https://play.google.com/store/apps/details?id=com.webkul.bagisto.mobikul

iOS: https://apps.apple.com/us/app/mobikul-bagisto-laravel-app/id6447519140

Features

The open-source ecommerce mobile app comes with an array of features to improve your customers' shopping experience.

Interactive Home Page and Search

Interactive Home Page and Search

All Type Product Supported

All Type Product Supported

Dark Mode and Push Notification

Dark Mode and Push Notification

Discount Coupons and Guest Checkout

Discount Coupons and Guest Checkout

Wishlist and Product Category

Wishlist and Product Category

Order Details and Product Reviews

Order Details and Product Reviews

Installation Guide

Before beginning with the installation, you will need the following with the mentioned versions

Make sure you have installed the API module and set this up properly on your bagisto.

NOTE: It is recommended that you run a simple Hello World program in Flutter first before proceeding further so that you are sure that the environment is properly set up.

Installation Steps

Clone the repository

git clone https://github.com/bagisto/opensource-ecommerce-mobile-app.git

Install dependencies

cd <repository-name>

flutter pub get

Connect a device or emulator

Run the Project

flutter run

Minimum Versions

Configurations Steps

For Setup

Change the baseDomain as per your store

Go to lib/core/constants/api_constants.dart and configure the following:

/// Bagisto GraphQL endpoint (e.g., https://your-bagisto-server.com/graphql)
const String bagistoEndpoint = 'YOUR_BAGISTO_ENDPOINT_HERE';

/// Storefront key for Bagisto API
/// Get this from your Bagisto admin panel
const String storefrontKey = 'YOUR_STOREFRONT_KEY_HERE';

/// Company name (optional metadata)
const String companyName = 'Your Company Name';

For Theme

In the AppColors class, find and modify the primary colors:

class AppColors {
  // Primary Colors - Modify these hex values to change the app's primary color
  static const Color primary500 = Color(0xFFFF6900);  // Main primary color
  static const Color primary600 = Color(0xFFF54900);  // Darker variant for pressed states
  // ...
}

To change the primary color:

For Push Notification Service

Replace "google-services.json".

Replace "GoogleService-Info.plist".

Helpful Articles

Android → https://mobikul.com/knowledgebase/generating-google-service-file-enable-fcm-firebase-cloud-messaging-android-application/

iOS → https://mobikul.com/knowledgebase/generating-new-googleservice-info-plist-file-fcm-based-project-ios-app/

For Application Title

For Splash Screen

For App Icon

Installation Video

Watch the video

API Documentation

For the API Documentation, please go through - https://api-docs.bagisto.com/api/graphql-api/introduction.html

Usage

For detailed usage instructions, refer to the official documentation

Contributing

Contributions are welcome! Follow the contribution guidelines to get started.

License

Bagisto is open-sourced software licensed under the MIT license.

opensource-ecommerce-mobile-app (bagisto/opensource-ecommerce-mobile-app)

Searching Database…

16.1K ·GitHub
Opensource-ecommerce-mobile-app
Что это такое?Это официальное мобильное приложение для Bagisto, платформы электронной коммерции с открытым исходным кодом. Оно позволяет превратить магазин на Bagisto в мобильное приложение для покупок, где товары, категории и заказы синхронизируются в реальном времени.
Это самостоятельное приложение или ему нужен магазин на Bagisto?Это мобильный клиент на Flutter, который подключается к существующему магазину Bagisto (построенному на Laravel) через API. Собственного серверного бэкенда у него нет.
Как мне его запустить?Клонируйте репозиторий, выполните команду установки зависимостей Flutter в каталоге проекта, подключите физическое устройство или запустите эмулятор, затем соберите и запустите проект командой Flutter run.
Нужно ли что-то настроить перед клонированием?Нужны рабочая среда Flutter и запущенный магазин Bagisto, к которому будет подключено приложение. В README рекомендуется сначала протестировать простую программу Flutter 'Hello World', чтобы убедиться, что среда настроена правильно.
Какие минимальные версии ОС поддерживаются?Приложение требует Android 22 или выше и iOS 15.5 или выше.
Как подключить приложение к моему магазину?Отредактируйте файл lib/core/constants/apiconstants.dart и измените значение baseDomain, указав адрес вашего магазина Bagisto.
Можно ли изменить брендинг приложения?Да, можно изменить основной цвет темы: отредактируйте класс AppColors, заменив шестнадцатеричный код и подстроив более темный оттенок primary600. Также можно заменить значки приложения для Android и iOS.
Поддерживает ли оно push-уведомления?Да, для этого нужно заменить файл google-services.json для Android и файл GoogleService-Info.plist для iOS на вашу конфигурацию Firebase.
Зачем использовать это вместо создания мобильной витрины с нуля?Это дает владельцам магазинов Bagisto готовое приложение на Flutter с синхронизацией товаров и заказов в реальном времени сразу после настройки. Так сокращается время выхода на рынок, и не нужно создавать мобильный клиент с нуля.
What are similar projects?bagisto, flutter_carplay, awesome-flutter, Best-Flutter-UI-Templates, FlutterExampleApps, localsend, happy, rustdesk
Which topics is it in?flutter-apps, material-you, push-notifications, laravel, sync, dart, ecommerce, flutter, mobile-app, mobile, ios, android
Creator
bagisto
Size
9.8 MB
Stars
16.1K
Updated
CommitOct 19Releasev2.5.2Oct 19
Age
2y
Commits · 90 Days