Zyntra - DOCUMENTATIONS

Introduction to Zyntra

Zyntra - In today’s fast-paced world, convenience is everything—and our app is built to deliver just that. Whether you need to send a package across town, pick up essentials from a nearby store, or plan future purchases, our platform is your go-to solution. We bring together delivery, shopping assistance, and wishlist planning—all in one easy-to-use app. No more juggling multiple services or stepping out for small errands.

With real-time updates, live item confirmations, and secure payment features, you stay in full control of every request. From hardware to stationery, groceries to gifts, you simply select a store, enter your list, and relax while we do the legwork. It’s the smart, flexible way to manage your day-to-day needs—efficient, personalized, and right at your fingertips.

It comes with 10000+ hours save time for custome app development. It works great with both android and iOS.

The same code is used for iOS and Android

Prerequisite

Android Studio: Koala 2024.1.2

Flutter: 3.32.0

Dart version: 3.6.0

Introduction to Flutter

Flutter is Google’s UI toolkit for building beautiful, natively compiled applications for mobile, web, and desktop from a single codebase. It is very easy to learn and currently it is getting more and more popular. With this blog post, you will learn some basic stuff about Flutter and after reading it, you will be able to create a simple application using this technology.

Click here to check out more details about flutter.

Tools & Setup

Prerequisite

Flutter & Dart SDK
Anyone IDE Android Studio (Recommended), Visual Studio Code or IntelliJ IDEA

To edit this project you must have Flutter and Dart installed and configured successfully on your computer.
Set up your editor - Install the Flutter and Dart plugins.
If you have got Android SDK installed and configured, to install Flutter you only need to:
- Download Flutter SDK from official website and extract it.
- Add path to previously extracted SDK to your PATH variable
- Run flutter doctor tool to check if everything is configured correctly.
- All above steps are mentioned here: https://flutter.dev/docs/get-started/install/

Android Studio – Windows

Download Android Studio - https://developer.android.com/studio/
Get the Flutter SDK - https://flutter.dev/docs/get-started/install
Learn more about Android Studio - https://developer.android.com/studio/intro/

Step 1 : Get the Flutter SDK

1 Download the following installation bundle to get the latest stable release of the Flutter SDK:

2 Extract the zip file and place the contained flutter in the desired installation location for the Flutter SDK (for example, C:\src\flutter; do not install Flutter in a directory like C:\Program Files\ that requires elevated privileges).

Step 2 : Update your path

If you wish to run Flutter commands in the regular Windows console, take these steps to add Flutter to the PATH environment variable: From the Start search bar, enter ‘env’ and select Edit environment variables for your account. Under User variables check if there is an entry called Path:

If the entry exists, append the full path to flutter\bin using ; as a separator from existing values.
If the entry doesn’t exist, create a new user variable named Path with the full path to flutter\bin as its value.

Info
Note that you have to close and reopen any existing console windows for these changes to take effect.

You are now ready to run Flutter commands in the Flutter Console!

Step 3 : Run flutter doctor

From a console window that has the Flutter directory in the path (see above), run the following command to see if there are any platform dependencies you need to complete the setup:

c:\src\flutter>flutter doctor

If you find any issue during environment setup, please go online Click here

Android Studio – macOS

Download Android Studio - https://developer.android.com/studio/
Download Xcode - https://apps.apple.com/us/app/xcode/id497799835?mt=12
Get the Flutter SDK - https://flutter.dev/docs/get-started/install
Learn more about Android Studio - https://developer.android.com/studio/intro/

Step 1 : Get the Flutter SDK

Download the following installation bundle to get the latest stable release of the Flutter SDK:
Download SDK and extract downloaded file, just double click on that. and just copy extracted folder and paste it to your desired location (for example, Documents\flutter).

Step 2 : Update your path

Warning
Path variable needs to be updated to access “flutter” command from terminal. you can just update path variable for current terminal window only. and if you want to access flutter commands from anywhere in terminal, we need to update SDK path permanently.

