Merge branch 'main' into fix/responsive-values

Author: PoojaB26

docs/accounts-billing/new-pricing-comparison.md

@@ -380,7 +380,7 @@ export const PricingToggles = () => {
           </tr>
           <tr>
             <td>Cloud Functions<br/><span className="feature-description">Write and deploy Firebase Cloud Functions directly from FlutterFlow</span></td>
-            <td>❌</td>
+            <td>✅</td>
             <td>✅</td>
             <td>✅</td>
             <td>✅</td>

docs/ff-concepts/adding-customization/custom-code.md

@@ -68,7 +68,9 @@ necessary code.
 This can significantly speed up the building process and reduce the need for in-depth programming
 knowledge, making it especially useful for custom functions and actions.
 
-**Limitation:** The prompts are limited to 100 characters currently.
+:::info[Limitation]
+Your prompt must be at least 3 words and no more than 500 characters.
+:::
 
 <div style={{
     position: 'relative',

docs/resources/control-flow/functions/img/execute-custom-code.avif

@@ -100,6 +100,10 @@ To add inline function, open the Set from Variable dialog wherever it's possible
 
 For example, we may want to quickly calculate the discount amount of a product where the discount is 18% of the MRP of the product. The expression would be `cost - (cost * discount)`.
 
+:::tip
+Looking for more power and flexibility? Use the new [**Custom Code Expression**](#custom-code-expression). It’s a more advanced version of Inline Functions that lets you access FlutterFlow generated resources without passing them as arguments. You also get real-time autocomplete and inline error checking for faster, more accurate logic.
+:::
+
 **Precedence of operations**
 
 Inline Function for math operations follow typical precedence (e.g., multiplication/division before addition/subtraction), but parentheses can change the order.
@@ -162,6 +166,79 @@ Here are some common expressions you can use for your business logic:
 | `int.parse(s)`                     | Convert the **String** into an **integer.**             | `int.parse(stringValue)`   | `int`            |
 
 
+## Custom Code Expression
+
+**Custom Code Expression** lets you write short Dart code directly in widget property fields and action flows in FlutterFlow. It’s a more powerful version of [**Inline Function**](#inline-function-code-expressions), allowing you to directly access FlutterFlow generated classes, global variables, widget properties, parameters, and more without needing to manually pass them as inputs.
+
+Custom Code Expressions also support real-time autocomplete, making it easy to discover available fields as you type. For example, when you type `FFAppState().`, it will suggest all available app state variables along with their types.
+
+In addition, inline validation provides immediate feedback as you write, helping you catch syntax errors or invalid property references.
+
+:::info
+To use Custom Code Expression, you must have an active [**FlutterFlow paid plan**](https://www.flutterflow.io/pricing).
+:::
+
+:::tip
+- To explore what you can access within a Custom code expression, refer to the [**Common Examples**](../../../ff-concepts/adding-customization/common-examples.md) page.
+- Press `^ + Space` (or `Ctrl + Space`) while typing to see suggestions for what you can access in your Custom code expression.
+- You can access values inside custom structs. For example, you can use `FFAppState().localDeviceInfo.osVersion` if that field exists in your app state.
+- To use Custom code expressions better, it's helpful to understand how FlutterFlow builds your project behind the scenes. You can check the [**State Management**](../../../generated-code/state-mgmt-gen-code.md) page and other **Generated Code** sections to learn how everything is set up.
+
+:::
+
+Here are a couple of examples showing how to access App State and Page State within a Custom code expression:
+
+- **App State Access:** For example, to check if dark mode is enabled using an App State variable:
+
+    ```jsx
+    FFAppState().enableDarkMode ? 'Dark Mode On' : 'Light Mode Off'
+    ```
+
+    This accesses the global `enableDarkMode` boolean stored in `FFAppState`, and returns a string based on its value.
+
+- **Page and Component State Access:** For example, to access a page or component state variable like `searchText`, you start with `_model.` and then select the variable from the autocomplete suggestions.
+
+    ```jsx
+    _model.searchText.isEmpty ? '' : 'Searching for "${_model.searchText}"'
+    ```
+
+    This expression checks if the `searchText` variable (defined as a page state) is empty, and returns an appropriate message. The `_model` object refers to the current page’s generated state model.
+
+Here's an example of adding a Custom Code Expression:
+
+<div style={{
+    position: 'relative',
+    paddingBottom: 'calc(56.67989417989418% + 41px)', // Keeps the aspect ratio and additional padding
+    height: 0,
+    width: '100%'}}>
+    <iframe 
+        src="https://demo.arcade.software/6RV03v2ByVqRgCTeg3QF?embed&show_copy_link=true"
+        title=""
+        style={{
+            position: 'absolute',
+            top: 0,
+            left: 0,
+            width: '100%',
+            height: '100%',
+            colorScheme: 'light'
+        }}
+        frameborder="0"
+        loading="lazy"
+        webkitAllowFullScreen
+        mozAllowFullScreen
+        allowFullScreen
+        allow="clipboard-write">
+    </iframe>
+</div>
+<p></p>
+
+### Execute Custom Code [Action]
+
+To use a Custom Code Expression when triggering actions in FlutterFlow (i.e., inside an Action Flow), you can use the **Execute Custom Code** action. This allows you to run a Dart expression when something happens, such as tapping a button or after a page loads.
+
+![execute-custom-code.avif](img/execute-custom-code.avif)
+
+The Execute Custom Code action can be really helpful in scenarios where the home page is removed early from the navigation stack and standard navigation using the local context may fail. To prevent this, you can [use the global navigator context](../../../ff-concepts/navigation-routing/deep-dynamic-linking.md#using-global-context-to-navigate) inside a code expression.
 
 ## Custom Functions
 
@@ -170,3 +247,18 @@ You can also use custom functions to handle slightly more complex calculations o
 :::info
 Learn more about [**Custom Functions**](../../../ff-concepts/adding-customization/custom-functions.md).
 :::
+
+## FAQS
+<details>
+<summary>
+How is a Custom Code Expression different from an Inline Function?
+</summary>
+<p>
+Custom Code Expression is a more advanced and flexible version of Inline Function.
+
+With Inline Functions, you had to manually pass values as arguments. In contrast, Custom Code Expressions let you directly reference FlutterFlow generated resources (such as `FFAppState()`, `_model`, context, and more) without needing to pass them in.
+
+You can write any valid Dart expression in a Custom code expression, even multi-line logic using anonymous functions. Plus, Custom Code Expressions support real-time autocomplete and inline error validation, making it much easier to discover available variables and avoid mistakes.
+
+</p>
+</details>

docs/resources/control-flow/functions/utility-functions.md

@@ -114,3 +114,17 @@ Here's a quick guide to updating the app state variable. We need to add an actio
     </iframe>
 </div>
 
+## FAQs
+
+<details>
+<summary>
+Why are some variable types not available in App State?
+</summary>
+<p>
+Certain variable types, e.g., **Firestore Documents** and **Supabase Row**, can be used in Page State or Component State, but not in App State. This is because App State variables are designed to be global, meaning they stay in memory throughout the app. When App State variables are marked as persisted, the variable’s value is saved to the device’s local storage.
+
+Storing large or complex data types like documents in App State could lead to **performance or size issues**, especially on lower-end devices. For this reason, FlutterFlow limits App State to lightweight types, while Page/Component State allows for more flexibility since their scope is smaller and temporary.
+
+If you need to work with such data types, it's recommended to store them in Page or Component state instead.
+</p>
+</details>

docs/resources/data-representation/app-state.md

@@ -68,7 +68,42 @@ When naming custom data types, always use **UpperCamelCase**, as recommended by
 
 ## Accessing Custom Data Type
 
-After creating the custom data type, you can use it to create variables, such as an app state variable, and then access them. Here's an [example](app-state.md#app-state-variables).
+After creating a custom data type, it’s treated internally as a [Dart class](https://dart.dev/language/classes). However, just defining the custom data type doesn’t hold any real data. To work with actual data, such as storing a user profile or a review, you need to create an **instance** of custom data type.
+
+Creating an instance allows you to:
+
+- Assign specific values to each field in your custom data type.
+- Store the instance in app state, page state, or pass it between widgets.
+- Access individual fields wherever needed.
+
+To create an instance of a custom data type, first you need to [create a state variable](../../ff-concepts/state-management/state-variables.md#creating-state-variables) (of type **Data Type**) that will hold the instance. Then, to create and add the instance to the state variable, open the **Set from Variable** dialog and select **Create Data Type Object > Project Data Type**. Choose the data type you want to use. After that, set values for each of the required fields.
+
+
+<div style={{
+    position: 'relative',
+    paddingBottom: 'calc(56.67989417989418% + 41px)', // Keeps the aspect ratio and additional padding
+    height: 0,
+    width: '100%'}}>
+    <iframe 
+        src="https://demo.arcade.software/qNNwqEm7vrvuWszmhf9R?embed&show_copy_link=true"
+        title=""
+        style={{
+            position: 'absolute',
+            top: 0,
+            left: 0,
+            width: '100%',
+            height: '100%',
+            colorScheme: 'light'
+        }}
+        frameborder="0"
+        loading="lazy"
+        webkitAllowFullScreen
+        mozAllowFullScreen
+        allowFullScreen
+        allow="clipboard-write">
+    </iframe>
+</div>
+<p></p>
 
 ### Custom Data Type in Custom Code
 Sometimes, you might want to access the custom data type in your custom code. Our custom code editor allows you to receive and pass data into a variable of a custom data type. For example, you could manipulate or analyze the data as needed, and then return the modified result in the custom data type. 

docs/resources/data-representation/custom-data-types.md

@@ -105,10 +105,11 @@ Below is a list of available API endpoints with their methods and usage descript
 
 | Endpoint                    | Method | Purpose                                       |
 | --------------------------- | ------ | --------------------------------------------- |
-| `/listPartitionedFileNames` | GET    | List available YAML file names for a project  |
-| `/projectYamls`             | GET    | Export/download YAML files from a project     |
-| `/validateProjectYaml`      | POST   | Validate YAML content before applying changes |
-| `/updateProjectYaml`        | POST   | Update project configuration via YAML         |
+| `/listPartitionedFileNames` | GET    | List available YAML file names for a project.  |
+| `/l/listProjects`           | POST   | Retrieve metadata for all projects.            |
+| `/projectYamls`             | GET    | Export/download YAML files from a project.     |
+| `/validateProjectYaml`      | POST   | Validate YAML content before applying changes. |
+| `/updateProjectYaml`        | POST   | Update project configuration via YAML.         |
 
 
 ### List File Names
@@ -152,7 +153,83 @@ curl -X GET \
   -H 'Authorization: Bearer YOUR_API_TOKEN'
 ```
 
+### List Projects
 
+This endpoint retrieves a list of FlutterFlow projects associated with your account, including detailed metadata such as project name, owner email, team info, collaboration settings, and versioning data.
+
+#### Endpoint
+
+`POST /l/listProjects`
+
+#### Request Body
+
+```jsx
+{
+  "project_type": "ALL",
+  "deserialize_response": true
+}
+```
+- **`project_type: "ALL"`**: Use "ALL" to include personal, team, and shared projects, or "TEAM_RESOURCE" to include only team-associated projects.
+
+- **`deserialize_response: true`**: Ensures the response is returned as human-readable JSON instead of a base64-encoded protobuf.
+
+:::tip
+It’s recommended to use the default options: `"ALL"` for `project_type` and `true` for `deserialize_response` for the most complete and readable results.
+:::
+
+#### Response
+
+Returns a JSON object containing an array of projects under the `entries` key. Each entry contains the project ID and rich metadata, including collaborators, app icons, sessions, and branching information.
+
+```jsx
+{
+  "success": true,
+  "reason": null,
+  "value": {
+    "entries": [
+      {
+        "id": "XXXXXXXXXXXXXXX",
+        "project": {
+          "name": "Sample Project A",
+          "ownerEmail": "[email protected]",
+          "createdAt": "2024-08-08T11:01:12.427Z",
+          "updatedAt": "2024-08-08T11:01:18.669Z",
+          "teamRef": {
+            "path": "teams/TEAM_ID_1"
+          },
+          "mainBranchRef": {
+            "path": "projects/sample-project-id"
+          },
+          "numBranches": 2,
+          "otherMembers": {
+            "USER_XYZ": {
+              "email": "[email protected]",
+              "accessLevel": "EDITOR"
+            }
+          },
+          "activeSessions": {
+            "SESSION_ID_1": {
+              "lastSuccessfulUpdate": "2024-08-06T18:41:56.569Z"
+            }
+          },
+          "totalNumUpdates": 2177
+        }
+      }
+    ]
+  }
+}
+```
+
+#### Example Usage
+
+```jsx
+curl 'https://api.flutterflow.io/v2/l/listProjects' \
+  -H 'authorization: Bearer YOUR_API_TOKEN' \
+  --data-raw '{
+    "project_type": "ALL",
+    "deserialize_response": true
+  }'
+```
 
 ### Download Project YAML
 

docs/resources/projects/settings/project-apis.md

@@ -151,7 +151,7 @@ By default, the *Tooltip* appears below the target widget. You can change this s
 
 ### Customize tail size
 
-To change the tail's size, you can use the **Tail Width** and **Tail Lenght** properties.
+To change the tail's size, you can use the **Tail Width** and **Tail Length** properties.
 
 <div style={{
     position: 'relative',
@@ -269,4 +269,4 @@ To change the default duration, move to the **Properties Panel >** set the **Sho
         allowFullScreen
         allow="clipboard-write">
     </iframe>
-</div>
+</div>

docs/resources/ui/widgets/built-in-widgets/tooltip.md

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

docs/troubleshooting/apple-store-deployment-issues/_category_.json

@@ -0,0 +1,3 @@
+{
+  "label": "Fetching Signing Files"
+}