FletApp

Renders another Flet app in the current app, similar to HTML IFrame, but for Flet.

Inherits: LayoutControl

Properties

• app_error_message - Template message to display when the app fails to load.
• app_startup_screen_message - Message to display on the app startup screen.
• args - Optional dictionary of arguments to pass to the Flet app.
• assets_dir - Base location for assets referenced by the embedded app.
• force_pyodide - Whether to force the use of Pyodide.
• reconnect_interval_ms - Delay, in milliseconds, between reconnection attempts.
• reconnect_timeout_ms - Total time to try reconnecting.
• show_app_startup_screen - Whether to show the app startup screen.
• url - Flet app URL, e.g.

Events

• on_error - Called when a connection or any unhandled error occurs.
• on_python_output - Fires once per stdout/stderr write inside the embedded Pyodide app.

Properties

buildapp_error_messageclass-attributeinstance-attribute

app_error_message: str | None = None

Template message to display when the app fails to load. Use {message} placeholder to include the error message and {details} to include error details.

buildapp_startup_screen_messageclass-attributeinstance-attribute

app_startup_screen_message: str | None = None

Message to display on the app startup screen.

buildargsclass-attributeinstance-attribute

args: dict[str, Any] | None = None

Optional dictionary of arguments to pass to the Flet app.

buildassets_dirclass-attributeinstance-attribute

assets_dir: str | None = None

Base location for assets referenced by the embedded app. On web this is a URL prefix joined with relative src values (e.g. on Image/Lottie/Markdown); on desktop it is a filesystem path.

buildforce_pyodideclass-attributeinstance-attribute

force_pyodide: bool = False

Whether to force the use of Pyodide.

buildreconnect_interval_msclass-attributeinstance-attribute

reconnect_interval_ms: int | None = None

Delay, in milliseconds, between reconnection attempts.

buildreconnect_timeout_msclass-attributeinstance-attribute

reconnect_timeout_ms: int | None = None

Total time to try reconnecting.

buildshow_app_startup_screenclass-attributeinstance-attribute

show_app_startup_screen: bool = False

Whether to show the app startup screen.

buildurlclass-attributeinstance-attribute

url: str | None = None

Flet app URL, e.g. http://localhost:8550 or flet.sock.

Events

bolton_errorclass-attributeinstance-attribute

on_error: ControlEventHandler[FletApp] | None = None

Called when a connection or any unhandled error occurs.

bolton_python_outputclass-attributeinstance-attribute

on_python_output: (
    EventHandler[FletAppOutputEvent] | None
) = None

Fires once per stdout/stderr write inside the embedded Pyodide app. Pyodide line-buffers by default, so each event is typically one print(...) call. Only fires for embedded FletApps with force_pyodide=True; root-level Pyodide pages have nowhere to bubble the event.