Laravel Configuration

App Configuration

                                                    APP_NAME="your app name"
                                                    APP_ENV=production
                                                    APP_KEY=yourkey
                                                    APP_DEBUG=false
                                                    APP_URL=yourappurl
                                                    

1. Open and edit the /.env file and provide following details:
2. Enter App name, App env, App debug and App url
   Run in terminal or CMD: php artisan key:generate

Database Configuration

1. Create the database on your server
2. Open and edit the /.env file and provide your server details:

                                                        DB_CONNECTION=mysql
                                                        DB_HOST=127.0.0.1
                                                        DB_PORT=3306
                                                        DB_DATABASE=laravel
                                                        DB_USERNAME=root
                                                        DB_PASSWORD=
                                                    

3. Open and edit the /.env file and provide following details:
4. After that run in terminal or CMD,
   Note: Only necessary for those, who is setup project first time.
   

    php artisan migrate --seed

   Note: When you update new code then run in terminal or CMD for new table migration,

   php artisan migrate

5. If you are facing problem to migrate database using command then, import the mightyfitness.sql file in your database. You will find the sql file in mightyfitness/mightyfitness.sql.

   Already imported mightyfitness.sql

   If you have already imported mightyfitness.sql file than you need to import alter-mightyfitness.sql file. ( Note : Not Necessary for those,who is setup project first time. )

Mail Configuration

1. Open and edit the /.env file and provide following details:

                                                        MAIL_MAILER=your mail mailer
                                                        MAIL_HOST=your mail host
                                                        MAIL_PORT=your mail port
                                                        MAIL_USERNAME=your mail id
                                                        MAIL_PASSWORD=your mail password
                                                        MAIL_ENCRYPTION=your mail encryption
                                                    

2. Enter mail host name, mail port, mail username( Mail ID ), mail password and mail encryption type.
3. Note If you configure Gmail SMTP then, you have to Generate App Password. Follow this link: Click Here

Onesignal Configuration

1. In Admin Panel Go to Setting -> Mobile Configuration -> ONESIGNAL
2. Open and edit the /.env file and provide following details:

                                                        ONESIGNAL_APP_ID=
                                                        ONESIGNAL_REST_API_KEY=
                                                    

3. If you want to enable onesignal notifications you have set,
   ONESIGNAL_APP_ID, ONESIGNAL_REST_API_KEY.

Storage your link

1. Link your storage folder to public folder. Run in your project root directory (where you uploaded code) terminal or CMD:

   php artisan storage:link

   After this if you are facing a problem storage link using command please follow the below steps: ln -s

                                                               ln -s /home/your_application/storage/app/public /home/your_application/public/storage
                                                           

   Also set your APP_URL=yourappurl

                                                               APP_URL=https://your-website-url.com
                                                           

Cron jobs for Subscription

1. For Automatically inactive the user plan you have to setup the cron job to your server. Follow the below steps
2. ssh into your server, get inside your project with cd your-laravel-project and run the following command.

                                                        crontab -e
                                                    

3. It will open the Crontab file, and you need to assimilate the following code in the same file. Don’t forget to replace /path/to/artisan with the full path to the custom Artisan command of the Laravel project.

                                                        * * * * * cd /your-project-path && php artisan schedule:run >> /dev/null 2>&1
                                                    

Admin Credentials

                                                        Email    : [email protected]
                                                        Password : 12345678
                                                    

Theme Color

1. Install node_modules Run in terminal or CMD:

                                                        npm install
                                                    

2. We use a subset of all colors to create a smaller color palette for generating color schemes, also available as Scss variables in public/scss/hope-ui-design-system/_variable.scss file.

More Customization will be done in variable file.




3. To build css and js for Run in terminal or CMD:

                                                        npm run dev
                                                    

Install flutter on windows

• Download Android Studio

  Click here

