Introduction

TokShop is live shopping and auction market place, this app is done fully by flutter framework, it supports both android and ios, its a livestream social shopping app for people to sell, auction, bid on live auctions and also shop from their favourite brands,Engage with your audience during the live stream allow them to speak and ask questions or comment in the live stream.

Features

  • Create live stream, attach products and start selling live
  • Invite core hosts and friends to join your live stream
  • Create live auctions during live session and accet live bids, highest bidder by the time ends wins the auction
  • Create sudden death auctions - last bidder wins the auction
  • Chat with audience live during live stream
  • Send tip to hosts and users you follow
  • Import Woocommerce products from wordpress website and sync to TokShop, accept orders from both platforms and sync between them
  • Support Multi vendors
  • Vendors sell in the marketplace, accept and manage sales and orders
  • Platform Owner Earns Commission on sales from vendors
  • Vendors can withdraw earnings from TokShop to their bank accounts they have connected.
  • Users have and can manage wallet balances
  • Dark and Light Theme support
  • Multi language support

Requirements

  • Flutter 3.29.1 and Dart 3.7.0Link
  • Firebase Account read more about it here Link, we use firebase to store chats and product images and also to send notifications .
  • Agora - we use agora to create live stream, you can read more about it here Link
  • Stripe - we use stripe to handle payments, you can read more about it here Link

Android Studio Setup

Windows Setup

  • Download Android Studio from the official website:https://developer.android.com/studio/
  • Access the Flutter SDK through:https://flutter.dev/docs/get-started/install
  • For further information on Android Studio, visit:https://developer.android.com/studio/intro/
  • Step 1 : Get the Flutter SDK

  • Please download the provided installation bundle to access the latest stable release of the Flutter SDK.
  • Upon downloading, extract the zip file and place the 'flutter' directory in your chosen installation directory for the Flutter SDK (e.g., C:\src\flutter).
  • Step 2 : Update your path

  • To enable running Flutter commands in the regular Windows console, follow these steps to add Flutter to the PATH environment variable:
  1. Open the Start menu and search for 'env', then select 'Edit environment variables for your account'.
  2. In the User variables section, check if there is an entry named Path.
  3. If the Path entry already exists, append the full path to the flutter\bin directory using ; as a separator from existing values.
  4. If the Path entry doesn’t exist, create a new user variable named Path and set its value to the full path to the flutter\bin directory.
  5. Remember to close and reopen any existing console windows for these changes to take effect.
  6. You are now prepared to run Flutter commands in the Flutter Console!

Step 3 : Run flutter doctor

  • From a console window with the Flutter directory added to the PATH (as described above), execute the following command to check for any platform dependencies that may be required to complete the setup:
flutter doctor
  • If any complications arise during the environment setup, kindly refer to our online resources for guidance. Please click the following link to access:Click Here

macOS​ setup​

  1. Open the terminal.
  2. For updating the PATH variable for the current terminal window only, enter the command:
  3. export PATH="$PATH:`pwd`/flutter/bin"
  4. To update the PATH variable permanently, open or create the .bash_profile file by entering:
  5. sudo open -e $HOME/.bash_profile
  6. Append the following line to the .bash_profile file, placing it at the bottom:
  7. export PATH="$PATH:[PATH_TO_FLUTTER_SDK_DIRECTORY]/flutter/bin"
  8. Replace [PATH_TO_FLUTTER_SDK_DIRECTORY] with the actual path to the Flutter SDK folder.
  9. Refresh the PATH variables by running the command:
  10. source $HOME/.bash_profile
  11. Verify that the SDK is successfully installed by running:
  12. flutter doctor
  • If the check list of Flutter SDK requirements is displayed, the SDK is successfully installed, and you can proceed with building Flutter apps.
  • For troubleshooting during environment setup on macOS, refer to our online resourcesClick Here

    Open App in Android Studio

  • Open Android Studio, at the top right corner, click on the "File" button.
  • Click on "Open", navigate to your project directory, select tokshopapp app directory you got when you dowloaded from codecanyon and open your project.
  • Project Structure
  • Open config.dart file
    • baseUrl: "" -> this is the url you got when you installed admin panel
    • demo: "" -> set it to true if you are not yet ready for production
    • appName: "" -> set it to your app name e.g Tokshop
    • currencySymbol: "" -> set it to your default currency symbol e.g $
    • androidPackageName: "" -> set it to your android package name, you can get it from your project directory -> app -> manifest.xml e.g com.tokshop.com
    • iosAppID: "" -> set it to your ios package name, you can get it from your project directory -> app -> info.plist

Configure Firebase

  1. Open Firebase website here -> https://firebase.google.com/
  2. Sign up if you don't have an account or log in if you already have one
  3. After creating a Firebase project and signing in, Click on the "Add project" button to initiate the creation of a new project.
  4. Enter project name and proceed by clicking next to the next steps.

Add Firebase to Flutter Project under Android Folder

  • In the next step, we have to choose the platform to add Firebase to our application. Click on Android.
  • The platform can be Android, iOS, Web etc..
  • Your package name is generally the applicationId in your build.gradle (app-level) file
  • Refer to thePagefor guidance on utilizing keytool to obtain the SHA-1 hash of your signing certificate.
  • Add your applicationid in the first field and SHA-1 to the third field as shown in the image below.
  • Download the google-services.json file & place it in your project's app root directory.
  • Navigate to your project's app root directory, under android folder there is a folder called app, paste the googlejson file there
  • Back in the Firebase console-setup workflow, click Next to skip the remaining steps and then finish and complete

