Mighty Explore Places

Documentation Version 1.0


Introduction


First of all, Thank you so much for purchasing this application and for being our loyal customer.

This documentation is to help you regarding set up.

Requirement

This project have required following depandency

Flutter/iOS Requirements

  1. Android Studio: Giraffe | 2022.3.1
  2. Flutter: 3.13.x

File Structure

Here is the general File structure of the template:

  • app
  • lang
  • lib
    • models
    • network
    • screens
    • store
    • utils
      • Colors.dart
      • Common.dart
      • Constant.dart
  • pubspec.yaml

Android Configuration

Change Application Name

Open /android/app/src/main/AndroidManifest.xml and specify your application name.

change_app_label

Change Application Icon

    1. Open Android studio. Select File -> open -> select root folder -> android
    2. Wait for indexing
    3. Right click on res -> New -> Image asset
    4. Now the following window will open once we click on Image Asset:
    5. set_app_ico

      Please don't change the icon name.
    6. Once all the required changes are made, Click on the Next button and then on Finish and then the icon of the app will be changed!
    7. app_logo_dir

Change Application ID

    1. Open Android studio. Select File -> open -> select root folder -> android
    2. Wait for indexing
    3. Open /android/app/build.gradle file and change YOUR_APP_ID
    4. after making changes sync your Project
    5. change_app_id

Setup Firebase

    1. For Firebase setup, you just need to change the android/app/google-services.json file.
    2. Create a new firebase account and create Firebase Project. Refer Create Firebase Project
    3. Register your application with your package name.Refer Add Android App
    4. Now download the google-services.json file and replace with current.
    5. Refer to Link
    6. update_google_json

Setup AdMob

    1. For AdMob setup, you just need to change the app id in android/app/src/main/AndroidManifest.xml file
    2. For that, you have to create a firebase account and create a new application in AdMob. and then you will get application id. Refer Create Admob Account
    3. Now, replace value with your new generated application id.

      change_admob
    4. Now run the application. your ads are now live.

Setup GoogleMap

    1. Go to your Android Folder -> app -> src -> main -> AndroidManifest file Add Google Map Key. To Create Google Map key refer Integrate GoogleMap
    2. logo

Generate Signed APK && AAB

  1. Go to your project -> Tools -> Flutter -> Open for Editing in Android Studio as shown below
  2. logo
  3. Open Project in New Window
  4. Wait for while until project synchronization. After that Go to Build -> GenerateSigned Bundle/APK...
  5. logo
  6. Select Android App Bundle or APK Option as per your need. (Android App Bundle is best solution) and click Next button.
  7. logo
  8. Select Create new.. option to generate new Signed key (When you release your app First Time) and Fill all options. Refer this link
  9. logo

  10. Click Next button and you will get following screen...
  11. logo

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

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

  1. Open android studio in your project.
  2. Open terminal in android studio.
  3. flutter pub get
  4. Open terminal cd ios.
  5. pod install.
  6. run project in xcode.

Open Project in Xcode

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

Change Bundle Name

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

logo

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.

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

logo

Change App Icons

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

How to create firebase on iOS

  1. Go to your project you downloaded and navigate to project folder
  2. Find folder iOS and go inside
  3. Find folder Runner and go inside
  4. Replace the GoogleService-Info.plist file with the one you just downloaded. To add iOS app in firebase referAdd iOS App
  5. logo

Google Map iOS

  1. Open "AppDelegate.swift" file and add your api key
logo

Change Admob App Id

  1. Open Xcode,Select the Info.plist from the file Manager.
  2. Change the GADApplicationIdentifier value.
  3.                                                 <key>GADApplicationIdentifier</key>
                                                    <string>Add your Admob appId</string>
                                                

Web Configuration

Change Title

Open /web/index.html and change title.

logo

Change Icon

Open /web/ and replace favicon.png.

logo

Firebase Web

  • To Add Web app in Firebase refer Add Web App
  • Open /web/index.html and replace firebase config code.

    logo

  • Open /lib/main.dart and replace firebase config code.

    logo

Firebase Cloud Messaging setup

Open /web/firebase-messaging-sw.js and replace Firebase Config code.

logo

How to deploy Firebase web app