• Get the Flutter SDK

  1. Install https://flutter.dev/docs/get-started/install
     

     Extract the zip file and copy flutter folder into your desired installation location for the Flutter SDK (eg. C:\src\flutter; do not install Flutter in a directory like C:\Program Files\).

  2. Update your path
     
  3. Now set your enviournment variable
  4. From the Start search bar in , type ‘env’ and select Edit environment variables for your account
  5. Under User variables check if there is an entry called Path:
  6. Click on Edit. New Dialog open from it click on new and copy full path to flutter\bin as its value
  7. Now Restart your pc for changes to take effect
  
  
  8. Now check everything is ok or not
  9. Open cmd and run flutter doctor as shown the below picture
  
  
  10. Now open Android Studio and create new flutter project then select your flutter sdk file to the location where we have downloaded earlier and that's it
  
  
• Learn more about Android Studio - Click here
• JAVA_HOME path set in system .env file Click Here

Install flutter on mac

• Download Android Studio - Click here
• Download Xcode - Click here
• Get the Flutter SDK - Click here
  1. Install Click here
     

     Extract downloaded file, just double click on that. and just copy extracted folder and paste it to your desired location (for example, Documents\flutter).

  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

Install flutter on linux

• Download Android Studio - Click here
• Get the Flutter SDK - Click here
  1. Install Click here

     Extract downloaded file, just double click on that. and just copy extracted folder and paste it to your desired location (for example, Documents\flutter).

  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"

     1. Run source $HOME/. to refresh the current window, or open a new terminal window to automatically source the file.
     2. 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!

Android Configuration

Introduction

Requirements

To develop a Flutter project, you will need the following requirements:

1. Flutter SDK: Flutter is an open-source framework developed by Google for building cross-platform applications. You need to download and install the Flutter SDK, which includes the Flutter framework, Dart programming language, and various command-line tools.
2. Integrated Development Environment (IDE): While you can use any text editor to write Flutter code, it is recommended to use an IDE for better productivity. The popular choices for Flutter development are Android Studio, Visual Studio Code (with Flutter and Dart extensions), and IntelliJ IDEA (with Flutter plugin).
3. Dart programming language: Flutter uses the Dart programming language. When you install the Flutter SDK, it includes the Dart SDK as well. You don't need to separately install Dart
4. Device setup: Depending on your target platform(s), you will need to set up the necessary devices for testing your Flutter app. For Android, you need to have Android Studio installed and set up an Android Virtual Device (AVD) or connect a physical Android device. For iOS, you need a Mac computer with Xcode installed.
5. Flutter dependencies: Depending on the specific requirements of your project, you may need to include additional Flutter dependencies. These dependencies can be added to your project's pubspec.yaml file, and Flutter's package manager, called pub, will handle the installation and management of these dependencies.
6. Firebase Account: There are various functionality which require Firebase Setup. Features like Social Login , Chat Module and Notifications.
7. Git: Although not mandatory, having a version control system like Git is highly recommended for tracking changes in your project and collaborating with other developers if needed.

Additionally, having a basic understanding of programming concepts, object-oriented programming (OOP), and the Flutter framework's architecture will greatly help in developing Flutter projects effectively.

Keep in mind that Flutter is a rapidly evolving framework, so it's a good practice to stay updated with the latest releases and changes by referring to the official Flutter documentation and community resources.

Installation

1. Flutter & Dart SDK:
• Ensure that you have Flutter and Dart SDK installed on your system. These are essential for Flutter app development.
• Install Flutter SDK
• Set up Environment for Flutter
2. Choose an IDE:
• You can use any IDE such as Android Studio, Visual Studio Code, or IntelliJ IDEA for Flutter development.
3. Set up Your Editor:
• Configure your IDE by installing the Flutter and Dart plugins to enable Flutter development features.
• Install Flutter And Dart Plugins?
4. Git: Although not mandatory, having a version control system like Git is highly recommended for tracking changes in your project and collaborating with other developers if needed.

For detailed installation instructions and troubleshooting, refer to the official Flutter documentation.

Basic Installation

Important: Choose Your Platform And Follow Steps To Build And Run Application.

• Windows
• macOS
• Linux
• Chrome OS

Install Flutter And Dart Plugins

Android Studio

1. Open Android Studio.
2. Go to Preferences(on macOS) or Settings (on Windows/Linux).
3. Select Plugins from the left sidebar.
4. Click on the Marketplace tab.
5. Search for "Flutter" in the search bar.
6. Install the "Flutter" plugin by clicking on the green Install button.
7. Install "Dart" Plugin.
8. Restart Android Studio when prompted.

