Introduction

Cut.FX app is very efficient platform to book appointments and manage appointments for salons. It offers many advanced features and functions like Multiple payment gateways, Multiple languages, Chat with salons, Push notifications, Advanced appointment management system, QR codes for appointment and lot more.

System Required

Gmail Account credentials for Firebase
Apple developer account credentials : Create Account
Android Studio : Download
Flutter Sdk : Download
Branch.io Account : Create Account
Xcode (Only Mac Users).

Things to do before you continue

Setup Backend
Once you follow above documentation, you will find some credentials like Base url, Admin panel link and password etc. collect them as you will require them as we continue.

Setup Flutter SDK

Skip this step, If you have already setup Flutter SDK.

For Mac :

Install the android studio
Download Android Studio

Launch the Android Studio DMG file.
Drag and drop Android Studio into the Applications folder, then launch Android Studio.

Install the Flutter SDK

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

Extract the file into the directory you want to store the Flutter SDK.

unzip ~/Downloads/flutter_macos_arm64_3.24.3-stable.zip \ -d ~/development/

Add Flutter to your PATH

Open terminal
Run:

vim ~/.zshrc

Press 'I' to insert the path as (export PATH=/Users/DK/flutter/bin:$PATH). Here /Users/DK/ is the folder where Flutter is installed

Add:

export PATH="$PATH:/Volumes/DK SSD/flutter Sdk/bin"

Hit Esc key, then enter :wq and then press Enter or return to save and exit the file

Restart Terminal
All set! To ensure everything is working correctly, enter the following command in the terminal.

flutter doctor

Configure iOS development

Install and configure Xcode

To develop Flutter apps for iOS, install Xcode to compile to native bytecode.

Open the App Store and sign in.
Search for Xcode.
Click Install.

The Xcode installer takes up 6+ GB of storage. The download might take some time.

To configure the command-line tools to use the installed version of Xcode, use the following commands.

sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'

Use this path for the latest version of Xcode. If you need to use a different version, specify that path instead.

Sign the Xcode license agreement.

sudo xcodebuild -license

Install CocoaPods

Install cocoapods following the CocoaPods install guide.

sudo gem install cocoapods

Configure your target iOS device

With Xcode, you can run Flutter apps on an iOS device or on the simulator.

https://docs.flutter.dev/get-started/install/macos/mobile-ios#configure-your-target-ios-device

Check your development setup

Open your Terminal.
To verify your installation of all the components, run the following command.

flutter doctor

As you chose to develop for iOS, you do not need all components. If you followed this guide, the result of your command should resemble:

Note : If you do not configure iOS development : link

Configure Android development

Configure the Android toolchain in Android Studio

Agree to Android licenses

Open an elevated console window.
Run the following command to enable signing licenses.

flutter doctor --android-licenses

Troubleshooting licensing issues

Unable to find bundled Java version

Go to finder and find Android studio:

Right click and click show package contents
Create a new folder called jre
Copy the contents of the jbr folder and paste them into jre folder

Check your development setup

Open your Terminal.
To verify your installation of all the components, run the following command.

flutter doctor

As you chose to develop for Android, you do not need all components. If you followed this guide, the result of your command should resemble:

Note : If you do not configure Android development : link

For window :

Download and install from Android Studio.

After installation, install the Flutter and Dart plugins from File > Settings > Plugins.

Extract the zip file to a desired location (e.g., C:\src\flutter).

Update Your Path
- Open Start and search for Environment Variables.
- In the System Properties window, click Environment Variables.
- Under System variables, find the Path variable, and select it. Click Edit.

Click New and add the path to the flutter\bin directory (e.g., C:\src\flutter\bin).
Click OK to close all windows.

On the top toolbar, click on File.
Then click on Settings (or press Ctrl + Alt + S ).

In your terminal (Command Prompt or PowerShell), run the following command:

flutter doctor --android-licenses

You will be prompted to review and accept each of the Android SDK licenses.
Press y for "yes" to accept the licenses as they appear.

flutter doctor

Note : If you do not configure flutter SDK : link

Change Base URL

Find the cutfx.zip from the folder downloaded from codecanyon and open it in android studio.
Open cutfx>lib/utils/const_res.dart
Replace "baseUrl" with your BaseUrl.
Replace "itemBaseUrl" with your new itemBaseURL.

Change package name

Android

Step 1 : Go to android > app
Step 2 : Click to build.gradle
Step 3 : Here, change the only applicationId And it's done.

iOS

