Deployment issues article: Fixed typos, added assets, fixed formatting

docs/troubleshooting/deployment/_category_.json

@@ -0,0 +1,3 @@
+{
+  "label": "Deployment"
+}

docs/troubleshooting/deployment/codemagic_deployment_error_identification.md

@@ -0,0 +1,39 @@
+---
+keywords: ['deployment', 'error', 'identification']
+slug: /codemagic-deployment-error-identification
+title: Codemagic Deployment Error Identification
+---
+# Codemagic Deployment Error Identification
+
+## How to Identify Your Codemagic Error
+
+Follow the steps below to identify your codemagic error:
+
+- Press **Cmd/Ctrl + k**, type **"deployment"** and hit enter. It will take you to the deployment page.​
+
+  ![](../assets/20250430121346608131.png)
+
+- Navigate to the Deployment section by clicking **Project Settings** > **Deployment** (under App Settings).​
+
+  ![](../assets/20250430121346890273.png)
+​
+
+- Click on the **Failed (VIEW LOGS)** text to see the logs. ​
+
+  ![](../assets/20250430121347217644.png)
+
+  In this step, you'll need to note the Failed Step that been displayed by CodeMagic error log. ​
+
+  ![](../assets/20250430121347593094.png)
+​
+
+- Now, press **Cmd/Ctrl + F** to search for the term **"error"** in the logs to find the root cause of the issue. Keep pressing **"Enter"** till you find the error ( this is usually at the bottom of the logs ).
+
+  If you search for "error" and still don't find an error message that makes sense to you then you can also try with the following keyword:
+    - message
+
+      ![](../assets/20250430121347925706.png)
+
+    - Now select and copy this error message and paste it in the Help Center search in the chat icon in the bottom-right corner to search the error. This will help you find the help article for this issue and then you can find the fix for it. 
+
+      ![](../assets/20250430121348293622.gif)

docs/troubleshooting/deployment/codemagic_deployment_tips.md

@@ -0,0 +1,15 @@
+---
+keywords: ['deployment', 'tips', 'codemagic']
+slug: /codemagic-deployment-tips
+title: CodeMagic Deployment Tips
+---
+# CodeMagic Deployment Tips
+
+Here are some tips to avoid Deployment issues:
+
+:::tip
+- Make sure you've followed all the steps for setting up deployment in your project.
+- If you choose a deployment source from a GitHub Repository then please make sure that it's associated with FlutterFlow's GitHub integration.
+- If you are deploying to the Play Store from a GitHub repo, make sure to modify your build.gradle file to sign in release mode.
+- Setting a version number is optional but may be required for specific cases. If you are updating an existing app that has not been deployed using FlutterFlow yet, you will want to specify a version number.
+:::

docs/troubleshooting/deployment/deployment_issues_with_stripe_integration.md