To update PATH variable, we need to open terminal.

To update PATH variable for current terminal window only, then enter this command "export PATH="$PATH:`pwd`/flutter/bin"" and hit enter key.

To update PATH variable permanently, then Open or create .bash_profile file. to open or create that file, then enter "sudo open -e $HOME/.bash_profile" and hit enter key.

Append below line to bash_profile file at bottom of all other content. "export PATH="$PATH:[PATH_TO_FLUTTER_GIT_DIRECTORY]/flutter/bin"" as [PATH_TO_FLUTTER_GIT_DIRECTORY] is actual path of SDK folder.

Run this command on terminal "source $HOME/.bash_profile" to refresh PATH variables.

Then check whether our SDK is successfully installed or not.

You are now ready to run Flutter commands in the Flutter Console!

Run "flutter doctor" into terminal, If you are getting check list of flutter sdk requirements, it means SDK is successfully installed on your machine. and you can start building flutter apps on your machine.

If you find any issue during environment setup in macos, please go online Click here

Android Studio – Linux

Download Android Studio - https://developer.android.com/studio
Get the Flutter SDK - https://flutter.dev/docs/get-started/install/linux
Learn more about Android Studio - https://developer.android.com/studio/intro/

Step 1 : Get the Flutter SDK

Download the following installation bundle to get the latest stable release of the Flutter SDK:
Download SDK and extract downloaded file, just double click on that. and just copy extracted folder and paste it to your desired location (for example, Documents\flutter).

Step 2 : Update your path

Warning
Path variable needs to be updated to access “flutter” command from terminal. you can just update path variable for current terminal window only. and if you want to access flutter commands from anywhere in terminal, we need to update SDK path permanently.

You’ll probably want to update this variable permanently, so you can run flutter commands in any terminal session. To update PATH variable, we need to open terminal.

export PATH="$PATH:[PATH_TO_FLUTTER_GIT_DIRECTORY]/flutter/bin"

Run source $HOME/. to refresh the current window, or open a new terminal window to automatically source the file.
Verify that the flutter/bin directory is now in your PATH by running:

echo $PATH

Verify that the flutter command is available by running:

which flutter

You are now ready to run Flutter commands in the Flutter Console!

Getting Started (Build & Run)

Important

All below steps are must be followed to build and run application

Download Project

Download and find the your project folder, use your preferred IDE (Android Studio / Visual Studio Code / IntelliJ IDEA) to run the project.

Get Dependencies

After you loaded project successfully, run the following command in the terminal to install all the dependencies listed in the pubspec.yaml file in the project's root directory or just click on Pub get in pubspec.yaml file if you don't want to use command.

 flutter pub get

Important

All below steps are must be followed to build and run application

Build and Run App

Locate the main Android Studio toolbar.
In the target selector, select an Android device for running the app. If none are listed as available, select Tools > Android > AVD Manager and create one there. For details, see Managing AVDs.
Click the run icon in the toolbar, or invoke the menu item Run > Run.

After the app build completes, you’ll see the app on your device.

If you don’t use Android Studio or IntelliJ you can use the command line to run your application using the following command

Important

Below step requires flutter path to be set in your Environment variables. See https://flutter.dev/docs/get-started/install/windows

flutter run

You will see below like screen after you have build your app successfully

Try hot reload

Flutter offers a fast development cycle with Stateful Hot Reload, the ability to reload the code of a live running app without restarting or losing app state. Make a change to app source, tell your IDE or command-line tool that you want to hot reload, and see the change in your simulator, emulator, or device.

Important

Do not stop your app. let your app run.

Configuration & Customization

Android Configuration

Important
Don't open/change android code inside flutter because flutter doesn't compile android files.
If you want add/change android code, click on
Tools->Flutter->Open Project in Android Studio Or File->Open ->open project module inside your project

