Merge remote-tracking branch 'origin/main' into claude/selenium-to-playwright-migration-7qluV

Author: masenf

.github/scripts/dispatch_release/detect.sh

@@ -2,7 +2,6 @@
 set -euo pipefail
 
 declare -A MAP=(
-  [reflex]=reflex
   [hatch_reflex_pyi]=hatch-reflex-pyi
   [reflex_base]=reflex-base
   [reflex_components_code]=reflex-components-code
@@ -20,7 +19,7 @@ declare -A MAP=(
   [reflex_docgen]=reflex-docgen
   [reflex_hosting_cli]=reflex-hosting-cli
 )
-ORDER=(reflex hatch_reflex_pyi reflex_base reflex_components_code reflex_components_core reflex_components_dataeditor reflex_components_gridjs reflex_components_lucide reflex_components_markdown reflex_components_moment reflex_components_plotly reflex_components_radix reflex_components_react_player reflex_components_recharts reflex_components_sonner reflex_docgen reflex_hosting_cli)
+ORDER=(hatch_reflex_pyi reflex_base reflex_components_code reflex_components_core reflex_components_dataeditor reflex_components_gridjs reflex_components_lucide reflex_components_markdown reflex_components_moment reflex_components_plotly reflex_components_radix reflex_components_react_player reflex_components_recharts reflex_components_sonner reflex_docgen reflex_hosting_cli)
 
 PACKAGES=()
 for key in "${ORDER[@]}"; do

.github/scripts/dispatch_release/plan.py

@@ -176,6 +176,29 @@ def main() -> None:
             "tag": tag,
         })
 
+    # reflex is not independently releasable via dispatch: when reflex-base is
+    # released, reflex is released alongside it with a matching version. The
+    # publish workflow pins reflex-base exactly when building reflex.
+    reflex_base_release = next(
+        (r for r in releases if r["package"] == "reflex-base"), None
+    )
+    if reflex_base_release is not None:
+        reflex_version = reflex_base_release["next"]
+        reflex_tag = f"v{reflex_version}"
+        if tag_exists(reflex_tag):
+            fail(f"tag {reflex_tag} already exists")
+        current_reflex = pick_latest("v")
+        display = current_reflex if current_reflex is not None else "<none>"
+        summary_rows.append(
+            f"| `reflex` | `{display}` | `{reflex_version}` | `{reflex_tag}` |"
+        )
+        releases.append({
+            "package": "reflex",
+            "current": current_reflex or "",
+            "next": reflex_version,
+            "tag": reflex_tag,
+        })
+
     with pathlib.Path(github_step_summary).open("a") as f:
         f.write("\n".join(summary_rows) + "\n")
     with pathlib.Path(github_output).open("a") as f:

.github/workflows/dispatch_release.yml

@@ -11,7 +11,8 @@ on:
         description: "Release action"
         required: true
         type: choice
-        default: new-prerelease-patch
+        # default is continued-prerelease to prevent accidental releases.
+        default: continued-prerelease
         options:
           - new-prerelease-patch
           - new-prerelease-minor
@@ -22,10 +23,6 @@ on:
           - release-patch
           - release-minor
           - release-major
-      reflex:
-        description: "reflex"
-        type: boolean
-        default: false
       hatch_reflex_pyi:
         description: "hatch-reflex-pyi"
         type: boolean
@@ -104,7 +101,6 @@ jobs:
       - uses: actions/checkout@v6
       - id: detect
         env:
-          reflex: ${{ inputs.reflex }}
           hatch_reflex_pyi: ${{ inputs.hatch_reflex_pyi }}
           reflex_base: ${{ inputs.reflex_base }}
           reflex_components_code: ${{ inputs.reflex_components_code }}

.github/workflows/publish.yml

@@ -1,5 +1,7 @@
 name: Publish to PyPI
 
+run-name: Publish ${{ github.event.release.tag_name || inputs.tag }}
+
 on:
   release:
     types: [published]
@@ -36,6 +38,7 @@ jobs:
           if [[ "$TAG" =~ ^v([0-9].*)$ ]]; then
             echo "package=reflex" >> "$GITHUB_OUTPUT"
             echo "build_dir=." >> "$GITHUB_OUTPUT"
+            echo "version=${BASH_REMATCH[1]}" >> "$GITHUB_OUTPUT"
           elif [[ "$TAG" =~ ^(.+)-v([0-9].*)$ ]]; then
             PACKAGE="${BASH_REMATCH[1]}"
             if [ ! -d "packages/$PACKAGE" ]; then
