Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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

This open-source mobile ecommerce app seamlessly transforms your Bagisto store into a powerful mobile platform, providing real-time synchronization of products and categories.
https://github.com/bagisto/opensource-ecommerce-mobile-app

ecommerce-mobile ecommerce-mobile-app flutter-apps flutter-ecommerce flutter-ecommerce-app laravel-ecommerce laravel-ecommerce-project laravel-mobile mobile-app mobile-ecommerce opensource-ecommerce

Last synced: about 1 month ago
JSON representation

This open-source mobile ecommerce app seamlessly transforms your Bagisto store into a powerful mobile platform, providing real-time synchronization of products and categories.

Host: GitHub
URL: https://github.com/bagisto/opensource-ecommerce-mobile-app
Owner: bagisto
License: mit
Created: 2023-10-25T13:01:19.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-08-17T14:14:33.000Z (3 months ago)
Last Synced: 2024-09-27T04:01:59.153Z (about 2 months ago)
Topics: ecommerce-mobile, ecommerce-mobile-app, flutter-apps, flutter-ecommerce, flutter-ecommerce-app, laravel-ecommerce, laravel-ecommerce-project, laravel-mobile, mobile-app, mobile-ecommerce, opensource-ecommerce
Language: Dart
Homepage: https://bagisto.com/en/laravel-ecommerce-mobile-app-flutter/
Size: 3.89 MB
Stars: 4,907
Watchers: 9
Forks: 99
Open Issues: 2
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

        


    





    

    



# Open Source eCommerce Mobile App

[Bagisto](https://bagisto.com/en/) 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

![enter image description here](https://raw.githubusercontent.com/bagisto/temp-media/master/img1.png)

## All Type Product Supported

![enter image description here](https://raw.githubusercontent.com/bagisto/temp-media/master/img2%20(1).png)

## Dark Mode and Push Notification

![enter image description here](https://raw.githubusercontent.com/bagisto/temp-media/master/img6.png)

## Discount Coupons and Guest Checkout

![enter image description here](https://raw.githubusercontent.com/bagisto/temp-media/master/img5.png)

## Wishlist and Compare Product 

![enter image description here](https://raw.githubusercontent.com/bagisto/temp-media/master/img4.png)

## Share and Product Reviews

![enter image description here](https://raw.githubusercontent.com/bagisto/temp-media/master/img3.png)

## Installation Guide

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

- Bagisto Version - v2.0.0

- Android Studio Version - Flamingo | 2022.2.1 

- Flutter Version - 3.10.1

- Dart - 3.0.1

- Xcode - 14.3

- Swift - 5

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

- Open your terminal or command prompt

- Navigate to the directory where you want to save the project

- Use the git clone command followed by the repository URL

```sh

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

```

### Install dependencies

- Navigate to the project's directory

```sh

cd 

```

  

- Run the following command to install the required packages

```sh

flutter pub get

```

### Generate Required files

- Navigate to the project's directory

```sh

cd 

```

- Run the following command to generate the required files

```sh

flutter pub run build_runner build --delete-conflicting-outputs 

```

### Connect a device or emulator

* Physical Device

  1. Enable USB debugging on your device

  2. Connect it to your computer using a USB cable.

* Emulator

  1. Start an Android or iOS emulator using your preferred IDE or tools.

 

### Run the Project

- Use the following command to build and run the project

```sh

flutter run

```

## Minimum Versions

- Android: 21

- iOS: 12

## Configurations Steps

### For Setup

Change the baseUrl  as per your store

**Path:** lib/utils/server_configuration.dart

```sh

static const String baseUrl = ‘....’;

```

> Note: Add the value of the complete URL ending with the GraphQL API endpoint. E.g - https://example.com/graphql 

### For Theme

Change the Theme for your app

**Path:** lib/utils/mobikul_theme.dart

```sh

static const Color primaryColor = Color(***********);  

static const Color accentColor = Color(***********); 

```

### For Push Notification Service

- Android 

Replace "google-services.json".

- iOS 

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

* Android

  1. **Path:** android/app/src/main/AndroidManifest.xml

  2. **Change app name:** android:label="***********"

* iOS

  1. Go to the general tab and identity change the display name to your app name

 

> For Homepage Header Title - Go to ‘assets/language/en.json’

> (Note: Here, “en” in en.json refers to the languages that would be supported within the application)

### For Splash Screen

* For adding Lottie as Splash Screen

  1. **Path:** assets/lottie/splash_screen.json

  2. After updating the Lottie file, update the ‘splashLottie’ in lib/utils/assets_constants.

```sh

 static const String splashLottie = "assets/lottie/splash_screen.json";

```

 

* For adding an Image as a Splash Screen

  1. **Path:** assets/images/splash.png

  2. After updating the Image file, update the ‘splashImage’ in lib/utils/assets_constants.

```sh

  static const String splashImage = "assets/images/splash.png";

```

### For App Icon

* **Android:** Open the android folder in Android Studio and then right click app > new > Image Asset set Image.

* **iOS:** Replace the icons over the path > ios/Runner/Assets.xcassets/AppIcon.appiconset

## Installation Video

[![Watch the video](https://i.ibb.co/c6qd31t/thumbnail-1.jpg)](https://www.youtube.com/watch?v=tvm2NUZP9ks)

## API Documentation

For the API Documentation, please go through - https://github.com/bagisto/headless-ecommerce/

## 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.