Skip to content

Commit 56a4ba3

Browse files
authored
Merge pull request #15 from FlutterFlow/update/faq-preview-not-loading
Add FAQs section for addressing preview loading issues
2 parents 6a7c8d4 + efc7123 commit 56a4ba3

File tree

2 files changed

+21
-3
lines changed

2 files changed

+21
-3
lines changed

docs/workspace/content-panel.md

Lines changed: 21 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -52,9 +52,6 @@ Dreamflow provides integrated hot reload and hot restart capabilities that allow
5252

5353
**Stop Preview** ends the preview session completely. While Dreamflow works to prevent issues, sometimes the preview can enter an unusual or broken state. If problems aren’t resolved by Hot Reload or Hot Restart, it’s best to click the **Stop** button at the top of the Content Panel to stop the preview completely and restart it. Once stopped, you can restart the preview using the **Restart** button that appears on the preview device.
5454

55-
:::info[If you're still experiencing issues in the preview...]
56-
You can try to reload the project entirely by selecting the project name in the top left corner and selecting "Reload Project"
57-
:::
5855

5956
### Additional Features
6057

@@ -118,6 +115,27 @@ The Debug Console is a dedicated output panel in Dreamflow that displays real-ti
118115
</div>
119116
<p></p>
120117

118+
## FAQs
119+
120+
<details>
121+
122+
<summary> What should I do if the Preview is not loading and always shows "Preview starting…" message? </summary>
123+
124+
<p>
125+
126+
This usually happens when the preview session is stuck or the project dependencies need to be refreshed. Here are several steps you can try to resolve the issue:
127+
128+
- **Hot Reload (⚡):** Quickly applies code changes while keeping the current state. Use this first for small UI or logic updates.
129+
- **Hot Restart (🔄):** Restarts the app and resets its state. Use this if hot reload doesn't reflect changes or the preview is still stuck.
130+
- **Stop and Restart Preview (⏹️/▶️):** Manually stop the preview and start it again to relaunch the app.
131+
- **Refresh Dependencies:** At the bottom toolbar, click **Refresh Dependencies**. This will re-sync all your pub.dev packages in case the issue is caused by outdated or missing dependencies.
132+
- **Reload Project:** You can try to restart the project session entirely by selecting the project name in the top left corner and then selecting **Reload Project**.
133+
![reload-project](imgs/reload-project.avif)
134+
- **Check for Errors in Debug Console:** Open the Debug Console from the bottom panel to look for errors or warnings that may be preventing the app from launching. If you spot an error, you can ask the Agent directly to help resolve it.
135+
136+
Most preview issues can be fixed by reloading the project or restarting the preview. If the problem continues, use the **Submit Feedback** button in the top bar to file a bug report.
121137

138+
</p>
122139

140+
</details>
123141

22.9 KB
Binary file not shown.

0 commit comments

Comments
 (0)