Visual Studio Code

1. Visual Studio Code
2. Go to the Extensions view by clicking on the square icon in the Sidebar.
3. Search for "Flutter" in the Extensions Marketplace.
4. Click on the "Install" button for the "Flutter" extension provided by the Flutter team.
5. Install "Dart" Plugin same way.
6. After installation, you may need to restart Visual Studio Code to enable the extension.

IntelliJ IDEA

1. Open IntelliJ IDEA.
2. Go to File → Settings (on Windows/Linux) or IntelliJ IDEA → Preferences (on macOS).
3. Go to File → Settings (on Windows/Linux) or IntelliJ IDEA → Preferences (on macOS).
4. Click on the Marketplace tab.
5. Search for "Flutter" in the search bar.
6. Install the "Flutter" plugin by clicking on the green install button.
7. Install the "dart" plugin same way.
8. Restart IntelliJ IDEA when prompted.

Basic Setup

Here are the requirements for mobile configuration in Markdown format:

Firebase

Firebase provides tools to grow your app and business, offering fully managed backend infrastructure and features for app development. Visit Firebase for more information.

• You need only one Firebase project Firebase Configuration

Payment Methods

Mighty Fitness Laravel currently supports eight payment gateways. Here Some two examples are given below.

• Rozerpay Payment
• Stripe Payment

Open Android Module

• The Android module can be accessed in Two ways:

1. Select the Android Module from the same project you're attempting to open by going to File -> Open.



2. Navigate to Tools -> Flutter -> Android Studio -> Open Android Module.

Change Application Name

In the main directory, go to open android/app/src/main/AndroidManifest.xml and specify your application name.

Change Application Icon

Generate App Launcher Icon

Method 1 : Use Android Studio To Generate Launcher Icons

• Go to android/app/src/main/res folder.
• Right-click on the res folder and select Image → Asset News.

• Choose Icon Type - "Launcher icons Adaptive & Legacy"
• Select the path of your Image and press Next.
• Select App mode for app Icon.
• Then Press Finish.

Method 2 : Generate Online

• Icon Kitchen
• App Icon Generate

The basic process of this website is -

• Choose Asset type
• Basic Configuration
• Choose Device Type
• Generate and Get the Zip
• After extracting zip you get res folder replace it with your android/app/src/main – res folder

Generate Notification Icon

• Go to android/app/src/main/res folder.
• Right-click on the res folder and select New → Image Asset.
• Choose Icon Type - "Notification"
• Select the path of your Image and press Next.
• Select App mode for app Icon.
• Then Press Finish.

Change notification icon in Androidmanifest.xml

• Navigate to android/app/src/main.
• Open your Androidmanifest.xml and check for lines below. If not exist just add this line otherwise Paste the Name of Icon you just created into “android:resource“.

Add Google JSON File

Generate Signed APK

To generate a signed APK (Android Package), follow these steps:

1. Open the build menu and Select Generate Signed Bundle/APK.Choose APK and click Next.





2. Now you will have two options create a new Keystore or choose existing keystore.
• If you choose to create a new keystore:
• A dialogue will appear, prompting you to specify the path of the keystore and give it a name.
• Enter your password and confirm it.
• Select the alias name.
• Confirm the password.
• Enter any additional information if required.
• Click OK to create your keystore.

If you choose to use an existing keystore, simply select it.

After selecting your keystore or creating a new one, click Next.

Choose the release mode and proceed with building the APK.

Change The Application Id

• For Application ID, change the applicationId in the app/build.gradle file.
• Locate the build.gradle file at this path: android/app/build.gradle.

Change The Version Name

• For Version Name, change the versionName in the build.gradle file at the app level.
• Locate the build.gradle file at this path: android/app/build.gradle.

Change The Version Code

• For Version Name, change the versionName in the build.gradle file at the app level.
• Locate the build.gradle file at this path: android/app/build.gradle.

Change The App Name From Manifest File

Setup Firebase

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

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.

Generate Signed APK & AAB

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


