Merge branch 'main' into pinkesh/on-dispose

Author: pinkeshmars

docs/ff-concepts/alerts-notification/imgs/enable-push-notification.avif

@@ -38,10 +38,6 @@ These steps are mandatory if you want to send push notifications to iOS devices:
 
 Here are the steps to send push notifications:
 
-1. [Enabling push notification](#enabling-push-notification)
-2. [Only for iOS: Configuring iOS app](#only-for-ios-configuring-ios-app)
-3. [Sending push notifications](#sending-push-notifications)
-
 ### Enabling push notification
 
 :::warning
@@ -54,12 +50,18 @@ Here are the steps to send push notifications:
 
 To enable push notifications:
 
-1. Click on the **Settings and Integrations** -> App Settings -> **Push Notifications** and 
+1. Navigate to the **Settings and Integrations -> App Settings -> Push Notifications** and 
 **Enable Push Notifications**.
 2. Now, click on the **Deploy** button. This will create and deploy the *Cloud Functions* in your 
    Firebase project that are necessary for push notifications to work.
 
-![img.png](imgs/img.png)
+![img.png](imgs/enable-push-notification.avif)
+
+:::info
+By default, the **Automatically Prompt Users for Permission** option is enabled, meaning your app will automatically prompt users requesting for permission to receive push notifications when the app is started. However, this may be disruptive to your user sign-in flow.
+
+If you disable it, you can control when the permission is requested. To do so, you will need to manually [**Request Permission**](../../resources/projects/settings/project-setup.md#request-permission-action) at the appropriate point in your app. **It is recommended to keep this option always enabled**.
+:::
 
 ### Only for iOS: Configuring iOS app
 

docs/ff-concepts/alerts-notification/push-notifications.md

@@ -104,7 +104,7 @@ Here’s how you can add the Supabase reset password feature to your app:
 
 1. On the **ForgotPassword Page**, add the **Send Reset Password Email** action and set the **Email Field** dropdown to the widget that accepts the user's email address. This action will send the reset password link to the provided email.
 2. The reset link sent to the user will open the **UpdatePassword Page**. On that page, add the **Update Password** action and set the **Password Field** and **Confirm Password Field** to the respective input widgets.
-3. Copy the route name of the **UpdatePassword Page** and paste it into the **Supabase Dashboard > Authentication > Email Templates > Reset Password > Source**. Just after **`"{{ .ConfirmationURL}}[here]"`**. This ensures that when users click the reset link, they are directed to the **UpdatePassword** page to set their new password.
+3. Copy the route name of the **UpdatePassword Page** and paste it into the **Supabase Dashboard > Authentication > Email Templates > Reset Password > Source**. After **`"{{ .ConfirmationURL}}"`** add **`"/[here]"`** only if you're not using a custom redirect URL. If using a custom redirect URL, the confirmation URL will redirect directly to your specified path.
 4. [Deploy your app to the web](../../../testing-deployment-publishing/publishing/web-publishing.md).
 5. Copy the URL of your deployed project and paste it into the **Supabase Dashboard > Authentication > URL Configuration > Site URL**.
 

docs/ff-integrations/authentication/supabase-auth/auth-actions.md

@@ -261,26 +261,37 @@ com/embed/238400b5445b444db712f492584b0d6e?sid=7b496882-0280-4920-924c-640fddeff
 
 To do so:
 
-1. Ensure you have **Query Collection** or **Document from Reference** added on a widget with **Single Time Query** disabled.
-2. Now select the widget, head over to **Actions**, and click **+ Add Action**.
-3. Select the **On Data Change** tab. That means actions added under this will be called whenever the data changes.
-4. Now, you can 
-[add any Action](../../../resources/control-flow/functions/action-flow-editor.md#adding-an-action-example) 
-   here.
+1. Ensure you have added a **Query Collection** or **Document from Reference** on a widget with **Single Time Query** disabled.
+2. Now, on the widget with **Query Collection** or **Document from Reference**, open the **Action Flow Editor** and set **On Data Change** as the [Action Trigger](../../../resources/control-flow/functions/action-triggers.md). This ensures that any actions you add will be triggered whenever the data is updated, added, or deleted.
+3. You can now [add any action](../../../resources/control-flow/functions/action-flow-editor.md#adding-an-action-example) you want to perform, such as showing a notification, refreshing the UI, or fetching related data.
 
 :::info
-* Actions will be triggered whenever the data is added, updated, or deleted.
-* If you are adding this on ListView, ensure you disable the infinite scroll.
+If you are using this trigger on a ListView, make sure to **disable** the **Infinite Scroll**.
 :::
 
-Here is an example showing the 
-[**Snackbar**](../../../resources/ui/pages/page-elements.md#show-snackbar-action)
-message when the data 
-changes in a collection.
-
-<figure>
-    ![img_27.png](img_27.png)
-  <figcaption class="centered-caption">Trigger snackbar action on data change</figcaption>
-</figure>
-
+<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/ghFiQWGsQuJu5reUyXnl?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>
 

docs/ff-integrations/database/cloud-firestore/firestore-actions.md

@@ -174,7 +174,17 @@ Let's see how to filter the Supabase table to display only desired items:
 - Find the **Value** property and set it to an appropriate value and click Confirm.
 
 :::tip
-You could choose a Filter relation based on your requirements. For example, to show only completed assignments, set the Field Name to the column that holds completed status, e.g., is_done, set the Relation to Equal To, and set the Value to True. Here's another example. For showing only users older than 30, create a column called Age, set the Relation to Greater Than, and set the Value to 30.
+You could choose a filter relation based on your requirements. For example:
+
+- **Equal To**: To show only completed assignments, set the **Field Name** to the column that holds the completion status (e.g., **is_done**), set the **Relation** to **Equal To**, and set the **Value** to **True**.
+- **Greater Than**: To show only users older than 30, set the **Field Name** to the **age** column, set the **Relation** to **Greater Than**, and set the **Value** to 30.
+- **Like**: For filtering addresses with zip codes starting with '35,' set the **Field Name** to the **zip_code** column, set the **Relation** to **LIKE**, and set the **Value** to **35%**. In the value field, you use the following wildcards to perform flexible pattern matching to filter your data effectively.
+    - **Percent (`%`) Wildcard**: Represents zero, one, or multiple characters.
+        - Example: `'A%'` matches any string starting with `'A'` (e.g., `'Apple'`, `'Apex'`).
+        - Example: `'%A%'` matches any string containing `'A'` (e.g., `'Canada'`, `'Australia'`).
+    - **Underscore (`_`) Wildcard**: Represents a single character.
+        - Example: `'A_'` matches any two-character string starting with `'A'` (e.g., `'An'`, `'At'`).
+        - Example: `'A__'` matches any three-character string starting with `'A'` (e.g., `'Ant'`, `'Art'`).
 :::
 
 <div class="video-container"><iframe src="https://www.loom.
@@ -204,6 +214,42 @@ com/embed/244eea2a4f694120b08524b7b8cf67de?sid=13d47ef5-5d48-4986-88da-d335ce23b
 Additional Note: Currently, you can only add "and" conditions to Supabase query filters. If you want to add an "or" filter like "status == 5 or status == 8", you can consider logic to apply "status in (5,8)" or any other logic. Fully customizable using API calls or custom actions.
 :::
 
+## Trigger Action On Data Change
 
+Sometimes, you may want to trigger an action whenever data changes in a Supabase table. For instance, in an ecommerce app, you might want to notify users on the orders page when the status of their order is updated.
 
+To respond to data changes in a Supabase table:
 
+1. Ensure you have added a **Supabase Query** to a widget (e.g., a ListView) with **Single Time Query** disabled to enable real-time updates.
+2. On the widget with the **Supabase Query**, open the **Action Flow Editor** and set **On Data Change** as the [Action Trigger](../../../resources/control-flow/functions/action-triggers.md). This ensures that any actions you add will be triggered whenever the data is updated, added, or deleted.
+3. You can now [add any action](../../../resources/control-flow/functions/action-flow-editor.md#adding-an-action-example) you want to perform, such as showing a notification, refreshing the UI, or fetching related data.
+
+:::info
+If you are using this trigger on a ListView, make sure to **disable** the **Infinite Scroll**.
+:::
+
+<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/ghFiQWGsQuJu5reUyXnl?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>

docs/ff-integrations/database/supabase/database-actions.md

@@ -20,6 +20,8 @@ Please review our [**Submission Guidelines**](submission-criteria.md) and our [*
 
 ## How to Submit an Item
 
+An item can be an enitre project (in the case of Temlate Apps or Libraries), a page or a component (in the case of Template Page & Components) or a Custom Function, Action or Widget (in the case of Custom Code).
+
 ### 1. Set your project as a Marketplace project
 
 Marketplace items should belong to projects that are specifically made to publish Marketplace items (i.e., they should not be inside of a production project).
@@ -91,21 +93,37 @@ Provide clear and concise instructions on how to implement and utilize your item
 
 #### Marketplace Item Type
 
-Three types of items can be submitted:
+Four types of items can be submitted:
+
+- Libraries
+- Template Apps
+- Template Page or Components
+- Custom Code 
+
 
-**Template AppPage or ComponentCustom Code**
 <Tabs>
-<TabItem value="1" label="Template App" default>
+<TabItem value="1" label="Libraries" default>
+Libraries allow you to share resources like API endpoints, UI components, custom data types, custom code, action blocks and more with complete version control.
+
+To submit a Library to the Marketplace, first publish your project as a Library. Note that there are some limitations on Library projects - most notably there is currently no support for Firebase or Pages.
+
+For more details, see the [documentation on Libraries](/docs/resources/projects/libraries.md).
+
+:::note
+*Libraries* can be monetized. The minimum price for Libraries is $50.
+:::
+</TabItem>
+<TabItem value="2" label="Template App" default>
 Template apps contain multiple screens. There are 2 sub-types:
 
 - **Full App:** an app with authentication, complete navigation, multiple pages/flows, database schema, complete action trees, etc.
 - **UI Kit**: purely design-based templates and layouts
 
 :::note
-*Template Apps* can be monetized. The minimum price for Template Apps is $200.
+*Template Apps* can be monetized. The minimum price for Full Apps is $400 while the minimum for UI Kits is $50.
 :::
 </TabItem>
-<TabItem value="2" label="Page or Component">
+<TabItem value="3" label="Page or Component">
 Pages or Components are assembled modules that can be used within FlutterFlow. There are 2 sub-types:
 
 - **Page:** a single page in a FlutterFlow project
@@ -115,7 +133,7 @@ Pages or Components are assembled modules that can be used within FlutterFlow. T
 *Pages and Components* cannot be monetized at this time.
 :::
 </TabItem>
-<TabItem value="3" label="Custom Code">
+<TabItem value="4" label="Custom Code">
 Custom Code is Dart code that can be used within FlutterFlow projects. There are 3 sub-types:
 
 - **Custom Functions:** synchronous functions that do not have external dependencies.

docs/marketplace/creators-hub/submit-item-for-reivew.md

@@ -11,32 +11,49 @@ keywords: [FlutterFlow, MarketPlace, Submit Feedback]
 
 At FlutterFlow Marketplace, your feedback is crucial to improving the quality and reliability of the items available. There are three main ways to submit feedback:
 
-### Contact the Item Creator
+## Contact the Item Creator
 
 For direct feedback or questions, we recommend contacting the item creator. This is great for providing constructive feedback or for support with minor item issues:
 
+**Via Item Detail Page:**
+
+1. Navigate to the item's detail page on Marketplace.
+2. Click the **Contact the creator** button. This action will launch a new email draft with the creator's official email address pre-filled.
+
+**Via Creator's Profile:**
+
 1. Navigate to the creator's profile on Marketplace.
 2. Click the **Contact** button. This action will copy the creator's official email address to your clipboard.
 3. Send an Email to the copied email address.
 
-### Rate an Item
+## Rate an Item
 
 You can rate items you have used, which helps other users make informed decisions:
 
+**Via Item Detail Page:**
+
+1. Navigate to the item's detail page on Marketplace.
+2. Navigate to the **Reviews** tab.
+3. Click **Add a review**.
+4. Select a star rating from 1 to 5, where 5 is the highest.
+5. Optionally, add a comment to your rating. Please keep your feedback respectful and honest.
+
+**Via Dashboard:**
+
 1. Go to the **Usage History** tab of your [dashboard](https://marketplace.flutterflow.io/dashboard).
 2. Find the item you want to rate and click on the stars next to it.
 3. Select a star rating from 1 to 5, where 5 is the highest.
 4. Optionally, add a comment to your rating. Please keep your feedback respectful and honest.
 
-### Report an Item
+## Report an Item
 
 If you encounter any issues with an item that may require our attention, such as copyright or trademark infringements, or severe quality issues, you can report it. Reports are submitted anonymously and will alert both the creator and our Marketplace team.
 
 1. Navigate to the item's detail page in Marketplace.
-2. Click **Report this item**
+2. Click **Report this item** button.
 3. Choose a report type and clearly describe the issue, including external URLs if necessary.
 4. Click **Submit**
 
 :::tip
 If you are the original author or copyright holder of content that has been uploaded to the FlutterFlow Marketplace without your permission, you can file DMCA takedown request following the instructions in [**FlutterFlow's Terms of Service**](https://flutterflow.io/tos).
-:::
+:::

docs/marketplace/submit-feedback.md

@@ -615,14 +615,18 @@ To make the API call private, open the **Advanced Settings** tab, turn on the **
 
 Optionally, you can force a user to be authenticated via the Firebase authentication to make this API call. To do so, turn on the **Require Authentication** toggle.
 
+
 :::info
-* If you make the API call private, **Firebase** should be connected to your project. Follow the 
-  instructions on 
-[**this page**](../../../../ff-integrations/firebase/connect-to-firebase-setup.md) for integrating Firebase with FlutterFlow.
-* If you enable the **Require Authentication** toggle, **Firebase Authentication** must be 
-  configured appropriately. Check out 
-[this page](../../../../ff-integrations/authentication/firebase-auth/auth-initial-setup.md) for 
-  setting up authentication.
+
+Private APIs are deployed as [**Cloud Functions**](https://firebase.google.com/docs/functions) within your Firebase project. While deploying, you can configure the following options:
+
+- **Use Custom Name for Cloud Function**: When enabled, allows you to specify a custom name for the deployed Cloud Function. By default, this option is disabled and Cloud Function is named as `ffPrivateApiCall`.
+- **Private API Cloud Function Instances**: You can configure the number of Cloud Function instances to optimize performance and manage costs.
+    - **Min Instances**: Set the minimum number of active instances to reduce latency and avoid cold starts. Setting this value greater than 0 will keep instances warm but may incur additional costs.
+    - **Max Instances**: Define the maximum number of instances that can be scaled up based on demand.
+    
+    **Note**: To minimize costs, you can set the **Min Instances** value to 0. For detailed pricing information, refer to the [**Cloud Functions Pricing page**](https://cloud.google.com/functions/pricing-overview).
+  
 :::
 
 <div style={{
@@ -632,7 +636,7 @@ Optionally, you can force a user to be authenticated via the Firebase authentica
     width: '100%'
 }}>
     <iframe 
-        src="https://demo.arcade.software/xoPi2UVZuw3JMqyXPeau?embed&show_copy_link=true"
+        src="https://demo.arcade.software/TLjzzkK3n9PQGBFDte4L?embed&show_copy_link=true"
         title=""
         style={{
             position: 'absolute',
@@ -651,6 +655,16 @@ Optionally, you can force a user to be authenticated via the Firebase authentica
     </iframe>
 </div>
 
+:::note
+* If you make the API call private, **Firebase** should be connected to your project. Follow the 
+  instructions on 
+[**this page**](../../../../ff-integrations/firebase/connect-to-firebase-setup.md) for integrating Firebase with FlutterFlow.
+* If you enable the **Require Authentication** toggle, **Firebase Authentication** must be 
+  configured appropriately. Check out 
+[**this page**](../../../../ff-integrations/authentication/firebase-auth/auth-initial-setup.md) for 
+  setting up authentication.
+:::
+
 ### Process Streaming Response
 
 When working with APIs that send data continuously, like Server Sent Events (SSE), you can enable this option. This ensures your app can handle the ongoing flow of data over a long-lasting HTTP connection to display real-time updates.

docs/resources/control-flow/backend-logic/api/rest-api.md

@@ -183,3 +183,9 @@ No, FlutterFlow does not use Flutter flavors. Instead, it generates code based o
 </p>
 </details>
 
+<details>
+<summary>How to deploy apps for different environments?</summary>
+<p>
+You can configure deployment settings for each environment using the dropdown interface on the deployment page. For mobile, set a new package name, and for web, set a new site URL. Once done, deploy your app as usual. See how to do it in [**detail here**](../publishing/deploy-for-environment.md).
+</p>
+</details>