Flutter Configuration

  • How to get Storage Bucket
  • logo

  • How to get server Key
  • logo

    Flutter configuration in App

    • Change Primary Color
    • In main directory goto the lib -> utils -> AppColor.dart files and change it.

      logo

    • Change App Constants
    • In main directory goto the lib -> utils -> AppConstants.dart files and change it.

      logo

    Flutter Configuration in Web

    • Change Primary Color
    • In main directory goto the lib -> utils -> AppColor.dart files and change it.

      logo

    • Change App Constants
    • In main directory goto the lib -> utils -> AppConstants.dart files and change it.

      logo

    How to configure firebase

    Create Firebase Project

    • Create new project to your firebase console
    • logo

      logo

      logo

    Add Web app

    • Add Web application to your firebase project
    • logo

    • Add App nickname and click on Register app button
    • logo

    • You have connected web application to your firebase project successfully
    • Now copy the firebase config code and replace with current also replace in main.dart file
    • logo

      logo

      logo

    Add Android App

    • Add andorid application to your firebase project
    • logo

    • Add package name and sha-1 key (sha-1 optional for now)
    • logo

      logo

      logo

    • You have connected andorid application to your firebase project successfully
    • Now download the google-services.json file and replace with current.
    • update_google_json

    Add iOS app

    • Add iOS application to your firebase project
    • logo

    • Get your bundle id from \ios\Runner.xcodeproj\project.pbxproj file or search for PRODUCT_BUNDLE_IDENTIFIER and you will get following result
    • logo

    • Enter your iOS bundle id
    • logo

      logo

      logo

    • You have connected iOS application to your firebase project successfully
    • Now download the GoogleService-Info.plist file and replace with current.
    • update_google_json

      Create Firestore Database

      • Go to Firestore Database -> click on create database
      • logo

      • Select Start in test mode and click on Next button.
      • logo

      • Click on Enable button and create your collection
      • logo

      How to Create Indexes

        Step 1 : Navigate to the Firebase Console and then to Indexes.

        Step 2 : This type of error will appear when you run the project.

        logo

        Step 3 : Copy and paste this link into your browser to get this type of dialogue, then click on Create Indexes.

        logo
        • Be patient, the indexes will take some time to build.
        logo

        Step 4 : Create all indexes in this manner.

        • Total 15 Indexes will be created.

        Create Indexes mannually

        Step 1 : Click on the Add Index button, and then enter the collection id.

        logo

        Step 2 : Create all of the indexes listed below and wait for them to be built.

        logo

        logo

    Enable SignIn Methods

    • In Firebase console, open the Authentication section.
    • On the Sign-in Method tab, enable the Google Sign and Phone method and click save.

    • logo
    • Go to Project setting and Add your debug and release SHA1 Key. Refer link
    • logo

    How to make Admin.

    Step 1 : Register yourself using your email address and a password from the user app.

    Step 2 : After successfully creating the user, navigate to the firebase console and locate your document in the user collection. Change the value of isAdmin to true in that document.

    If you want to create a user for testing purposes, set the isDemoAdmin property to true in that user document.

    logo

    Step 3 : Now, open the admin panel and sign in with your admin credentials.


    OneSignal Configuration

    • Create onesignal project in your account and click setup platform redirect in settings->platforms-> Choose android platform
    • logo
    • After choose platform -> android configration, Generate json file and follow below link for how to generate JSON file
    • Click here

      logo
    • Choose Target SDK as Flutter and click Save & Continue
    • logo
    • Now copy App ID as shown below and click on Save & Continue to complete your setup
    • logo
    • In main directory goto the lib -> utils -> app_config.dart file and repalce the one signal at line number 21.
    • logo
    • Go to Setting -> Keys & IDs in OneSignal project and copy 'Rest API Key'
    • logo
    • You have connected android application to your Onesignal account successfully
    • How to change OneSignal Logo

      1. You can genrate and download your onesignal logo to Click here
      2. Add Downloaded that folder. Afte that open your project and replace the folder. Go to android -> app -> src -> main -> res folder

    How to integrate googlemap Key

    To generate google map key refer this Google Map Key Documentation

    How to create admob account

    • In the Admob console, click add android app from the Apps menu.
    • AD1
    • Enter your app name and Enabling user metrics is not necessary to complete this codelab. However, we recommend that you do because it allows you to understand user behavior in more detail and click on ADD APP button.
    • AD2
    • Create ad units.
    • AD3
    • Select Banner unit ad and enter banner unit ad name then click on Create ad Unit button. Same procedure follow to create Interstitial ad)
    • AD4
    • Then add another unit add shown in below image and Same as above create Interstitial ads and native ads.
    • AD5
    • Same as Add iOS app and same as add units in iOS app.
    • Add your ad unit id same way explain in previous step.

    Common error

    Flutter SDK Not Available

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

    There are different sources you can try

    1. You can clone it from the Github Repository
    2. Download SDK zip file + extract it after downloading
    3. You can also Download any version(including older) from here (For Mac, Windows, Linux)
    Use the SDK path in your future projects
    logo

    Update the existing code with new release


    Special Notes

    As per envato policy installation, setup and configurations or modification are not included in free support. Free support is only for any bug/ error in original code. we do not provide installation and customization support in FREE SUPPORT.
    Still, We are providing steps for How to update future release code to existing source code for your knowledge purpose.

    PLEASE DO NOT CREATE TICKETS IF YOU FACE ANY ISSUE DURING UPDATE YOUR CODE. WE WILL NOT PROVIDE ANY SUPPORT ON THAT.


    How to update future release code to existing source code

    If you want which file changes are on the latest updated version then you have to manage the git repository by yourself.

    For First time: Initial project downloaded from codecanyon server.

    Step 1: Create or login with gitlab

    Login or register your account with gitlab: https://gitlab.com/users/sign_in

    Step 2: Create a new project in GitLab
    • In your dashboard, click the green New project button or use the plus icon in the navigation bar. This opens the New project page.
    • On the New project page -> Create a blank project.

    • logo
      logo
    Step 3: Clone your project to your local system
    • 1. Once project is created on your gitlab server. You have to clone the project to your local system. You can clone it with the command line.
    • 2. git clone “repository path”
    • 3. Copy your project url and clone into your exiting system

    • logo
      logo
    • 4. Once successfully clone then system will create a folder on your system

    • logo
    Step 4: Download project from codecanyon server Step 5: Copy/paste your initial downloaded project to clone directories.

    Once successfully downloaded project from codecanyon, copy/paste your downloaded project into clone directories

    • Note
    • Only orignal source code is put here.
    logo
    Step 6: Commit and push to gitlab server

    Onces copy/paste your changes to clone directres, you have to push all files to your gitlab server. For that use the following commands.

    Before commit to server directores, you have to remove below folder from your project

    • 1. build
    • 2. .idea
    • 3. .gradle

    After That follow below steps

    • 1. Goto inside your clone directory project
    • logo
    • 2. Add your all files with “git add .” command
    • 3. Now commit your changes with below command
    • 4. git commit -m ‘initial commit’
      • Note
      • Write your latest version message instead of “initial commit”.
      logo
    • 5. Push your changes to server with below command
    • “git push” And provide you gitlab credential details

      logo
    • 6. Check your all changes to gitlab server
    logo

    For Update existing code (If Already have old version of project)

    Note

    If you remove the project from the local system then clone the project again from your gitlab server. Follow the same above Step 3: Clone your project to your local system

    Step 1: Download the latest version from codecanyon server.

    Once you will received mail for updates. Just download latest code from codecanyon server.

    Step 2: Copy/paste your initial downloaded project to clone directories.

    Once successfully downloaded project from codecanyon, copy/paste your downloaded project into clone directories

    Note

    Only orignal source code is put here.

    Step 3: Commit and push to gitlab server

    Follow same Step 6: Commit and push to gitlab server

    Step 4: Check updated files

    After committing your latest changes. Goto the gitlab project dashboard and click on the commit link.

    logo

    Click on link which you have commit message on above steps 3

    logo

    Now check the all changed file.

    logo

    Click on “XYZ changed file” to see which file has been changed.

    logo

    Change Log

    Version 8.0 – 11 nov 2024

    • Update in 3.24 and all package upgrades.
    • Facebook-ad code temporarily commented after 3.24 update.
    • UI bug in checkbox fixed.
    • SHA key added in Firebase for Google Sign-In.

    Version 7.0 – 16 Sept 2024

    • Migrate to all library to Flutter latest SDK 3.22.3
    • Trip planning feature with Gemini
    • Place Request feature
    • Assistant history feature

    Version 6.0 - 7 March 2024

  • Migrate to Flutter's latest version 3.19.x
  • Version 5.0 – 17 Nov 2023

    • Update all libraries to the latest flutter sdk 3.13.9
    • Migrate to all library to Flutter latest SDK 3.13.x
    • Migrate to OneSignal 5.0.x

    Version 4.0 – 27 Mar 2023

    • Latest Dependency Upgraded

    Version 3.0 – 17 Nov 2022

    • PlaceFinder by Category and Distance
    • More Places Details added
    • Show Distance in Place
    • Latest Dependency Upgraded
    • Bug fixed

    Version 2.0 – 8 oct 2022

    • Categories Tab added in bottom Navigation
    • Bug Fixed

    Version 1.0 – 28 sep 2022

    • Initial Release

    Meet Mighty 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.

    Submit support ticket: https://support.meetmighty.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!

    If you need assistance and information on purchased product that is not covered in documentation, post them on our support portal at https://support.meetmighty.com/ You can expect answer within 24-48 hours, usually as soon as possible in the order they were received.

    Additionally, if any support ticket has no response from the item owner for more than 7 days, that support ticket will be closed by default. However, if you need further assistance, you can create a new ticket.

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

    Do you have any pre-sales questions or concerns, please write to us via our website contact page or email us at [email protected]. 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