@@ -44,11 +47,23 @@ jobs:
             fi
             echo "package=$PACKAGE" >> "$GITHUB_OUTPUT"
             echo "build_dir=packages/$PACKAGE" >> "$GITHUB_OUTPUT"
+            echo "version=${BASH_REMATCH[2]}" >> "$GITHUB_OUTPUT"
           else
             echo "Error: Tag '$TAG' does not match expected format (v* or <package>-v*)"
             exit 1
           fi
 
+      - name: Pin reflex-base to exact version
+        if: steps.parse.outputs.package == 'reflex'
+        run: |
+          VERSION="${{ steps.parse.outputs.version }}"
+          if ! grep -q '"reflex-base >= ' pyproject.toml; then
+            echo "Error: expected 'reflex-base >= ...' dependency in pyproject.toml"
+            exit 1
+          fi
+          sed -i 's|"reflex-base >= [^"]*"|"reflex-base == '"$VERSION"'"|' pyproject.toml
+          grep '"reflex-base' pyproject.toml
+
       - name: Build
         run: uv build --directory "${{ steps.parse.outputs.build_dir }}"
 

.pre-commit-config.yaml

@@ -4,7 +4,7 @@ repos:
   hooks:
   - id: ruff-format
     name: ruff-format
-    entry: ruff format --preview
+    entry: ruff format
     language: system
     types_or: [python, markdown]
     require_serial: true

CONTRIBUTING.md

@@ -1,7 +1,5 @@
 # Reflex Contributing Guidelines
 
