Troubleshooting & Frequently Asked Questions

Here are some of the most common issues and questions that may arise when working with FlexDash and its components

Why do I see a white screen when running my project?

A white screen usually indicates an error in the widget tree layout. The most common cause is incorrect usage of Flex widgets (Row, Column, or Flex) combined with Expanded or Flexible widgets. Check that:

• Every Expanded is placed inside a valid parent (Row, Column, or Flex).

• The layout does not contain conflicting constraints (e.g., multiple Expanded widgets inside a fixed-size parent).

---

How can I highlight the active page in the sidebar?

The active page highlight is managed by the AppState currentPageName. Each page must set its own name to currentPageName on page load, ensuring the sidebar correctly highlights the active menu item. If your highlight is not working, double-check that:

• The page is updating currentPageName correctly on load.

• The sidebar item is comparing against the correct page name.

---

The drawer (mobile sidebar) does not open. What should I check?

Verify the following:

• A Drawer widget exists at the root of the page.

• The Drawer width is set to 240px and elevation to 10px.

• The page header has an action assigned to open the Drawer. If the Drawer still doesn’t open, review a working page from the template and compare the setup.

---

Can I reuse the Drawer across all pages instead of inserting it manually?

No. FlutterFlow currently does not allow creating a reusable Drawer. Each page must contain its own Drawer for the sidebar to work properly. This ensures full-screen behavior on mobile and the drag-to-close gesture.

---

My sidebar items don’t change color on hover. Why?

Make sure each menu item is wrapped in a MouseRegion. The hover state inside MouseRegion must control the color conditionally. If you duplicated sections, confirm that the hover logic was copied correctly and points to the correct mouse region, and the conditional for the color is comparing against the correct page name.

---

Can I change the color scheme of the alerts (success, info, error)?

Yes. Alerts in FlexDash support the type argument which controls the style:

• Success (green)

• Info (blue)

• Error (red)

You can also customize the code further if needed by editing the alert component directly.

---

How can I duplicate or rename sections in the sidebar?

You can duplicate or rename sidebar sections freely. However, be careful to update:

• The page name comparisons inside color conditionals.

• Any logic tied to the hover and active states. If not updated, the highlight logic may break or point to the wrong page.