Important
Don't forget to change package name inside android/app/src/main/AndroidManifest.xml file

Open Android Studio.
Select Open an existing Android Studio Project.
Open the android directory within your app.
Wait until the project has been synced successfully. (This happens automatically once you open the project, but if it doesn’t, select Sync Project with Gradle Files from the File menu).
Now, click on Run button.

Change Application Name

You must want to change your application name. This is how you can do. Follow the below step.
Open /android/app/src/main/AndroidManifest.xml and specify your application name.


<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example">
                    
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
                    
<application
    android:name="io.flutter.app.FlutterApplication"
    android:label="YOUR_APPLICATION_NAME"
    android:icon="@mipmap/ic_launcher">
<activity>

Change Application Icon

See How to generate an application icon?

Browse your image and click on Download icon. After successfully generated, replace all icons in respective folders:

/mipmap-hdpi in /android/app/src/main/res/ folder
/mipmap-mdpi in /android/app/src/main/res/ folder
/mipmap-xhdpi in /android/app/src/main/res/ folderr
/mipmap-xxhdpi in /android/app/src/main/res/ folder
/mipmap-xxxhdpi in /android/app/src/main/res/ folder

Warning
Application icon name must be ic_launcher

Change Application ID

Follow the below steps to change you Application ID.
Open /android/app/build.gradle


defaultConfig {
   applicationId "YOUR_APPLICATION_ID"
   minSdkVersion 21
   targetSdkVersion 31
   versionCode 1
   versionName "1.0.0"
   testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
}

Generate Signed APK

Go to in your project & then Tools -> Flutter -> Open for Editing in Android Studio as shown below

If your 1st step option is not available then select File -> open -> Select main folder -> android.
Open Project it in New Window
Wait for while until project synchronization. After that Go to Build -> GenerateSigned Bundle/APK...

Select Android App Bundle or APK Option as per your need. (Android App Bundle is best solution) and click Next button.

Select Create new.. option to generate new Signed key (When you release your app First Time) and Fill all options. Refer this link

Click Next button and you will get following screen...

Select Build variants - release and Signature versions both V1 and V2 respectively as shown above screen shot and click Finish button.

Wait for a while until Gradle Build Running process complete.and finally you will get the Generate Signed APK : (APKs) generated successfully . from that click on Locate option to get Location of your Generate Signed APK Key.

iOS Configuration

Open Project in Android Studio

Open android studio in your project.
Open terminal in android studio.
Pub get.
Open terminal cd ios.
pod install.
run project in xcode.

Open Project in Xcode

Open Xcode.
Select Open another Project.
Open the iOS directory within your app.
Now, click on Done button.

Change Bundle Name

Select your project file icon in Group and files panel.
Then Select Target -> Info Tab.
At last change Bundle Name.

Change Bundle Identifier.

Bundle Id is a unique Identifier of your of app on iOS and MacOS. iOS and MacOS use it to recognise updates to your app. The identifier must be unique for your app.

Select your project file icon in Group and files panel.
Select General Tab.
After Select General tab you can see the details of your application.
In Identity section, rename your Bundle identifier.

Change App Icons

see How to Generate App Icons?
In Group and files panel find “Assets.xcassets” folder.
In Assets.xcassets folder replace AppIcon.

Flutter Configuration

Manually Change App Name

In main directory Go to app -> src -> main -> AndroidManifest.xml

Change YOUR_APP_NAME to your app name

Androi:label=""

PHP Setup

Requirements

Important
Required Admin Panel
Required Subdomain configuration for the setup panel

PHP >= 8.0
MySQL >= 5.6
Apache HTTP server
OpenSSL PHP Extension
Enable Output_buffering in Php.ini File

Installation Instructions

Make Sub domain
subdomain.yourdomain.com
Unzip the Zyntra Admin Panel 1.0.zip file and ONLY use the extracted /root folder and upload in below directory based on your server
In Linux
Path: var/www/html/
In cPanel:
Inside File manager -> Path: public_html/
Create the database on your server
Import Zyntra 1.0.sql file in created database. ( Note : Only necessary for those client, who is setup project first time. )

