diff --git a/docs/testing-deployment-publishing/imgs/add-for-review.avif b/docs/testing-deployment-publishing/imgs/add-for-review.avif
new file mode 100644
index 00000000..b8bb9439
Binary files /dev/null and b/docs/testing-deployment-publishing/imgs/add-for-review.avif differ
diff --git a/docs/testing-deployment-publishing/imgs/deploy-from-github.png b/docs/testing-deployment-publishing/imgs/deploy-from-github.png
new file mode 100644
index 00000000..be2bfb6d
Binary files /dev/null and b/docs/testing-deployment-publishing/imgs/deploy-from-github.png differ
diff --git a/docs/testing-deployment-publishing/imgs/deploy-to-appstore.avif b/docs/testing-deployment-publishing/imgs/deploy-to-appstore.avif
new file mode 100644
index 00000000..f5004df7
Binary files /dev/null and b/docs/testing-deployment-publishing/imgs/deploy-to-appstore.avif differ
diff --git a/docs/testing-deployment-publishing/imgs/update-version.avif b/docs/testing-deployment-publishing/imgs/update-version.avif
new file mode 100644
index 00000000..901ffc1a
Binary files /dev/null and b/docs/testing-deployment-publishing/imgs/update-version.avif differ
diff --git a/docs/testing-deployment-publishing/publishing/apple-appstore-deployment.md b/docs/testing-deployment-publishing/publishing/apple-appstore-deployment.md
index 73a7fa49..89a41f23 100644
--- a/docs/testing-deployment-publishing/publishing/apple-appstore-deployment.md
+++ b/docs/testing-deployment-publishing/publishing/apple-appstore-deployment.md
@@ -10,47 +10,30 @@ keywords: [Apple App Store, Deployment, FlutterFlow, iOS]
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
-FlutterFlow allows you to seamlessly deploy your apps directly to the App Store, all from within the builder. This guide provides comprehensive instructions on prerequisites, step-by-step process for deployment, and troubleshooting common issues.
+# Apple App Store Deployment
-:::info [Prerequisites]
+FlutterFlow allows you to deploy your apps directly to the App Store from within the platform. This guide covers all the necessary prerequisites, a step-by-step deployment process, and common troubleshooting tips.
+:::info[Prerequisites]
- Create an [**Apple account**](https://appleid.apple.com/account?appId=632&returnUrl=https%3A//developer.apple.com/account/).
-- [**Purchase an Apple Developer membership**](https://developer.apple.com/programs/enroll/). Please see [**this link**](https://developer.apple.com/programs/) for more details on the Apple Developer program and how to sign up.
-- Set an App Launcher Icon for your app (under Settings & Integrations > General > App Assets). **The App Launcher icon can't be transparent or contain an alpha channel.**
-- We recommend testing your application on a real device. [**Here are instructions**](../running-your-app/local-run.md) on how to do this.
-
+- [**Purchase an Apple Developer membership**](https://developer.apple.com/programs/enroll/). Learn more about the program and enrollment process [here](https://developer.apple.com/programs/).
+- Set an App Launcher Icon for your app under **Settings & Integrations > General > App Assets**. **Note**: The launcher icon cannot be transparent or contain an alpha channel.
+- It's recommended to test your app on a real device before deployment. Follow [**these instructions**](../testing/local-run) to test your app locally.
:::
## Deploy to App Store
-Deploying to App Store consists of the following steps:
-
-1. [Create a Bundle Identifier](#1-create-a-bundle-identifier)
-2. [Add a new app to App Store Connect](#2-add-a-new-app-to-app-store-connect)
-3. [Add your Apple App ID to FlutterFlow](#3-add-your-apple-app-id-to-flutterflow)
-4. [Generate your API key and add It to FlutterFlow](#4-generate-your-api-key-and-add-it-to-flutterflow)
-5. [Add your issuer ID to FlutterFlow](#5-add-your-issuer-id-to-flutterflow)
-6. [Add your Key ID to FlutterFlow](#6-add-your-key-id-to-flutterflow)
-7. [Deploy](#7-deploy)
-8. [Submit your app for App Store approval](#8-submit-your-app-for-app-store-approval)
+The App Store deployment involves the following steps:
### 1. Create a Bundle Identifier
-A Bundle Identifier (ID) is a unique **string** that identifies your app within the Apple ecosystem. It's typically formatted in reverse domain name notation, such as `com.example.myapp`.
+A **Bundle Identifier (ID)** is a **unique string** that identifies your app within the Apple ecosystem, typically formatted in reverse domain name notation like `com.example.myapp`.
-Please follow these steps to create a Bundle ID:
+To create a Bundle ID, visit the [**Certificates, IDs & Profiles**](https://developer.apple.com/account/resources/identifiers/list) page, add a new **App ID**, and provide these details:
-1. Open your FlutterFlow project and navigate to **Settings & Integrations > General > App Details.** Copy the **Package Name**.
-
-2. Open the Apple Developer homepage, select **Certificates, IDs & Profiles** (far left menu), and then select **Identifiers.**
-3. Click on the **Add button (+).**
-4. The **Register a new identifier** page will open. Select **App IDs** and then select **Continue.**
-5. Select **App** and then click **Continue.**
-6. Enter the [App Bundle Information](https://help.apple.com/app-store-connect/#/deveaec374de):
- 1. **Bundle ID:** paste the **Package Name** that you copied from FlutterFlow. Double-check that the **Package Name** in FlutterFlow is the same as the **Bundle ID.** If these are different, errors will occur.
- 2. **Description:** Provide a short description of your app (this will appear in the app store).
- 3. **Capabilities:** scroll down and **select the capabilities that are required for your app**. **Important**: You must select **Push Notifications** from the list if you add this feature to your app. Also, if your app uses Apple Sign In - make sure to check the box for **Sign In with Apple**.
-7. When you are done, select **Register.**
+1. **Bundle ID:** Copy the **Package Name** from FlutterFlow.
+2. **Description:** Add a brief description of your app.
+3. **Capabilities:** Select the necessary app capabilities. Ensure you select **Push Notifications** if your app uses them, and **Sign In with Apple** if your app includes that feature.
+
-### 2. Add a new app to App Store Connect
-
-[App Store Connect](https://help.apple.com/app-store-connect/#/dev2cd126805) is used to submit apps to the App Store, manage apps, and more.
-
-Please follow these steps to add a new app to App Store Connect:
-
-1. Navigate to [App Store Connect](https://appstoreconnect.apple.com/login) and then select **My Apps.**
+### 2. Add New App
-2. Click on the **Add button (+)** and then select **New App.**
-3. A popup will appear. Enter your [app information:](https://help.apple.com/app-store-connect/#/dev2cd126805)
- 1. **Platform:** for mobile apps, this will be **iOS**.
- 2. **Name:** Enter a Name for your app (this is the name that will show in the App Store).
- 3. **Primary Language** for your app.
- 4. **Bundle ID:** Select the **Bundle ID** you created in the previous step.
- 5. **SKU**: Enter a unique identifier. You can also add your **Bundle ID** here, as long as it is unique.
- 6. User Access: **Set the user access.** If you select Limited Access, you will need to select the users that you would like to be able to access this app. This will only appear if you have other users included in your App Store Connect account.
-4. When you are done, select **Create.**
-
-You will then be navigated to the main dashboard for your app.
+[App Store Connect](https://developer.apple.com/help/app-store-connect/get-started/app-store-connect-homepage) is the platform used for submitting apps, managing app metadata, and much more. To add a new app, open the [App Store Connect](https://appstoreconnect.apple.com/) and then follow the official steps outlined [here](https://developer.apple.com/help/app-store-connect/create-an-app-record/add-a-new-app).
+
-### 3. Add your Apple App ID to FlutterFlow
+### 3. Add Apple App ID to FlutterFlow
An App ID is used by Apple to identify your app and associate it with your development team.
-Please follow these steps to add your App ID to FlutterFlow:
-
-1. From [App Store Connect](https://appstoreconnect.apple.com/login), select **My Apps,** and then select **your app**.
-
-2. Select **App Information** (under **General** on the left sidebar).
-3. Scroll down to **General Information** and find your **Apple ID.**
-4. Select the **Apple ID** and copy it.
-5. Return to FlutterFlow and navigate to **Settings & Integrations > App Settings >** **Mobile Deployment > App Store**.
-6. Paste the **Apple ID** into the box labeled **App ID.**
+To add your App ID to FlutterFlow, go to **[App Store Connect](https://appstoreconnect.apple.com/) > My Apps**, copy your **Apple ID** from **App Information**, and paste it into the **App ID** field in **FlutterFlow > Settings & Integrations > Mobile Deployment > App Store**.
+
-### 4. Generate your API key and add It to FlutterFlow
-
-Please follow these steps to generate your API Key:
+### 4. Generate API key and add to FlutterFlow
-1. Return to the App Store Connect page. If you have closed this window, navigate to [App Store Connect](https://appstoreconnect.apple.com/login) and select **Users and Access,** and then select **Keys** (blue text).
+To generate your API Key, go to [**App Store Connect**](https://appstoreconnect.apple.com/) > **Users and Access** > **Integrations > [Team Keys](https://appstoreconnect.apple.com/access/integrations/api)**. If you haven't added a key before, you will see a **Request Access** button. For further details, watch a [demo](https://youtu.be/L2BpgVog4so?si=yS9r_PBeORgd6Uhp&t=240) here.
-:::info
-If you haven't added a key before, click 'Integrations' and you will see 'Request Access'. For further details, watch a [demo](https://youtu.be/L2BpgVog4so?si=yS9r_PBeORgd6Uhp&t=240) here.
-:::
-
-2. If you see the **Request Access** button, click on it.
-3. If you haven't added any key before, click on the **Generate API Key**. Otherwise, select the **Add button (+).**
-4. A popup will appear. Enter your API Key Information:
- - **Name:** Enter a name for the key. This is a reference and is not part of the key itself.
- - **Access:** Select the "App Manager" role. We will use this API key to deploy the app to the app store for you automatically.
-
-
-
-1. When you are done, select **Generate.**
-
-2. Find the row for the API Key you just generated and select **Download API Key.** A popup will appear; select **Download.**
-3. Return to FlutterFlow and navigate to **Settings & Integrations > App Settings >** **Mobile Deployment > App Store**.
-4. Click on **Upload Private Key** and upload the **API Key File**.
-
-:::info
-
-If you don't see the **Download API Key** link immediately, refresh your page.
-
-:::
+Generate a new API key by selecting **Add (+)**, entering a name, and assigning the **App Manager** role. Once the key is generated, download it and upload it to **FlutterFlow** under **Settings & Integrations > App Settings > Mobile Deployment > App Store > Private Key**.
+
-### 5. Add your issuer ID to FlutterFlow
+### 5. Add issuer ID to FlutterFlow
-1. Navigate to [App Store Connect](https://appstoreconnect.apple.com/login) and select **Users and Access,** and then select **Keys** (blue text).
-
-2. Locate the **Issuer ID** and select **Copy.**
-3. Return to FlutterFlow and navigate to **Settings & Integrations > App Settings** **>** **Mobile Deployment > App Store**.
-4. Paste the **Issuer ID**.
+Copy the **Issuer ID** from [**App Store Connect**](https://appstoreconnect.apple.com/) by navigating to **Users and Access** > **Integrations > [Team Keys](https://appstoreconnect.apple.com/access/integrations/api)**, and then paste it into the **Issuer ID** field under **App Store settings** in FlutterFlow.
+
-### 6. Add your Key ID to FlutterFlow
-
-1. Return to the App Store Connect page. If you have closed this window, navigate to [App Store Connect](https://appstoreconnect.apple.com/login) and select **Users and Access,** and then select **Keys** (blue text).
+### 6. Add Key ID to FlutterFlow
-2. Find the row for the API Key you just generated and select **Copy Key ID.**
-3. Return to FlutterFlow and navigate to **Settings & Integrations > App Settings >** **Mobile Deployment > App Store**.
-4. Paste the **Key ID**.
+Return to **[App Store Connect](https://appstoreconnect.apple.com/) >** **Users and Access** > **Integrations > [Team Keys](https://appstoreconnect.apple.com/access/integrations/api).** Find the row for the API Key you generated [here](#4-generate-api-key-and-add-to-flutterflow), select **Copy Key ID,** and then paste it into the **Key ID** field under **App Store settings** in FlutterFlow.
+
### 7. Deploy
-You can deploy directly from FlutterFlow or from your GitHub repository.
-
-
-
-Please follow these steps to deploy from FlutterFlow:
-
-1. From FlutterFlow, navigate to **Settings & Integrations > App Settings >** **Mobile Deployment > App Store**.
-
-2. Scroll down to find the **App Store** section and click on the arrow icon on the right to open it.
-3. Click on the **Deploy To App Store.**
-4. A popup will appear. **Select Deploy.** If another deployment is in progress, selecting Deploy will cancel the previous deployment.
-5. **Please note: It can take a few minutes for this request to process.** Once this step is complete, your **Latest Message** will change to **Submitted.**
-6. **It can take 30 minutes to several hours for your app to be deployed to the App Store.** You can check the status of your deployment by selecting **Check Build Status.**
-7. Once complete, you will receive an email from App Store Connect that a new build has been added to your app.
-
-
-
-
-
-
-
+To deploy your app from FlutterFlow, go to **Settings & Integrations > App Settings > Mobile Deployment > App Store** and click **Deploy To App Store**. Once deployed, you will receive an email from App Store Connect that a new build has been added to your app.
-Associating the Github repo allows you to introduce the custom code into your FlutterFlow project. You may want to deploy the modified code directly from your Github repo to App Store.
+
-To deploy from Github repo:
+:::info
+- Every time you deploy, we'll auto increment the **Build Number** (i.e., version code in Android) to ensure that each release is identifiable. If needed, you can update the *App Version* and *Build Number* yourself.
+- If another deployment is already in progress, deploying a new build will cancel the previous one.
+- It may take a few minutes for the request to process. Once completed, the status will be updated to **Submitted**.
+:::
-1. If you haven't added the Github repo yet, you can do so using the instructions [here](../exporting-code/push-to-github.md).
+:::tip
+If you prefer to manage your deployment process outside of FlutterFlow, such as integrating with your own CI/CD pipeline, or if you want more control over versioning and custom code management directly on GitHub. You also have the option to [**Deploy apps from your GitHub repository**](deploy-from-github.md).
+:::
-2. From FlutterFlow, navigate to **Settings & Integrations > App Settings >** **Mobile Deployment > App Store**.
-3. Find the **Deployment Settings** section and click on the arrow icon on the right to open it.
-4. Under the **Deployment Source**, checkmark the **Use Github repo: 'your repo URL'**.
-5. Enter the **Branch Name** of your repo, from which you want to deploy the code. Make sure to enter the correct branch name.
-
-
-
-
-
-
### 8. Submit your app for App Store approval
-1. From App Store Connect, select **My Apps**, and then select **your app**.
-
-2. Enter your **Version Information.** [This page](https://help.apple.com/app-store-connect/en.lproj/static.html#devfc3066644) contains additional information on what is required, localized, and editable.
-3. When you are done, select **Submit For Review.**
+From [**App Store Connect**](https://appstoreconnect.apple.com/), select **My Apps** and choose your app. Select **Prepare for Submission**, add the app assets and metadata, and then click **Add for Review**.
-Your app will now be reviewed by Apple. For additional information on Apple's review guidelines, please see [this link](https://developer.apple.com/app-store/review/guidelines/).
+
-
-
-
+Your app will now be reviewed by Apple. For additional information on Apple's review guidelines, please see [this link](https://developer.apple.com/app-store/review/guidelines/).
---
diff --git a/docs/testing-deployment-publishing/publishing/deploy-from-github.md b/docs/testing-deployment-publishing/publishing/deploy-from-github.md
new file mode 100644
index 00000000..0565a58d
--- /dev/null
+++ b/docs/testing-deployment-publishing/publishing/deploy-from-github.md
@@ -0,0 +1,74 @@
+---
+slug: /deployment/deploy-from-github
+title: Deploy from GitHub
+description: Learn how to deploy your apps directly from GitHub branch.
+tags: [Apple App Store, Google Play Store, Deployment, GitHub]
+sidebar_position: 5
+keywords: [Apple App Store, Google Play Store, Deployment, GitHub]
+---
+
+If your FlutterFlow project is connected to a GitHub repository, the generated code can be pushed to GitHub, giving you full control over your project’s code. Then, you can deploy your app directly from the same repository, rather than deploying through FlutterFlow.
+
+Deploying from GitHub is particularly beneficial when:
+
+- You have written custom code that cannot be managed directly in FlutterFlow, such as features that require advanced Flutter functionality.
+- You want to manage the source code in an external GitHub repository for better version control.
+- You want to automate the process of deploying your app directly from GitHub to the Play Store or App Store after modifying the code.
+- You want to deploy from a specific branch of your GitHub repository.
+
+## Steps to Deploy
+
+To deploy from a GitHub repository:
+
+1. If you haven't already added your project to the GitHub repository, follow the instructions provided [here](../exporting-code/push-to-github.md#connect-a-github-repo).
+2. In FlutterFlow, go to **Settings & Integrations > App Settings > Mobile Deployment.**
+3. Locate the **Deployment Source** section and click the arrow icon on the right to expand it.
+4. Turn on the toggle for **Use GitHub repo: [your repo URL]**.
+5. Enter the branch name of your repository that contains the code you want to deploy. Ensure the branch name is correct.
+6. Click the **Deploy to App Store** or **Deploy to Play Store** button, depending on your desired platform for deployment.
+
+
+
+:::info[important]
+
+When deploying from your GitHub branch, you will need to manage the app versioning manually. This is done through the `pubspec.yaml` file. For example, to set the version to **1.1.0** and the build number to **2**, you can use the format: `version: 1.1.0+2`.
+
+
+
+:::
+
+## FAQs
+
+
+I am having an issue while Deploying from a GitHub branch. Error: *You uploaded an APK or Android App Bundle that was signed in debug mode. You need to sign your APK or Android App Bundle in release mode.*
+
+
+If you are experiencing problems deploying or uploading to the Google Play Store from a Github branch, check to make sure your `build.gradle` file is correct.
+
+1. Open your `android/app/build.gradle` file.
+2. Ensure your file has these lines of code:
+
+ ```
+ def keystoreProperties = new Properties()
+ def keystorePropertiesFile = rootProject.file('key.properties')
+ if (keystorePropertiesFile.exists()) {
+ keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
+ }
+ signingConfigs {
+ release {
+ keyAlias keystoreProperties['keyAlias']
+ keyPassword keystoreProperties['keyPassword']
+ storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
+ storePassword keystoreProperties['storePassword']
+ }
+ }
+ ```
+
+3. Newer Flutterflow code will automatically have these lines added. If yours doesn't, you can push it to your `flutterflow` branch on GitHub and merge in the changes or add them like so:
+
+ 
+
+
+4. Lastly, change `debug` (shown in the red box above) to `release` before deploying.
+
+
\ No newline at end of file
diff --git a/docs/testing-deployment-publishing/publishing/google-playstore-deployment.md b/docs/testing-deployment-publishing/publishing/google-playstore-deployment.md
index 1e0d7c54..23abf680 100644
--- a/docs/testing-deployment-publishing/publishing/google-playstore-deployment.md
+++ b/docs/testing-deployment-publishing/publishing/google-playstore-deployment.md
@@ -314,57 +314,19 @@ You can now deploy directly from FlutterFlow or from your GitHub repository.
:::info
-- Every time you deploy, we'll auto increment the 'Build Number' (i.e., version code in Android). If needed, you can update the **App Version** and **Build Number** yourself.
+- Every time you deploy, we'll auto increment the **Build Number** (i.e., version code in Android) to ensure that each release is identifiable. If needed, you can update the *App Version* and *Build Number* yourself.
- We'll [**auto-generate**](https://developer.android.com/studio/publish/app-signing#generate-key) and [**sign**](https://developer.android.com/studio/publish/app-signing#sign_release) your app for the release with the Keystore (i.e., upload key). If you wish to download the keystore, click the orange key button.
:::
-
-
- Ensure the **Google Play Track** is set to **Internal** and hit the **Deloy to Play Store** again. On successful deployment, you will see the status as 'finished'.
+Ensure the **Google Play Track** is set to **Internal** and hit the **Deloy to Play Store** again. On successful deployment, you will see the status as 'finished'.
-
-
-
-[Connecting the Github](../exporting-code/push-to-github.md) repo allows you to introduce the custom code into your FlutterFlow project. You may want to deploy the modified code directly from your Github repo to Play Store.
-
-To deploy from Github repo:
-
-1. If you haven't added the Github repo yet, you can do so using the instructions [here](../exporting-code/push-to-github.md).
-2. Navigate to **Settings & Integrations > App Settings >** **Mobile** **Deployment**.
-3. Find the **Deployment Settings** section and click on the arrow icon on the right to open it.
-4. Under the **Deployment Source**, enable the **Use Github repo**.
-5. Enter the **Branch Name** of your repo, from which you want to deploy the code. Make sure to enter the correct branch name.
-
-
-
-
-
-
+:::tip
+If you prefer to manage your deployment process outside of FlutterFlow, such as integrating with your own CI/CD pipeline, or if you want more control over versioning and custom code management directly on GitHub. You also have the option to [**Deploy apps from your GitHub repository**](deploy-from-github.md).
+:::
#### 4.4 Verify deployment
@@ -445,38 +407,3 @@ Watch this video if you prefer watching a video tutorial.
-## FAQs
-
-
-I am having an issue while Deploying from a GitHub branch
-
-
-If you are experiencing problems deploying or uploading to the Google Play Store and are deploying from a Github branch, check to make sure your `build.gradle` file is correct.
-
-1. Open your `android/app/build.gradle` file.
-2. Ensure your file has these lines of code:
-
- ```
- def keystoreProperties = new Properties()
- def keystorePropertiesFile = rootProject.file('key.properties')
- if (keystorePropertiesFile.exists()) {
- keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
- }
- signingConfigs {
- release {
- keyAlias keystoreProperties['keyAlias']
- keyPassword keystoreProperties['keyPassword']
- storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
- storePassword keystoreProperties['storePassword']
- }
- }
- ```
-
-3. Newer Flutterflow code will automatically have these lines added. If yours doesn't, you can push it to your `flutterflow` branch on GitHub and merge in the changes or add them like so:
-
- 
-
-
-4. Lastly, change `debug` (shown in the red box above) to `release` before deploying.
-
-
\ No newline at end of file