Step 1 : Enter SHA Key in firebase console

  • Add SHA-1 key in the Firebase project for Google Login to work, refer here Link.
    • Click on Project Overview
    • Click on Project Settings
    • Select Android app , then pase SHA-1 key in the circled area in the image at the bottom

Add IOS App In Firebase

  • we have to choose the platform to add Firebase to our application. Click on iOS.
  • On the next screen, enter your iOS bundle ID & App nickname and click on Register App. You can find your bundle ID in the General tab for your app's primary target in Xcode. If specified, the app nickname will be used throughout the Firebase console to represent this app. Nicknames aren't visible to users.
  • Download the GoogleService-Info.plist file & move the GoogleService-Info.plist file you just downloaded into the root of your Xcode project and add it to all targets.
  • Back in the Firebase console-setup workflow, click Next to skip the remaining steps and then finish and complete

Google Sign In Configuration

  • Navigate to the "Authentication" section and select the "Sign-in method" tab.
  • Click to Enable
  • Select your support email and save
  • Google sign-in method has been successfully enabled.

Create APNs Auth Key For Push Notification

  1. Navigate to https://developer.apple.com/account.
  2. Log in using your Apple developer credentials.
  3. Obtain a provider certificate from your developer account. This can be found in the "Certificates" section, as depicted in the image below.
  4. Select the "Certificate, IDs & Profiles" tab.
  5. Select the "Keys" tab.
  6. Click on the "+" button.
  7. A key can be generated which gives the FCM full access over the Apple Push Notification service (APNs). On the "Keys" menu item, register a new key. The name of the key can be anything, however you must ensure the APNs service is enabled.
  8. Click "Continue" & then "Save". Once saved, you will be presented with a screen displaying the private "Key ID" & the ability to download the key. Copy the ID, and download the file to your local machine.
  9. Copy the Key ID and download the file.
  10. The file & Key ID can now be added to your Firebase Project. On the Firebase Console, navigate to the "Project settings" and select the "Cloud Messaging" tab. Select your iOS application under the "iOS app configuration" heading.s
  11. Upload the downloaded file and enter the Key & Team IDs;

Woocommerce Upload

We assume you already have a woocommerce store, we have a wordpres plugin called WC-Plugin which is part of the source code you get when you downnload our source code from codecanyon

  • Install the plugin in your wordpress ecommerce store
  • navigate to the bottom and you will see a newly added menu called Tokshop

      Add settings

    • Backend URL: the url where your backend is hosted e.g api.tokshoplive.com
    • Account Email: the email you use to login to your tokshop account
    • Click the button Save, this will connect your tokshop account to your woocommerce store
  • Navigate to Export Products tab and click Start Export, all your products will be expported to your tokshop account, all orders done from tokshop will reconcile to your woocommerce store and all orders from your woocommerce store will reconcile to tokshop

Change Package Name

  • Android
    • Navigate to the "android/app" directory and locate the "build.gradle" file.
    • Within this file, update the "applicationId" and its corresponding dependencies as necessary
  • IOS
  • Right-click on the iOS directory, select "Flutter" and then "Open iOS module in Xcode" to proceed further.
  • After successfully opening the project in Xcode, proceed to the following steps:
  1. Navigate to "Runner" > "Signing & Capabilities".
  2. Modify the bundle identifier according to your requirements.
  3. Save the changes, and the process is complete.

Change App Theme Color

  • Go to your project lib > theme_controller.dart as shown in the below image.

Change App Icon

  • To generate icons of various sizes for both iOS and Android platforms,visit
  • Upload the icon image, select the desired options for iPhone and Android compatibility, and click on "Generate". This website will efficiently produce icons in multiple sizes for both platforms simultaneously.
  • After generating the icons, download a ZIP file named "AppIcons", containing folders named "android" and "Assets.xcassets", along with images suitable for the App Store and Google Play Store. These assets can be directly uploaded as icons in both app stores.
  • Please open your project in Android Studio.

  • Android
    • Navigate to the "android/app/src/main/res" directory in your project. Right-click on the "res" folder and select "open in Finder". Once in Finder, delete all the existing mipmap folders. Then, paste the mipmap folders from the AppIcon/android directory that you have downloaded.
  • IOS
    • Navigate to the "ios/Runner directory and locate the ".xcassets" file. Right-click on the "Runner" folder and select "open in Finder". Once in Finder, delete the "Assets.xcassets" folder. Then, paste the "Assets.xcassets" folder from the "AppIcon" directory that you have downloaded.
  • After replacing the images in the Android and iOS folders manually, proceed to "lib/main.dart" and run the Flutter project using the following command in the Flutter console.
  • flutter run

Change App Name

  • Andriod
    • Navigate to "android/app/src/main/AndroidManifest.xml" and make the changes as depicted in the provided image.
  • IOS
    • Please right-click on the "iOS" directory, then navigate to "Runner", and select "info.plist". Finally, open the iOS module in Xcode.

Build Debug APK

  • To generate APK (Application Package File) for distribution and installation on Android devices, Flutter provides a straightforward method using the "flutter build apk" command. Below, we outline the steps involved in building APK files for Android using Flutter.
  1. Navigate to your project location.
  2. Access the build options by following this path: "Build" > "Flutter" > "Build APK".

    Release APK

  • Execute the following command: "flutter build apk --release", as demonstrated in the image below.
  • flutter build apk --release
  • Once the APK has been successfully generated, it will be automatically saved to the specified destination, as illustrated in the image below.
  • logo

Contact us

Email : reggycodas@gmail.com

Whatsapp : +254791334234

>
1107 x 823 | lg