2. Open Project in New Window
3. Wait for while until project synchronization. After that Go to Build -> GenerateSigned Bundle/APK...


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


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



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

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

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 on your Mac computer.
2. In Xcode, go to the File menu and select "Open" or use the keyboard shortcut "Command + O".
3. Navigate to the directory of your Flutter project on your computer.
4. Inside your Flutter project directory, locate the ios folder and open it.
5. Look for a file with the extension ".xcworkspace" or ".xcodeproj" within the ios folder. This file represents your Xcode project for the Flutter app
6. Select the ".xcworkspace" or ".xcodeproj" file and click on the "Open" button.

Xcode should then open your Flutter project, allowing you to build, run, and modify your iOS app using the Xcode IDE. Please note that before opening your project in Xcode, you need to ensure that you have set up Flutter and the necessary dependencies for iOS development.

Change Bundle Name

1. Select your project file icon in the Group and Files panel.
2. In the Xcode navigation pane, find and select your project file (usually denoted by the blue icon with your project name).
3. In the main editor area, you should see the project settings. Select the target for which you want to change the Bundle Name. Targets are usually listed under the Targets section in the project settings.
4. With the target selected, navigate to the "Info" tab.
5. Scroll down to the "Custom iOS Target Properties" section, and locate the "Bundle Name" key.
6. Double-click on the value field next to "Bundle Name" and enter the desired name for your bundle.
7. After changing the Bundle Name, make sure to save your changes by clicking on the "File" menu and selecting "Save" or using the keyboard shortcut "Command + S".

By following these steps, you can change the Bundle Name for your iOS target in Xcode.

The Bundle Identifier is a unique identifier of your app on iOS and macOS. It must be unique for your app.

1. Select your project file icon in the Group and Files panel.
2. Select the General tab.
3. In the Identity section, rename your Bundle Identifier.

Change App Icons

Visit the Website -

• Icon Kitchen

The basic process of this website is -

• Choose Asset type
• Basic Configuration
• Choose Device Type
• Download and Get the Zip
• After extracting zip you get ios folder. Copy all inside ios folder and paste it into ios/Runner/Assets.xcassets/AppIcon.appiconset

Google SignIn

To enable Google SignIn in your app:

• Register your app on Firebase.
• Make sure that GoogleService-Info.plist is the name of the file you downloaded from Firebase.
• Move or copy the GoogleService-Info.plist into the [My_project]/ios/Runner folder.
• Open Xcode, right-click on the Runner directory, and select Add files into Runner.
• Select the GoogleService-Info.plist file from the file manager.
• In the dialog that appears, select the Runner target.
• Add the following CFBundleURLTypes attributes into the [My_project]/ios/Runner/Info.plist file.
• Run your project.

SignIn with Apple

To enable SignIn with Apple in your project:

• Open the project in Xcode.
• Go to the Project Editor, choose your target, and open the Signing & Capabilities panel.
• Click the Library button (+) to open the Capabilities library (or choose Editor > Sign in with Apple).
• Run your project.

Change Base URL

In the main directory, go to lib → app_config.dart

                                                        const APP_NAME ="ADD_YOUR_DOMAIN_URL"
                                                    

Change Primary Color

In the main directory, go to lib → utils → app_colors.dart

Change One Signal Key

In main directory goto the lib -> utils -> app_config.dart

                                                        const mOneSignalID = 'CHANGE_ONE_SIGNAL_KEY';
                                                    

Change App Images

In main directory goto the assets folder and repalce the images.

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

Use the SDK path in your future projects

iOS errors

List of common iOS issues

Framework not found & Linker command failed with exit code 1

If you encounter error given below

1. framework not found flutter
2. Linker command failed with exit code 1 (use -v to see invocation)

Before start please check your iOS deployment target in Xcode.

Step 1 - In Mac check flutter version in your global terminal and in Android studio's terminal.

If not same then set Flutter SDK path for Global environment -

Setting up Flutter SDK Path Globally on macOS

1. Open Terminal: Launch the Terminal application. You can find it in the Applications folder or search for it using Spotlight (Cmd + Space, then type "Terminal").