Already imported Zyntra 1.0.sql

Admin Default credentials


Email    : admin
Password : admin@123

1. Change Database settings

For database settings, open the inc/config.php file with a text editor and set your database settings.

Enter database name, database username, database password and the host details

1. Quick Start Admin Menu Guide

Flexible Pickup & Drop: Send or receive anything from one location to another—keys, parcels, or documents—delivered safely to your chosen address.
Shop from Any Local Store: Buy from your favorite neighborhood store, even if they’re not online. Choose a store, add your items, and we’ll do the shopping for you.
Real-Time Product Confirmation: Get live pictures of the items found in-store and approve or reject them before purchase.
Pay Only After Approval: Finalize your payment only after you’ve reviewed and confirmed your selected items.
Live Order Tracking: Watch your delivery partner's real-time location from pickup to drop-off directly within the app.
Custom Wishlist: Save items you wish to purchase later or keep track of out-of-stock products for future orders.
Distance-Based Delivery Charges: Know your delivery fee upfront, based on the exact distance between the store and your location.
Easy Address Management: Add and manage multiple delivery locations like home, office, or other saved addresses with ease.
Secure Payments & Order History: Enjoy encrypted payment options and access all your past orders in one place for convenience.

Base URL Configuration

Important
Please do not change anything in the flutter code. If you use PHP backend you only need to set the base URL otherwise set only the puchase code.

With PHP Backend

Change Base URL & Onesignal App ID For App

In Main directory goto the lib->api folder and open config.dart file and change your BASE_URL value.

static const String imageURLPath="ADD YOUR BASE URL";

How to get Base URL

Open your Admin login page and copy the URL.

How to set Onesignal App ID

Firebase Configuration

Create a Firebase project

Before you can add Firebase to your Flutter app, you need to create a Firebase project to connect to your app. Visit Understand Firebase Projects to learn more about Firebase projects.

Warning
If you're releasing your Flutter app on both iOS and Android, register both the iOS and Android versions of your app with the same Firebase project.

Visit for more information on how to setup for Android

Visit for more information on how to setup for iOS

Register your app with Firebase

In the center of the Firebase console's project overview page, click the Android icon to launch the setup workflow.
Enter your app's package name in the Android package name field.

Warning
Make sure that you enter the ID that your app is actually using. You cannot add or modify this value after you register your app with your Firebase project. Both applicationId should be matched.

Click Register app.

If you haven’t Firebase Project Account ? Click here for create projet https://console.firebase.google.com/

Android :

Select an Android app in the firebase console.

Write project package name and SHA-1 Key.

Download google-service.json file and keep in project root directory

Example Zyntra(Project Name) -> android -> app
Replace the file in "android/app"

iOS:

Create an IOS or Android click on Add app

Select an iOS app in the firebase console.

Write bundlid and APPID

Download the Googleservice-info.plist file

Replace the file in "ios/Runner/info.plist"
Update "FirebaseApp.Configure()" in AppDelegate File

Firebase Rules:

For save data in Firebase storage and upload file,images,videos etc need to give permission

On left hand side panel,go to build, select Firestore database.
Click on Create Database.
Then select mode wheather for live or debug mode need to use
Now click Rules tab
Change condition by true
After doing true click on publish button so that you can access database.

Firebase Collection:

As you have know there are multiple collection has been used in firebase. Let's see what is the use of the collection and how it added
Note: If any error occur regarding QuerySnapshot then check in firebase if missing any below Required config is missing if not then check there field and datatype and key word same to same as given in document

NOTE :
In above collection list [Auto generate] means this collections are generate in firebase whenever any first user enter any data . For other collections need to add manually in firebase. See the below 2 options for add collection data in firebase.

Firebase Cloud Messaging API (HTTP v1)

