Skip to content

Commit 62f5ccf

Browse files
committed
reverted the changes. renamed troubleshooting guide to detecting issues
1 parent 5d2d758 commit 62f5ccf

12 files changed

+16
-170
lines changed
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.

docs/troubleshooting/assets/null.png

-244 KB
Binary file not shown.
-279 KB
Binary file not shown.

docs/troubleshooting/deployment/resolve_errors_in_downloaded_code.md

Lines changed: 1 addition & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -31,42 +31,5 @@ When you download your project from FlutterFlow and run it locally in your IDE,
3131

3232
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 Flutter**](/testing/local-run/#4-running-app-on-device). ​By following these steps, you can fix the errors that you face after downloading the code and run locally.
3333

34-
## Resolving In-App Errors Before Downloading
35-
36-
Sometimes, errors in your app — such as misconfigured widgets or faulty custom code — can cause download or build failures. FlutterFlow displays helpful error popups to help you catch and fix these issues before downloading your code.
37-
38-
- **Error popup**
39-
40-
If you see a popup, open the red-colored section (click *Read More*), and at the bottom, you will see the exact widget or error causing the build or download failure.
41-
42-
Let's see a couple of examples of what you might encounter while building your app:
43-
44-
**Example 1**
45-
46-
Suppose you have a Text widget and added an action that is incomplete. When you try to download the project in such a situation, you might see the following:
47-
48-
![Detecting issue -1](../assets/detecting-issue-1.avif)
49-
50-
To track down the error-causing widget in the widget tree, start reading the widget list (from top to bottom in a popup) and locate the widget using its child number. For example, when a widget is displayed as *Child 1*, it will be the first child of its previous widget (see the widget in a popup). And when it is shown as *Child 2,3*, and so on, it will be the sibling widget of *Child 1*.
51-
52-
If you have a practice of naming the widget, it will be straightforward to track it down (as we'll display the exact widget name). Here is how it looks:
53-
54-
![Detecting issue -2](../assets/detecting-issue-2.avif)
55-
56-
:::info
57-
To find out what caused the widget to fail, you can check errors in the [project issues](../../intro/ff-ui/toolbar.md#project-issues).
58-
:::
59-
60-
**Example 2**
61-
62-
Let's say you have added a custom widget that works fine. But while modifying it, you made some typo in the code, and now it shows this:
63-
64-
![Error while building the app](../assets/error-while-building-app.png)
65-
66-
The second "**Error:"** line clearly mentions that there is some issue with a method name in a custom code.
67-
68-
If you continue to experience issues, contact the FlutterFlow support team via live chat or email at [email protected].
69-
70-
71-
7234

35+
If you continue to experience issues, contact the FlutterFlow support team via live chat or email at [email protected].

docs/troubleshooting/deployment/run_mode_build_failure.md

Lines changed: 2 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -92,29 +92,12 @@ This guide provides a structured approach to troubleshooting and resolving "Run
9292
- **Utilize local debugging**:
9393

9494
If the error is elusive, running the debugger locally on your downloaded code can help identify the issue.
95-
96-
**Use Device Logs in the FlutterFlow Desktop App**
97-
98-
If you're using the FlutterFlow Desktop App and running the app with a local run, you can access detailed logs that may point directly to the problem. These logs are especially helpful for catching runtime issues that might not appear in the FlutterFlow UI.
99-
100-
You can learn how to access these logs in this guide:
101-
[Access Device Logs in Local Run](../../testing-deployment-publishing/running-your-app/local-run.md#access-device-logs-in-local-run)
102-
103-
For example, if a user enters a character instead of a numeric value for a quantity field, and that type mismatch causes an error, it will be captured in the logs — allowing you to identify and fix it quickly.
104-
105-
![Desktop app's device logs](../assets/desktop-app-device-logs.avif)
106-
107-
:::tip
108-
Not sure what the error means? Just copy and paste the full error message into ChatGPT and ask for help understanding it.
109-
:::
110-
111-
In fact, for the error shown above, **[we asked ChatGPT](https://chat.openai.com/share/77f3ceb5-6b2f-4f94-b85c-e01a1fce002a)** to explain and resolve the issue — and the solution turned out to be quick and simple.
112-
95+
11396
- **Leverage browser tools**:
11497

11598
The browser's console and developer tools can offer insights, especially when dealing with errors that don't manifest in traditional debug outputs.
11699

117100

118101
:::info[Additional Resources]
119102
[Basic Troubleshooting Guide – FlutterFlow Documentation](https://docs.flutterflow.io/troubleshooting/basic-troubleshooting-guide)
120-
:::
103+
:::

docs/troubleshooting/index.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,15 @@
11
---
22
slug: /troubleshooting
3-
title: Troubleshooting Guide
3+
title: Detecting Issues
44
description: A guide to troubleshoot or debug issues that occur within FlutterFlow project.
55
tags: [Troubleshooting]
66
sidebar_position: 0
77
keywords: [Troubleshooting, Debugging, Detect Issues, Runtime Errors]
88
---
99

10-
# Troubleshooting Guide
10+
# Detecting Issues
1111

12-
This is a general troubleshooting guide for any issues that occur within FlutterFlow projects.
13-
14-
## Detecting issues
12+
This is a general troubleshooting guide for detecting any issues that occur within FlutterFlow projects.
1513

1614
We've improved our issue detection capabilities and added features to provide clearer insights into what might be causing these problems. Here are some options you can use to troubleshoot the issue.
1715

docs/troubleshooting/test-mode/firestore_permission_error-run_mode.md

Lines changed: 5 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,9 @@ This error is typically triggered when:
2525

2626
Example:
2727

28-
- If Firestore rules are configured as:
28+
- If Firestore rules are configured as:
2929

30-
```js
30+
```js
3131
rules_version = '2';
3232
service cloud.firestore {
3333
match /databases/{database}/documents {
@@ -37,29 +37,18 @@ This error is typically triggered when:
3737
}
3838
}
3939
```
40-
40+
4141
Any Firestore query will fail because no read or write access is allowed.
4242

4343
- If rules allow only authenticated access:
4444

45-
```js
45+
```js
4646
allow read, write: if request.auth != null;
47-
```
48-
47+
```
4948
And a query is placed on a page before the user signs in (e.g., on the login screen), it will trigger this error.
5049

5150
Descriptive widget names can help you quickly identify which query or widget is triggering the permission issue. In the example above, the error message references a widget named Container. Renaming it to something like UserQueryContainer can make debugging easier.
5251

53-
**Runtime errors (Run mode-only notification)**
54-
55-
Runtime errors in app development are errors that occur during the execution of the app. Unlike the errors that we display while you build the app, runtime errors occur while the app is running.
56-
57-
For instance, if Firestore security rules aren't properly configured, the app might run into permission issues at runtime, leading to failures in data retrieval or display. This kind of error might not be evident during app building but becomes apparent only when the app interacts with the Firestore database during actual operation.
58-
59-
We display such errors as *Run mode-only notification* in a snack bar. Here's what it might look like:
60-
61-
![Runtime errors](../assets/runtime-errors.avif)
62-
6352
Take the steps below to fix this error:
6453

6554
- **Review Firestore Rules**

0 commit comments

Comments
 (0)