2. Edit Your Shell Profile:
• For Bash:
nano ~/.bash_profile
• For Zsh:
nano ~/.zshrc
3. Add Flutter SDK Path: Add the following line at the end of the file:
export PATH="$PATH:/path/to/flutter/bin"

Replace /path/to/flutter with the actual path where Flutter is installed on your system.

4. Save Changes: Press Ctrl + O to save the file, then press Enter. Press Ctrl + X to exit the editor.
5. Apply Changes: In the Terminal, run:
• For Bash:
source ~/.bash_profile
• For Zsh:
source ~/.zshrc
• Verify the Flutter version by running the command below -
flutter doctor --v

Setting up Flutter SDK Path in Android Studio on macOS

Follow these steps to set up the Flutter SDK path in Android Studio on macOS:

1. Open Android Studio: Launch Android Studio on your Mac.
2. Open Preferences:
• Go to "Android Studio" in the menu bar.
• Then, select "Preferences".
3. Access Flutter Settings:
• In the left-hand pane, navigate to "Languages & Frameworks".
• Then, select "Flutter".
4. Set Flutter SDK Path:
• Look for the "Flutter SDK path" field.
• Click on the folder icon next to it.
• Navigate to the directory where Flutter is installed on your system and select the Flutter SDK folder.
5. Apply Changes: After selecting the Flutter SDK path, click "Apply" or "OK" to save the changes.
6. Restart Android Studio: Close and reopen Android Studio for the changes to take effect.

After completing these steps, Android Studio will be configured to use the Flutter SDK from the specified path. This will enable you to create, edit, and run Flutter projects seamlessly within Android Studio on macOS.

Step 2 - run this command in terminal

If still issue is not fixed then move to the Step 3

Step 3 - Get the new Flutter SDK from the link below and replace it with you SDK.

Flutter SDK Archives

PLA(Program Licence Agreement) Update

If you the error like shown below while uploading app to Store follow the mentioned step in image.

Solution : Follow the steps shown in Image.

Unsupported gradle version 3.x

Fixing "Unsupported Gradle Version" Error

If you encounter the "Unsupported Gradle Version" error with a version number like 3.., you can follow these steps to resolve it:

1. Open your project in Android Studio.
2. Navigate to the android directory within your project's root directory.
3. Wait for the project indexing process to complete in Android Studio.
4. Once indexing is finished, run your application by selecting the Android module in your project and clicking on the "Run" button or using the appropriate keyboard shortcut.

By following these steps, you should be able to resolve the "Unsupported Gradle Version" error and run your application successfully

If you continue to experience issues or encounter any other errors, make sure to check for updates to your Gradle version and ensure that it is compatible with your project requirements. Additionally, consult the official documentation or seek support from the Android Studio community for further assistance.

Migrate Database issue?

• If you are facing a problem migrating database using command the please follow the below steps.
  Go to the main directory of download project then find mightyfitness.sql file and import to the database.

symlink() has been disabled for security reasons?

When you get an error while run php artisan storage:link, please follow the below steps:

Second way, just fire this command

ln -s /home/your_application/storage/app/public /home/your_application/public/storage

Admin Log

Version 4.0 - 4 Sep 2024

• Added: In User Profile admin can view BMR, BMI and Ideal Weight (Metrics)

Version 3.0 - 4 March 2024

• Added: Manage Google Ads through Admin Panel
• Added: Enable/Disable option for Subscription Settings

Version 2.0 – 16 Oct 2023

• Added: Quotes Module

Version 1.0 – 14 Oct 2023

• Initial Release

User Log

Version 6.0 - 2 Aug 2024

• Flutter 3.22 support
• Bug Fix

Version 4.0 - 4 March 2024

• Migrate to Flutter's latest version 3.19.x
• Support for Android 14
• Added: BMR and Ideal Weight
• Added: Handle Google Ads through Admin Panel
• Added: Fixed: Handle Text to speech and timer while playing a video

Version 3.0 – 17 Nov 2023

• Added: Metrics for push up
• Added: Enable/Disable option for Metrics Settings
• Added: Daily Reminder

Version 2.0 – 20 Oct 2023

• UI Enhancements

Version 1.0 – 14 Oct 2023

• Initial Release