Step 1 : Now right click on iOS directory, flutter > Open iOS module in Xcode

Once the project gets opened in Xcode successfully, follow the steps below.

Step 2 : Go to runner > Signing & Capabilities
Step 3 : Change your bundle identifier as you want, and it's done.

Change app name

Android

Step 1 : Go to android > app > src > main > AndroidManifest.xml and make changes shown in the below image.

iOS

Step 1 : Now right click on iOS directory flutter > Open iOS module in Xcode

Step 2 : Now go to Runner > General > Display Name, change it as you want.

Change app color

Step 1 : Now go to your project lib > utils > color_res.dart as shown in the below image.

Change app font family

Step 1 : Select any font from google font

Here’s how you download the font:

Visit the https://fonts.google.com/
Search for your font.
Once you find it, click to open.
Click on the Download Family button on the top right side of your screen.
Extract the compressed file.

Step 2 : Import the Font into Project

To import the Font in your project:

Copy-Paste [font].ttf file into the fonts folder.

Step 3 : Add Font to Pubspec.yaml

To add Font to pubspec.yaml file:

Replace the family name with your font family. To get the family name, simply take the first part before the dash sign (-). For example, if the downloaded font name is Montserrat-Regular , take the Montserrat as your family name
Go to pubspec.yaml file:
Replace the asset path with the path where your font is residing.
Then pub get to successfully load your font

Change app icon

Step 1 : Generating Different Sized Icons

Go to https://www.appicon.co/ and upload the icon image and tick the iPhone and Android options and click on Generate. This site generates different sized Icons for both android and IOS at the same time.

It will Download the Zip file named AppIcons with the android and Assets.xcassets named folders along with images for appstore and playstore which can be directly uploaded as an icon in both the stores

Now, open your Project in Android Studio.

Step 2 : Adding Icons in Android.

Navigate to android/app/src/main/res and right-click on res folder and click "open in Finder". Now delete all the mipmap folders in res folder and paste the mipmap folders from AppIcon/android folder which you have downloaded.

Step 3 : Adding Icons in IOS

Now navigate to the ios/Runner/Assets.xcassets. Now after you are in Runner folder, right-click on Runner folder and click “open in Finder”. Now delete the Assets.xcassets folder and paste the Assets.xcassets folder from AppIcon/Assets.xcassets which you have downloaded.

Step 4 : Run the Application

After manually changing the images in android and IOS folders now go to lib/main.dart and run the flutter project using the below command in the flutter console.

flutter run

Configure Firebase

Go to the firebase project you might created while following backend documentation.
If you don't have, follow the steps below and create one project.
At first, follow this link https://firebase.google.com/

Now, we first have to create a Firebase project. Firebase project will go through and describe what it is. This allows us to add an app to that project. It can have many projects inside of Firebase.

Now, we have to give a name and id to the project, enable Google Analytics for the project, set an analytics location, and accept all the terms and conditions. Firebase console automatically creates a unique id for the project.

Step 1 : Giving a name to the project

Step 2 : Enable Google analytics for the project

Step 3 : First Choose default Firebase account and then create project

Add Android app to Firebase

In the next step, we have to choose the platform to add Firebase to our application. The platform can be Android, iOS, Web etc..

Your package name is generally the applicationId in your build.gradle (app-level) file
See this page for information on using keytool to get 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.

Back in the Firebase console-setup workflow, click Next to skip the remaining steps and then finish and complete

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. Make sure the config file is not appended with additional characters, like (2).

Back in the Firebase console-setup workflow, click Next to skip the remaining steps and the finish.

Google sign in

Click to Authentication and sign in mathod tab

Click to Enable
Select your support email and save

Successfully Enable google sign in method

Set Google ‘REVERSED_CLIENT_ID’

Open GoogleService-Info.plist file and find ‘REVERSED_CLIENT_ID’ and Copy it.
And paste it in project > target > info > URL Types

Email sign in

Click to Authentication and sign in mathod tab
Then click on email/password provider

Then both button switch to enable and save

Your email and password successfully Enable

Apple sign in

Click to Authentication and sign in mathod tab
Then click to apple provider

Click to Enable and save it

your apple provider Successfully Enable

Create APNs Auth key for push notification

Open https://developer.apple.com/account
Log in using your Apple developer credential.
You obtain a provider certificate from your developer account In the certificates section first as shown in the below image.
Select Certificate, IDs & Profiles tab.

Select keys tab.
Tap on the + button.

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:

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:

Copy Key ID & Download File

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