-For an extensive guide on the different ways to contribute to Reflex see our [Contributing Guide on Notion](https://www.notion.so/reflex-dev/2107ab2bc166497db951b8d742748284?v=f0eaff78fa984b5ab15d204af58907d7).
-
 ## Running a Local Build of Reflex
 
 Here is a quick guide on how to run Reflex repo locally so you can start contributing to the project.
@@ -110,6 +108,33 @@ We welcome AI-assisted contributions, but they must meet the same quality bar as
 - All added/changed lines MUST have unit or integration test coverage with _real_ assertions. No untested code, no bogus test code.
 - PRs with merge conflicts or failing tests will not be reviewed or merged. The maintainers do not spend time on PRs that are not in a ready state. If you need attention on a PR that is not ready, mention the maintainers in a comment.
 
+## 📝 Contributing to the Docs
+
+The Reflex documentation lives in this repo under [`docs/`](https://github.com/reflex-dev/reflex/tree/main/docs). All doc pages are plain Markdown files in [`docs/`](https://github.com/reflex-dev/reflex/tree/main/docs), and the docs site itself (a Reflex app that renders them) lives in [`docs/app/`](https://github.com/reflex-dev/reflex/tree/main/docs/app). If you're fixing a typo, clarifying an explanation, or adding a new page, you can do it all in this repo by editing the relevant `.md` file.
+
+**1. Run the docs site locally:**
+
+```bash
+cd docs/app
+uv sync
+uv run reflex run
+```
+
+Then open [http://localhost:3000/docs/](http://localhost:3000/docs/). The dev server picks up changes to the `.md` files in `docs/` so you can preview edits live.
+
+**2. Speed up dev builds with the page whitelist (optional):**
+
+By default the dev server compiles every page, which can be slow. To only compile the pages you're working on, edit `docs/app/reflex_docs/whitelist.py` and add paths to `WHITELISTED_PAGES`:
+
+```python
+WHITELISTED_PAGES = [
+    "/getting-started/introduction",
+    "/components/props",
+]
+```
+
+Paths must start with `/`, have no trailing slash, and are prefix-matched. An empty list builds everything. Restart the dev server after editing.
+
 ## Editing Templates
 
 To edit the templates in Reflex you can do so in two way.

docs/app/assets/tailwind-theme.css

@@ -1699,6 +1699,14 @@
         /* padding: 0rem 0.125rem 0rem 0.125rem; */
     }
 
+    /* Override Radix Code (rt-Code) accent coloring so inline code matches slate theme */
+    code.rt-Code,
+    code.rt-Code.rt-variant-soft,
+    .rt-Code.rt-variant-soft {
+        color: var(--c-slate-11) !important;
+        background-color: var(--c-slate-3) !important;
+    }
+
     .code-error-style {
         font-family: var(--font-jetbrains);
         font-size: 0.835rem;
@@ -1803,6 +1811,44 @@
         }
     }
 
+    .code-block button,
+    .code-block > button {
+        border: none !important;
+        border-width: 0 !important;
+        background: transparent !important;
+        background-color: transparent !important;
+        opacity: 0 !important;
+        transition: opacity 0.15s ease-out !important;
+        pointer-events: none;
+        display: inline-flex !important;
+        align-items: center !important;
+        gap: 0.375rem !important;
+        font-size: 0.8125rem !important;
+        font-weight: 500 !important;
+        color: var(--c-slate-11) !important;
+        top: 8px !important;
+        right: 12px !important;
+        padding: 6px 8px !important;
+    }
+
+    .code-block button::after,
+    .code-block > button::after {
+        content: "Copy";
+    }
+
+    .code-block:hover button,
+    .code-block:hover > button,
+    .code-block button:focus-visible {
+        opacity: 1 !important;
+        pointer-events: auto;
+    }
+
+    .code-block button:hover,
+    .code-block > button:hover {
+        background: var(--c-slate-3) !important;
+        background-color: var(--c-slate-3) !important;
+    }
+
 
     .tab-style {
         color: var(--c-slate-9);
@@ -1814,6 +1860,89 @@
         letter-spacing: -0.01094rem;
     }
 
+    .pill-tab-list {
+        display: inline-flex !important;
+        gap: 2px !important;
+        padding: 4px !important;
+        background: var(--c-slate-3) !important;
+        border-radius: 10px !important;
+        border-bottom: none !important;
+        box-shadow: none !important;
+        width: fit-content !important;
+        max-width: 100%;
+        overflow-x: auto;
+    }
+
+    .pill-tab-list::before,
+    .pill-tab-list::after {
+        display: none !important;
+        content: none !important;
+    }
+
+    .pill-tab {
+        appearance: none !important;
+        background: transparent !important;
+        background-color: transparent !important;
+        border: none !important;
+        padding: 8px 16px !important;
+        font-size: 0.9375rem !important;
+        font-weight: 450 !important;
+        color: var(--c-slate-11) !important;
+        border-radius: 7px !important;
+        cursor: pointer;
+        white-space: nowrap;
+        transition: color 0.12s, background-color 0.12s, box-shadow 0.12s;
+        letter-spacing: 0 !important;
+        line-height: 1.25rem !important;
+        box-shadow: none !important;
+    }
+
+    .pill-tab::before,
+    .pill-tab::after,
+    .pill-tab:hover::before,
+    .pill-tab:hover::after,
+    .pill-tab[data-state='active']::before,
+    .pill-tab[data-state='active']::after,
+    .pill-tab[data-state='active']:hover::before,
+    .pill-tab[data-state='active']:hover::after {
+        background: transparent !important;
+        background-color: transparent !important;
+        box-shadow: none !important;
+        content: none !important;
+        display: none !important;
+    }
+
+    .pill-tab:hover {
+        color: var(--c-slate-11) !important;
+        background: transparent !important;
+    }
+
+    .pill-tab .rt-BaseTabListTriggerInner,
+    .pill-tab:hover .rt-BaseTabListTriggerInner,
+    .pill-tab:focus-visible .rt-BaseTabListTriggerInner,
+    .pill-tab:focus-visible:hover .rt-BaseTabListTriggerInner {
+        background-color: transparent !important;
+        background: transparent !important;
+    }
+
+    .pill-tab[data-state='active'],
+    .pill-tab[data-state='active']:hover {
+        color: var(--c-slate-12) !important;
+        font-weight: 500 !important;
+        background: var(--c-slate-1) !important;
+        background-color: var(--c-slate-1) !important;
+        box-shadow: 0 1px 3px rgba(0, 0, 0, 0.08) !important;
+    }
+
+    :where(.dark, .dark *) .pill-tab[data-state='active'] {
+        box-shadow: 0 1px 3px rgba(0, 0, 0, 0.4) !important;
+    }
+
+    .tab-style:hover:not([data-state='active'])::before {
+        background: transparent !important;
+        background-color: transparent !important;
+    }
+
     .tab-style:hover {
         color: var(--c-slate-11);
     }

docs/app/pyproject.toml

@@ -90,6 +90,9 @@ lint.ignore = [
 lint.pydocstyle.convention = "google"
 lint.allowed-confusables = ['’']
 
+[tool.ruff.format]
+preview = true
+
 [tool.codespell]
 skip = "data/*"