1. Create A Firebase Project
2. Now go to your Firebase project, On left hand side panel click on setting icon. On click Setting button pop open open. In that click on Project Settings
3. On the subsequent page, click Enable. You may need to wait a few minutes for the action to propagate to Firebase systems.
4. Generate a Private Key JSON file
In Project settings, go to the Service accounts tab.
Click Generate new private key at the bottom of the page.
5. You'll then see a warning window. Click Generate key.
Save the JSON file somewhere secure. You will need to access it shortly.
6. Please fill in all the details you received from the google-service.json file.

Firebase Cloud Messaging API (HTTP v1)

1. Create A Firebase Project
2. Now go to your Firebase project, On left hand side panel click on setting icon. On click Setting button pop open open. In that click on Project Settings
3. On the subsequent page, click Enable. You may need to wait a few minutes for the action to propagate to Firebase systems.
4. Generate a Private Key JSON file
In Project settings, go to the Service accounts tab.
Click Generate new private key at the bottom of the page.
5. You'll then see a warning window. Click Generate key.
Save the JSON file somewhere secure. You will need to access it shortly.

Twillo Configuration

Follow this link https://help.twilio.com/articles/14726256820123

NOTE :
Open Admin -> Goto Setting page -> Scroll Down and Add key

MSG91 Configuration

Follow this link https://msg91.com/help/where-can-i-find-my-authentication-key

Follow this link https://msg91.com/help/where-to-find-my-flow-id

NOTE :
Open Admin -> Goto Setting page -> Scroll Down and Add key

Add Google Map API Key

1. You need to generate the google API key. Visit this link - https://developers.google.com/maps/documentation/embed/get-api-key
2. You need to enabled mentione APIs: Direction API, Distance Matrix API, Geocoding API, Maps SDK for Android, Maps SDK for iOS, Place API.
3. You have to enable billing account. Visit this url for activating: https://support.google.com/googleapi/answer/6158867?hl=en
4. After generating API key, you have to put it on 3 different place for Android, iOS and web.

