bagisto / opensource-ecommerce-mobile-app Goto Github PK

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

Home Page: https://bagisto.com/en/laravel-ecommerce-mobile-app-flutter/

License: MIT License

Kotlin 0.21% Ruby 0.18% Swift 0.37% Objective-C 0.01% Dart 96.18% CMake 1.24% C++ 1.59% C 0.09% HTML 0.12%

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

opensource-ecommerce-mobile-app's Introduction

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

All Type Product Supported

Dark Mode and Push Notification

Discount Coupons and Guest Checkout

Wishlist and Compare Product

Share and Product Reviews

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

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

Install dependencies

Navigate to the project's directory

cd <repository-name>

Run the following command to install the required packages

flutter pub get

Generate Required files

Navigate to the project's directory

cd <repository-name>

Run the following command to generate the required files

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

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

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

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

For Push Notification Service

Android

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

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.

 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.

  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

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.

opensource-ecommerce-mobile-app's People

Contributors

Stargazers

Watchers

Forkers

vivek-webkul prabhat-webkul rafiulhasanarb abdallah-tah fhferreira husnulm bdsoliveira kechankrisna youyi1314 sur2548 shalomfriss hariuc monowarfs yun-seol ajay-mandalk lalcebo germanov-v ernestoale97 suraj-webkul shamrat1 anchitandroidworld ahmadalwa yakupcemilk sufyloo malini24engineering shabeer-dev zarumaru tiennvbk hugotealeaf kakzaki kunthet siri1410 liwaa1998 doomconquer clara-flutter almamun-cse usamaksk jagadeesh5242 masudrana35362 mok4z pratikpsb nasanjargal2 amanueldemelash caviaros123 nadeemabualarayes wechulimaven almohandis atozserviceinc wvzv gj-loitp sunwaylive cano696969 kelenci wprkout heatclift dgsarve davidkihara benodr27 ruigomesa moersito sambaraks652 wawaiguntang cyber-king-ap azkhuu0216 mauricio-hns wahebtalal husseinmohammedhussein purwaren sameer-kumar-jain mohammad699 ngochiendev ahmedshaikh1234 jehadhupsgrbpu9 bahramzade azaj01 davidsegun gideonronoh github-workflow-app mhmedrjb ice7ero santoshdahale shacky zhzhhhj ketmonchi eslam0mansour alondramartinezcardona dkamundi errno0 cmuths

opensource-ecommerce-mobile-app's Issues

run first time flutter app

Target of URI hasn't been generated: 'package:bagisto_app_demo/data_model/account_models/account_update_model.g.dart'. (Documentation)

Target of URI hasn't been generated: 'package:bagisto_app_demo/data_model/account_models/account_info_details.g.dart'. (Documentation)

try to run it but does not work

Getting Gradle Error while running the App

Launching lib\main.dart on SM G610F in debug mode...
Running Gradle task 'assembleDebug'...

FAILURE: Build failed with an exception.

What went wrong:
java.util.concurrent.ExecutionException: org.gradle.api.GradleException: Failed to create Jar file C:\Users\Aniket.gradle\caches\jars-9\0cd2a3fddb44a9fb3cbb51e82ff8716a\gradle-1.0.0.jar.

org.gradle.api.GradleException: Failed to create Jar file C:\Users\Aniket.gradle\caches\jars-9\0cd2a3fddb44a9fb3cbb51e82ff8716a\gradle-1.0.0.jar.

Try:

Run with --stacktrace option to get the stack trace.
Run with --info or --debug option to get more log output.
Run with --scan to get full insights.

Get more help at https://help.gradle.org

BUILD FAILED in 29s
Error: Gradle task assembleDebug failed with exit code 1

To Reproduce
Steps to reproduce the behavior:

Go to the app directory
Enter flutter run
See error

Expected behavior
App should be run without an Error

Smartphone (please complete the following information):

Device: [SM G610F]

Getting error in flutter run

Getting error in Flutter run

When we are running flutter run we are facing some errors.

These are the tasks that are failing:

Task :app:processDebugResources FAILED
Task :flutter_share:checkDebugAndroidTestAarMetadata FAILED
Task :just_audio:mergeDexDebugAndroidTest FAILED
AGPBI: {"kind":"error","text":"Cannot fit requested classes in a single dex file (# methods: 68452 > 65536)","sources":[{}],"tool":"D8"}
Task :video_player_android:mergeDexDebugAndroidTest FAILED
AGPBI: {"kind":"error","text":"Cannot fit requested classes in a single dex file (# methods: 67057 > 65536)","sources":[{}],"tool":"D8"}
AAPT2 process unexpectedly exit.

Expected behavior
App should running.

Tools that are using

Android Studio: Android Studio Koala (2024.1.1)
Java (v17.0.10)
Flutter version: 3.22.1
Dart version: 3.4.1

Flutter web

Is it possible to extend this as a flutter web app so I don't have to make two front ends. Flutter basically is one code base for multiple platforms but the way you have it I'd have to possibly make changes to the flutter code for mobile and then to the JavaScript code for the main laravel app right?

Can we build the app using only personal apple account without team account?

Is your feature request related to a problem? Please describe.

When trying to build for ios, it fail since it asks for team account

Describe the solution you'd like
Building the ios app using just personal apple account.

Describe alternatives you've considered
Please share a ipa file for us to download and try out.

Additional context
Thank you.