Merge branch 'main' into pinkesh/update-action-parameters-callbacks

Author: leighajarett

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

@@ -44,13 +44,13 @@ The **Download File** action allows you to enable users to download or save file
 
 :::
 
-## Add Download File [Action]
+## Download File [Action]
 
-To add a download file action, select the **Widget** (e.g., button or any interactive widget) where you want users to initiate the file download and set the **Source** to one of the following.
+To add a Download File action, select the **Widget** (e.g., button or any interactive widget) where you want users to initiate the file download and set the **Source** to one of the following.
 
 - **From URL**: Use this option for downloading files that are accessible through a direct link and specify the URL of the file that should be downloaded.
 - **From File (Bytes)**: Use this option when the file is uploaded to the device using the [Local Upload (Widget State)](upload-data.md#local-upload-widget-state). You can access the file via ***Widget State > Uploaded Local File***.
 
 Optionally, you can specify a **Filename** to be used when the file is downloaded.
 
-![file-download-action](imgs/file-download-action.avif)
+![file-download-action](imgs/file-download-action.avif)

docs/ff-concepts/file-handling/download-file.md

@@ -158,4 +158,8 @@ allowFullScreen style={{ width: '100%', height: '600px' }}></iframe>
 To confirm the successful integration of Google authentication and the creation of users, navigate
 to your **Firebase project > Authentication > Users** and check the entries.
 
-![verify-google-auth-users.png](../imgs/verify-google-auth-users.png)
+![verify-google-auth-users.png](../imgs/verify-google-auth-users.png)
+
+:::info
+To ensure that your Android release will authenticate to Google, make sure to use Google Play Console's SHA keys - see how to [**Get SHA keys for release mode**](auth-initial-setup.md#getting-sha-keys-for-release-mode).
+:::

docs/ff-integrations/authentication/firebase-auth/google-login.md

@@ -31,7 +31,7 @@ Follow the steps below to add Email Login action:
 By using this action, you can provide your users with the flexibility to create their accounts in different ways, according to their preferences.
 
 :::note
-As of now, we support creating accounts with Email/Password and Google.
+As of now, we support creating accounts with Email/Password, Google and Apple auth providers.
 :::
 
 Follow the steps below to add email signup action:
@@ -62,7 +62,7 @@ Follow the steps below to add this action:
 
 ![img_6.png](img_6.png)
 
-## Reset Password [Action]
+## Send Reset Password Email [Action]
 
 This action allows users to reset their password by sending a reset link to their registered email address.
 
@@ -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](#use-custom-redirect-urls). 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**.
 
@@ -140,7 +140,41 @@ Here’s how you can add the Supabase reset password feature to your app:
 </div>
 <p></p>
 
+### Use Custom Redirect URLs
 
+Instead of relying on the default `{{ .ConfirmationURL }}` path, you could optionally configure a **custom redirect URL** in Supabase. This option allows you to bypass the default setup and send users directly to a custom page in your app for resetting their password.
+
+To configure a custom redirect URL:
+
+1. When adding the **Send Reset Password Email** action in FlutterFlow, enter the **Redirect To** URL. For example `http://my-site.com/resetPassword`.
+2. Whitelist this custom URL by navigating to **Supabase Dashboard > Authentication > URL Configuration > Redirect URL**, and click **Add URL** to include it.
+3. Update the reset password template. Go to **Supabase Dashboard > Authentication > Email Templates > Reset Password > Source** and ensure only `{{ .ConfirmationURL }}` is present in the template (remove any appended route names).
+
+<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/TaAYPINhn20QEgR6TR5F?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>
 
 ## Delete User 
 

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

@@ -79,11 +79,11 @@ Here's how it looks:
 
 ### Adding Log In [Action]
 
-To allow users to log in with their credentials, you can use [this](auth-actions.md#log-in-action) action.
+To allow users to log in with their credentials, you can use the [**Log In**](auth-actions.md#log-in-action) action.
 
 ### Adding Logout [Action]
 
-To let users log out of your app, you can use [this](auth-actions.md#log-out-action) action.
+To let users log out of your app, you can use the [**Log Out**](auth-actions.md#log-out-action) action.
 
 ### Verify user creation
 

docs/ff-integrations/authentication/supabase-auth/email-supabase.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>