Function compile_app

reflex/compiler/compiler.py:1093–1410

Compile an app using the compiler plugin pipeline. Returns: ``True`` when a real frontend compile ran, ``False`` when the call short-circuited (backend-only paths that only re-evaluate pages).

(
    app: App,
    *,
    prerender_routes: bool = False,
    dry_run: bool = False,
    use_rich: bool = True,
)

def compile_app(
    app: App,
    *,
    prerender_routes: bool = False,
    dry_run: bool = False,
    use_rich: bool = True,
) -> bool:
    """Compile an app using the compiler plugin pipeline.

    Returns:
        ``True`` when a real frontend compile ran, ``False`` when the call
        short-circuited (backend-only paths that only re-evaluate pages).
    """
    from reflex_base.components.dynamic import bundle_library, reset_bundled_libraries
    from reflex_base.utils.exceptions import ReflexRuntimeError

    app._apply_decorated_pages()
    app._pages = {}

    should_compile = app._should_compile()
    backend_dir = prerequisites.get_backend_dir()
    if not dry_run and not should_compile and backend_dir.exists():
        stateful_pages_marker = backend_dir / constants.Dirs.STATEFUL_PAGES
        if stateful_pages_marker.exists():
            with stateful_pages_marker.open("r") as file:
                stateful_pages = json.load(file)
            for route in stateful_pages:
                console.debug(f"BE Evaluating stateful page: {route}")
                app._compile_page(route, save_page=False)
        app._add_optional_endpoints()
        return False

    if constants.Page404.SLUG not in app._unevaluated_pages:
        app.add_page(route=constants.Page404.SLUG)

    app.style = evaluate_style_namespaces(app.style)
    config = get_config()

    if not should_compile and not dry_run:
        with console.timing("Evaluate Pages (Backend)"):
            for route in app._unevaluated_pages:
                console.debug(f"Evaluating page: {route}")
                app._compile_page(route, save_page=False)

        app._write_stateful_pages_marker()
        app._add_optional_endpoints()
        return False

    progress = (
        Progress(
            *Progress.get_default_columns()[:-1],
            MofNCompleteColumn(),
            TimeElapsedColumn(),
        )
        if use_rich
        else console.PoorProgress()
    )
    fixed_steps = 7