reflex-dev/reflex · error · ValueError

Stylesheet file name cannot be empty: {stylesheet_full_path}

Error message

Stylesheet file name cannot be empty: {stylesheet_full_path}

What it means

A defensive check in _validate_stylesheet that rejects stylesheet paths with an empty file name component (e.g. a path ending in / or just an extension). Such paths would produce a broken @import in the generated root stylesheet.

Source

Thrown at reflex/compiler/compiler.py:306

    Args:
        stylesheet_full_path: The stylesheet to validate.
        assets_app_path: The path to the assets directory.

    Raises:
        ValueError: If the stylesheet is not supported.
        FileNotFoundError: If the stylesheet is not found.
    """
    suffix = stylesheet_full_path.suffix[1:] if stylesheet_full_path.suffix else ""
    if suffix not in constants.Reflex.STYLESHEETS_SUPPORTED:
        msg = f"Stylesheet file {stylesheet_full_path} is not supported."
        raise ValueError(msg)
    if not stylesheet_full_path.absolute().is_relative_to(assets_app_path.absolute()):
        msg = f"Cannot include stylesheets from outside the assets directory: {stylesheet_full_path}"
        raise FileNotFoundError(msg)
    if not stylesheet_full_path.name:
        msg = f"Stylesheet file name cannot be empty: {stylesheet_full_path}"
        raise ValueError(msg)
    if (
        len(
            stylesheet_full_path
            .absolute()
            .relative_to(assets_app_path.absolute())
            .parts
        )
        == 1
        and stylesheet_full_path.stem == PageNames.STYLESHEET_ROOT
    ):
        msg = f"Stylesheet file name cannot be '{PageNames.STYLESHEET_ROOT}': {stylesheet_full_path}"
        raise ValueError(msg)


def _compile_root_stylesheet(
    stylesheets: list[str],
    reset_style: bool = True,
    plugins: Sequence[Plugin] | None = None,

View on GitHub (pinned to 45b8ed5ab7)

Solutions

1. Fix the generated path string to include a real file name
2. Sanitize the list before passing: [s for s in styles if s and Path(s).name]
3. Fix the f-string/Path join that produced the truncated path

Example fix

# before
styles = [str(styles_dir / "")]  # add_styles=["/styles/"]
# after
styles = [str(styles_dir / "theme.css")]

from pathlib import Path

add_styles = [s for s in style_list if not s.startswith(("http://", "https://")) or True]
add_styles = [s for s in add_styles if Path(s).name and Path(s).stem]

When it happens

Trigger: Passing strings like "/styles/", ".css", or "" in rx.App(add_styles=[...]) (non-URL entries). Path(name) evaluates falsy when the final component is empty, triggering the ValueError.

Common situations: Building the stylesheet list programmatically and accidentally appending an empty string or trailing-slash path; f-string path construction bugs that drop the filename.

Related errors

• Cannot include stylesheets from outside the assets directory
• Stylesheet file {stylesheet_full_path} is not supported.
• Stylesheet file name cannot be '{PageNames.STYLESHEET_ROOT}'
• The stylesheet file {stylesheet_full_path} does not exist.
• ChildrenTypeError(component=cls.__name__, child=child)

AI-assisted analysis of reflex-dev/reflex@45b8ed5ab7 (2026-08-28). Data as JSON: /api/errors/2865cb754c70f60a. Report an issue: GitHub.