NOTE :
Android: App -> lib -> Api -> config.dart
Android: App -> src -> main -> AndroidManifest.xml -> android:name="com.google.android.geo.API_KEY" android:value=“YOUR_MAP_API_KEY_HERE”/>
iOS: /iOS/Runner/AppDelegate.swift Add it after Bool { iOS: GMSServices.provideAPIKey("YOUR KEY HERE")

OneSignal Configuration

Create a OneSignal Account and Make 1 different projects inside for other apps must be create seprate project

One Signal is used for send the push notification into mobile or web. for more detail about OneSignal Documentation.

if you have own OneSignal then login and create project. if you does not then register account and create project

Follow below steps

Click in to New App/Website button.
Enter the App/website name in AppName Field.
Select one platform configure, for Example(iOS,Android,Web push).
After Select Any One platform to configure. we can get Firebase Server Key and Firebase Sender Id. If you can select iOS platform then you can required the production Push Certificate.(.p12 Certificate) and then get Firebase server Key. Then Click on Save Button.
After get Firebase Server key and Sender ID. Goto the firebase app and in left side you see Project overview and settings click on it and select Project Settings. and In Setting. select Cloud messaging. and Enter Server Key and Sender ID and at the end Click into Save Button.

Step 1: Create onesignal project in your account Choose android platform

Step 2: Click on Service Account JSON > Choose file and select the JSON file you downloaded from your service account. (Firebase Cloud Messaging API (HTTP v1) Step 4)

Step 3: Choose Target SDK as Flutter

Step 4: Now copy App ID as shown below

Step 5: Paste this App ID here

OneSignal.initalize("********************");

Step 6: If you didn't have copy app id before then you can get Onesignal App ID from this settings here and paste it to admin setting tab

Step 7: Onesignal App ID & Rest Api Key paste it to admin setting tab
Note: Create the separate project for Firebase & Onesignal for following all the stpes

v1.0(24 July 2024)

Check Here

No matching client found for package name

The error is "package_name" in google-services.json is not matching with your "applicationId" in app gradle.
Just make sure the package_name and applicationId both are same.

Flutter SDK Not Available

Download the SDK and point the SDK folder path in your future projects.

There are different sources you can try

You can clone it from the Github Repository
Download SDK zip file + extract it after downloading

You can also Download any version(including older) from here (For Mac, Windows, Linux)

Authorization header not found

Message: Authorization header not found

Note: If you faced this error during development then this error due to header not set on your admin panel

Solution: Just check Enable JWT Authentication section wordpress document to resolve this issue

Expired token

Message: Expired token

This error occurs due to the Expired user token.

Solution: Logout and re-login to your flutter app

Unsupported gradle version 7..

Message: Unsupported gradle version 7..

Solution:

1. Open project_root_directory/android in Android Studio

2. Wait for indexing

3. Now run your application from android module

Help & Support

We like to hear you out when you get stuck or encounter difficulty with our products. As soon as you buy one of our products – you can open a support ticket and share your concern right away. Microsoft Teams CSCODETECH or email: cscodetechuser@gmail.com

Support Policy:

It is recommended that before submitting a ticket you take a close look at product documentation (Docs folder in the archive you have downloaded from Themeforest/Codecanyon). To get technical support and assistance, you need to have a valid purchase code. You will find this when you SignIn your Codecanyon/Themeforest “Download” page. Click on the product’s download link.

Please Note:

Free support policy includes troubleshooting, technical assistance with the product only. It does not include any customization, additional features integration or concerns about third-party plugins compatibility. But, support is applied to plugin(s) we have developed and integrated ourselves. We appreciate your understanding!

You can expect answer within 24-48 hours, usually as soon as possible in the order they were received.

All support requests are being processed on business days (Monday to Friday) from 10:00 to 18:00 (IST +05.30). We are in IST +5:30 time zone. We address all the support queries 5 days weekly on the first-come, first-solve basis (Saturday, Sundays off).

We like getting positive feedback from our customers, and this is why we do our best to earn it! Write a review: https://codecanyon.net/downloads

Change Log

Version 1.0 - 28 May 2025

Initial Release

Thank you for purchasing our application

Thank you for purchasing our application! We're glad that you found what you were looking for. It is our goal that you are always happy with what you bought from us, so please let us know if your buying experience was anything short of excellent. We look forward to seeing you again.

Introduction to Zyntra

Prerequisite

Introduction to Flutter

Tools & Setup

Android Studio – Windows​

Android Studio – macOS​

Android Studio – Linux​​

Getting Started (Build & Run)

Configuration & Customization

Android Configuration

iOS Configuration

Flutter Configuration

Manually Change App Name

PHP Setup

Requirements

Installation Instructions

Already imported Zyntra 1.0.sql

Admin Default credentials

1. Change Database settings

1. Quick Start Admin Menu Guide

Base URL Configuration

With PHP Backend

Change Base URL & Onesignal App ID For App

How to get Base URL

How to set Onesignal App ID

Firebase Configuration

Android :

iOS:

Firebase Rules:

Firebase Collection:

Firebase Cloud Messaging API (HTTP v1)

Firebase Cloud Messaging API (HTTP v1)

Twillo Configuration

MSG91 Configuration

Add Google Map API Key

OneSignal Configuration

v1.0(24 July 2024)

No matching client found for package name

Flutter SDK Not Available

Authorization header not found

Expired token

Message: Expired token

Solution: Logout and re-login to your flutter app

Unsupported gradle version 7.*.*

Message: Unsupported gradle version 7.*.*

Solution:

Help & Support

Please Note:

Change Log

Thank you for purchasing our application

Android Studio – Windows

Android Studio – macOS

Android Studio – Linux

Unsupported gradle version 7..

Message: Unsupported gradle version 7..