updated content, improved formatting

Author: mrdavidorok

docs/troubleshooting/migrate-issues/_category_.json renamed to docs/troubleshooting/test-mode/_category_.json

@@ -33,9 +33,15 @@ This error commonly occurs when building Flutter apps on Android emulators. It i
 
     Run the following command in your project directory:
 
-       ```js
+       ```bash
         flutter clean
+        ```
+
+        ```bash
         flutter pub get
+        ```
+
+        ```bash
         flutter run
         ```
 
@@ -45,14 +51,21 @@ This error commonly occurs when building Flutter apps on Android emulators. It i
 3. **Upgrade Flutter (If Problem Persists)**
 
     If the issue continues, upgrading Flutter may help. Run the command below to upgrade:
-        ```js
+        ```bash
         flutter upgrade
         ```
 
     Ensure your Flutter SDK is up to date. You can verify the version with:
 
-        ```js
+        ```bash
         flutter --version
         ```
 
+    :::note
     This error is often related to Google Play Services not being properly initialized on the emulator. If you're still encountering issues, consider creating a new emulator using a system image that includes the Play Store.
+    :::
+
+:::info[Additional Resources]
+- Read the official **[Flutter Build Documentation](https://docs.flutter.dev/testing/build-modes)**.
+- Check **[Android Emulator System Images](https://developer.android.com/studio/run/managing-avds#system-images)**.
+:::

docs/troubleshooting/migrate-issues/black_screen_during_run_mode.md renamed to docs/troubleshooting/test-mode/black_screen_during_run_mode.md

@@ -13,7 +13,7 @@ If Test Mode takes several minutes to load or fails entirely, the issue may stem
 - You have already deployed or previewed a version of your app.
 :::
 
-Below are the common causes and fixes:
+**Steps to Resolve Slow Loading:**
 
 - **Check Your Internet Connection**
 
@@ -36,7 +36,7 @@ Below are the common causes and fixes:
     Extensions like ad blockers or privacy tools can interfere with FlutterFlow’s platform. Temporarily disable them to check for improvement.
 
 :::tip[Optimize Your Project]
-Projects with many pages, assets, or custom code can take longer to compile.
+Projects with many pages, assets, or custom code may take longer to compile. Follow these steps to optimize your project:
 - Remove unused images, fonts, or icons.
 - Consolidate or simplify custom code.
 - Limit the number of pages in a single testing session.

docs/troubleshooting/migrate-issues/firestore_permission_error-run_mode.md renamed to docs/troubleshooting/test-mode/firestore_permission_error-run_mode.md

@@ -9,21 +9,21 @@ title: Test API Calls
 Verifying an API response before integrating it into your app helps prevent runtime issues and ensures your data is structured correctly. This guide walks you through testing an API directly within FlutterFlow.
 
 :::info[Prerequisites]
-- You must have a project open in FlutterFlow.
-- An API key or endpoint must be available if required by the API.
+- A project is open in FlutterFlow.
+- An API key or endpoint is available if required by the API.
 :::
 
-## Steps to Test API Calls
+**Steps to Test API Calls:**
 
-1. **Open the API Calls Panel**
+1. **Open the `API Calls` Panel**
 
-   From the left sidebar, go to the **API Calls** section.
+   From the left sidebar, go to the `API Calls` section.
 
    ![](../assets/20250430121444122926.png)
 
 2. **Select or Create an API Call**
 
-   Choose an existing API call or click **+ Add API Call** to create a new one.
+   Choose an existing `API Call` or click `+ Add API Call` to create a new one.
 
    ![](../assets/20250430121444364083.png)
 
@@ -33,19 +33,19 @@ Verifying an API response before integrating it into your app helps prevent runt
 
    ![](../assets/20250430121444571412.png)
 
-4. **Click the Response & Test Tab**
+4. **Click the `Response & Test` Tab**
 
-   Navigate to the **Response & Test** tab to preview the response structure.
+   Navigate to the `Response & Test` tab to preview the response structure.
 
    ![](../assets/20250430121444783602.png)
 
 5. **Run the API Test**
 
-   Click the **Test API Call** button to trigger the request. If successful, you’ll see the API response in JSON format.
+   Click the `Test API Call` button to trigger the request. If successful, the API response displays in JSON format.
 
    ![](../assets/20250430121445020637.png)
 
-   A valid API response will display a structured output like the example below:
+   A valid API response displays a structured output like the example below::
 
    ![](../assets/20250430121445238952.png)