@@ -0,0 +1,54 @@
+---
+keywords: ['deployment', 'issues', 'integration']
+slug: /deployment-issues-with-stripe-integration
+title: Deployment Issues with Stripe Integration
+---
+# Deployment Issues with Stripe Integration
+
+Integrating Stripe in your FlutterFlow project can help you accept payments efficiently. However, some common deployment issues may arise. This article outlines key steps and best practices to ensure a smooth Stripe integration and deployment experience.
+
+1. **Firebase Connection**
+
+    Stripe integration requires a connected Firebase project. Before running through this checklist, it's important to ensure your FlutterFlow project is linked to Firebase, a crucial step for successful payment processing. Detailed guidance can be found at [FlutterFlow's Firebase Setup Guide](https://docs.flutterflow.io/data-and-backend/firebase/firebase-setup).
+
+2. **Upgrade to Firebase Blaze Plan**
+
+    Stripe functionality requires a Firebase Blaze Plan for operational capabilities. To avoid disruptions, you will need to upgrade from the Firebase Spark plan to the Blaze plan. Learn more about Google's process for upgrading [here](https://firebase.google.com/docs/projects/billing/firebase-pricing-plans).
+
+3. **Set the Google Cloud Platform (GCP) Location**
+
+    A defined Google Cloud Platform (GCP) location for your Firebase project ensures the correct regional operation of services. The absence of a set location can hinder the deployment process.​
+
+    ![](../assets/20250430121121827511.png)
+
+4. **Firebase Project Permissions**
+
+    Ensure you have the necessary permissions enabled for your Firebase project. Two critical permissions involve access management and service configuration. You can reference the [setup guide](https://docs.flutterflow.io/data-and-backend/firebase/firebase-setup)on FlutterFlow Documentation on FlutterFlow Documentation.​
+
+    ![](../assets/20250430121122068343.png)
+
+5. **Correct Merchant Code**
+
+    Use the correct 3-letter merchant country code (e.g., "GBR" for the United Kingdom vs. "UK"). Incorrect codes can lead to failed transactions. For accurate codes, refer to [IBAN Country Codes](https://www.iban.com/country-codes).​
+
+    ![](../assets/20250430121122307123.png)
+
+    ![](../assets/20250430121122597517.png)
+
+6.  **Test and Live Keys**
+
+    For deployment, both Test and Live Stripe keys must be configured in your project settings, regardless of the development stage. This ensures Stripe's API can properly interact with your application.​
+
+    ![](../assets/20250430121122925141.png)
+
+7. **Consistent Region Settings**
+
+    Align your Firebase project's region with that of your FlutterFlow settings to prevent deployment failures. Inconsistencies can cause function deployment issues.​
+
+    ![](../assets/20250430121123230941.png)
+
+    ![](../assets/20250430121123502329.png)
+
+If you find that this article hasn't fully addressed your concerns or if you have more questions, please don't hesitate to reach out to us at [email protected]
+
+​

docs/troubleshooting/deployment/fixing_razorpay_deployment.md

@@ -0,0 +1,57 @@
+---
+keywords: ['deployment', 'firebase', 'razorpay']
+slug: /fixing-razorpay-deployment
+title: Fixing Razorpay Deployment
+---
+# Fixing Razorpay Deployment
+
+Razorpay is a major payment processor in India. Integrating [Razorpay](https://razorpay.com/) can allow users to make payments using their app. This article outlines some common scenarios and troubleshooting instructions for Razorpay deployment issues.
+
+1. **Firebase Integration and Auth**
+
+    FlutterFlow uses Firebase integration and cloud functions to facilitate Razorpay payments. Ensure you have Firebase configured in your FlutterFlow project and that Firebase Auth is enabled. 
+
+    ![](../assets/20250430121119193097.png)
+    ![](../assets/20250430121119493481.png)
+
+2. **Firebase Blaze Plan**
+
+    Razorpay uses cloud functions behind the scenes to facilitate payments. Cloud functions are a part of Firebase's "Blaze" plan. You must upgrade from the Firebase Spark plan to the Blaze plan to avoid disruptions. Learn how to upgrade here. On the bottom left side of your Firebase console, you will see which plan you are on
+
+    ![](../assets/20250430121119754142.png)
+
+3. **Set Google Cloud Location**
+
+    Ensuring your Firebase project is pinned to a specific Google Cloud Platform (GCP) location is key for optimal service functionality across regions. Skipping this step could result in errors.​
+
+    ![](../assets/20250430121120027064.png)
+
+4. **Firebase Project Permissions**
+
+    Make sure your Firebase project has the required permissions activated. Access management and service configuration are two essential permissions to focus on. For guidance on setting these up, look at the instructions in the [FlutterFlow Project Setup](https://docs.flutterflow.io/resources/projects/settings/project-setup/).
+
+5. **Razorpay Keys Check**
+
+    Make sure to copy and paste the correct Key ID and Key Secret from Razorpay for testing and production, respectively. For testing, make sure "Is Production" is turned off.
+
+    ![](../assets/20250430121120324713.png)
+
+    ![](../assets/20250430121120614698.png)
+
+    ![](../assets/20250430121120833797.png)
+
+6. **Razorpay Business Name**
+
+    Finally, ensure you have entered the proper "Business Name" in the Razorpay additional settings in FlutterFlow. Make sure this business name matches your business name in Razorpay records. 
+
+    ![](../assets/20250430121121100378.png)
+
+:::info[Other Considerations]
+Razorpay currently works only on mobile (Android and iOS). This is due to a limitation from Razorpay's Flutter Package. If you are planning to collect payments on a web app - consider using Stripe.
+
+![](../assets/20250430121121294657.png)
+
+:::
+
+If you are still facing issue with deploying Razorpay on Flutterflow, please feel free to reach out to [email protected]
+

docs/troubleshooting/deployment/fixing_stripe_deployment_and_payment_errors.md

@@ -0,0 +1,106 @@
+---
+keywords: ['deployment', 'payment', 'issues']
+slug: /fixing-stripe-deployment-and-payment-errors
+title: Fixing Stripe Deployment & Payment Errors
+---
+# Fixing Stripe Deployment & Payment Errors
+
+Integrating Stripe for payment processing in FlutterFlow can significantly simplify monetization. However, developers may encounter issues during deployment or while managing transactions. This guide outlines common deployment and payment issues—and how to fix them—to help ensure a seamless Stripe integration experience in FlutterFlow apps.
+
+## Deployment Checklist for Stripe Integration
+
+1. **Firebase Connection**
+
+    Stripe integration requires a connected Firebase project. Before running through this checklist, it's important to ensure your FlutterFlow project is linked to Firebase, a crucial step for successful payment processing. Detailed guidance can be found at [FlutterFlow's Firebase Setup Guide](https://docs.flutterflow.io/data-and-backend/firebase/firebase-setup).
+
+2. **Upgrade to Firebase Blaze Plan**
+
+    Stripe functionality requires a Firebase Blaze Plan for operational capabilities. To avoid disruptions, you will need to upgrade from the Firebase Spark plan to the Blaze plan. Learn more about Google's process for upgrading [here](https://firebase.google.com/docs/projects/billing/firebase-pricing-plans).
+
+3. **Set the Google Cloud Platform (GCP) Location**
+
+    A defined Google Cloud Platform (GCP) location for your Firebase project ensures the correct regional operation of services. The absence of a set location can hinder the deployment process.​
+
+    ![](../assets/20250430121145711998.png)
+
+4. **Firebase Project Permissions**
+
+    Ensure you have the necessary permissions enabled for your Firebase project. Two critical permissions involve access management and service configuration. You can reference the [setup guide](https://docs.flutterflow.io/data-and-backend/firebase/firebase-setup) on FlutterFlow Documentation.​
+
+    ![](../assets/20250430121145949036.png)
+
+5. **Correct Merchant Code**
+
+    Use the correct 3-letter merchant country code (example., "GBR" for the United Kingdom vs. "UK"). Incorrect codes can lead to failed transactions. For accurate codes, refer to [IBAN Country Codes](https://www.iban.com/country-codes).​
+
+    ![](../assets/20250430121146161973.png)
+
+    ![](../assets/20250430121146400049.png)
+
+6. **Test and Live Keys**
+
+    Both Test and Live Stripe keys must be configured in your project settings, regardless of the development stage. This ensures Stripe's API can properly interact with your application.​
+
+    ![](../assets/20250430121146604033.png)
+
+7. **Consistent Region Settings**
+
+    Align your Firebase project's region with that of your FlutterFlow settings to prevent deployment failures. Inconsistencies can cause function deployment issues.​
+
+    ![](../assets/20250430121146854018.png)
+
+    ![](../assets/20250430121147068781.png)
+
+## Addressing Payment Transaction Issues
+
+1. **Authentication Requirement**
+
+    Stripe payments **require an authenticated user session**. Before initiating payment processes, ensure your application logic includes user login or account creation.
+
+2. **Payment Modal Variations**
+
+    It's important to note that web and mobile platforms present different payment modal presentations. These UI differences are out-of-the-box for Stripe and cannot currently be customized within FlutterFlow.
+
+3. **Price Format**
+
+    Prices should be submitted to Stripe in **cents**, not **dollars**. Utilize a custom function to convert dollar values to cents for accurate transaction processing.​To set a price in cents to Stripe, you can simply use a custom function that takes the price in dollars and returns it as cents.​
+
+    Here is a custom code you can use to make this calculation in a custom function: 
+
+    ```js
+    int dollarToCent(double amount) {
+    // Convert the amount to a string
+    String st = amount.toString();
+
+    // Remove any dots or commas
+    st = st.replaceAll('.', '');
+    st = st.replaceAll(',', '');
+
+    // Convert the cleaned string to an integer
+    return int.parse(st);
+    }
+    ```
+
+    // Input: 14.99
+
+    // Output: 1499 cents
+
+
+4. **CORS Error Resolution**
+
+    A CORS error during payment initiation often indicates a permissions issue with your Firebase function. Verify and adjust the `allUsers` permission for your Stripe function in the Firebase console to resolve this error.​
+
+    ![](../assets/20250430121147385978.png)
+
+    ![](../assets/20250430121147683388.png)
+
+5. **Subscriptions**
+
+    Currently, Apple and Google restrict Stripe subscriptions on mobile platforms. To expand your subscription capabilities, you can use alternative solutions like RevenueCat for mobile apps and direct API calls for web applications.​
+
+:::info[**For further information and troubleshooting:**] 
+- [Stripe Documentation](https://stripe.com/docs)
+- [Stripe Payments](https://stripe.com/payments)
+- [FlutterFlow University](https://university.flutterflow.io/)
+- [Payments - Intro | FlutterFlow University](https://university.flutterflow.io/courses/flutterflow-payments)
+:::

docs/troubleshooting/deployment/resolve_errors_in_downloaded_code.md

@@ -0,0 +1,38 @@
+---
+keywords: ['flutter', 'downloaded', 'code']
+slug: /resolve-errors-in-downloaded-code
+title: Resolve Errors in Downloaded Code
+---
+# Resolve Errors in Downloaded Code
+
+When you download your project from FlutterFlow and run it locally in your IDE, you may encounter errors due to Flutter version mismatches. This guide outlines how to resolve these issues by ensuring your local Flutter version matches the version supported by FlutterFlow.
+
+1. **Check FlutterFlow’s supported Flutter version**
+
+    To find the Flutter version currently supported by FlutterFlow:
+        - Open the FlutterFlow dashboard.
+        - Navigate to your project settings or export screen.
+        - Locate the displayed Flutter version used for your project.
+
+        ![](../assets/20250430121137152872.png)
+
+2. **Verify the Flutter version on your machine**
+
+    To check the Flutter version installed locally, run the following command in your terminal:
+
+        ```js
+        flutter --version
+        ```
+        Here's an example of how you can do that:
+
+        ![](../assets/20250430121137421780.png)​
+
+3. **Upgrading or Downgrading to the correct Flutter version**
+
+    If the current version on your machine is different than what is currently supported by FlutterFlow, you can downgrade or upgrade to the supported version. You can learn more about upgrading our Flutter [here](https://docs.flutterflow.io/deploying-your-app/testing-your-app/testing-on-mobile-device#id-2.-verify-correct-flutter-version). ​By following these steps, you can fix the errors that you face after downloading the code and run locally. 
+
+If you continue to experience issues, contact the FlutterFlow support team via live chat or email at [email protected].
+
+
+
+