Merge branch 'main' into devin/1752212592-fix-edit-page-links

Author: Alek99

.github/workflows/deploy-dev.yml

@@ -17,6 +17,8 @@ env:
   NODE_OPTIONS: "--max-old-space-size=8192"
   CP_WEB_URL: https://cloud.rxc.app/
   CP_BACKEND_URL: https://cloud-f188e2cd-51fb-4b29-b546-2ce4b9efc5d5.fly.dev/
+  DEV_TYPESENSE_HOST: ${{ secrets.DEV_TYPESENSE_HOST }}
+  DEV_TYPESENSE_SEARCH_API_KEY: ${{ secrets.DEV_TYPESENSE_SEARCH_API_KEY }}
 
 jobs:
   deploy:
@@ -38,6 +40,14 @@ jobs:
       - name: Update Reflex CLI
         run: uv pip install reflex-hosting-cli -U
 
+      - name: Index documentation to Typesense
+        env:
+          TYPESENSE_ADMIN_API_KEY: ${{ secrets.DEV_TYPESENSE_ADMIN_API_KEY }}
+          TYPESENSE_HOST: ${{ secrets.DEV_TYPESENSE_HOST }}
+        run: |
+          uv pip install typesense python-frontmatter markdown beautifulsoup4
+          python scripts/typesense_indexer.py
+
       - name: Deploy to Reflex
         id: deploy
         run: |

.github/workflows/deploy-prd.yml

@@ -14,6 +14,8 @@ permissions:
 env:
   NODE_OPTIONS: "--max-old-space-size=8192"
   FLY_API_TOKEN: ${{ secrets.PRD_FLY_API_TOKEN }}
+  TYPESENSE_HOST: ${{ secrets.PRD_TYPESENSE_HOST }}
+  TYPESENSE_SEARCH_API_KEY: ${{ secrets.PRD_TYPESENSE_SEARCH_API_KEY }}
 
 jobs:
   deploy:
@@ -36,6 +38,14 @@ jobs:
       - name: Update Reflex CLI
         run: uv pip install reflex-hosting-cli -U
 
+      - name: Index documentation to Typesense
+        env:
+          TYPESENSE_ADMIN_API_KEY: ${{ secrets.PRD_TYPESENSE_ADMIN_API_KEY }}
+          TYPESENSE_HOST: ${{ secrets.PRD_TYPESENSE_HOST }}
+        run: |
+          uv pip install typesense python-frontmatter markdown beautifulsoup4
+          python scripts/typesense_indexer.py
+
       - name: Deploy to Reflex
         id: deploy
         run: |

.github/workflows/deploy-stg.yml

@@ -17,6 +17,8 @@ env:
   FLY_API_TOKEN: ${{ secrets.STG_FLY_API_TOKEN }}
   CP_WEB_URL: https://cloud.reflexcorp.run/
   CP_BACKEND_URL: https://cloud-29f4f535-4fb8-48b9-8b55-2000f2782aee.fly.dev/
+  TYPESENSE_HOST: ${{ secrets.STG_TYPESENSE_HOST }}
+  TYPESENSE_SEARCH_API_KEY: ${{ secrets.STG_TYPESENSE_SEARCH_API_KEY }}
 
 jobs:
   deploy:
@@ -38,6 +40,14 @@ jobs:
       - name: Update Reflex CLI
         run: uv pip install reflex-hosting-cli -U
 
+      - name: Index documentation to Typesense
+        env:
+          TYPESENSE_ADMIN_API_KEY: ${{ secrets.STG_TYPESENSE_ADMIN_API_KEY }}
+          TYPESENSE_HOST: ${{ secrets.STG_TYPESENSE_HOST }}
+        run: |
+          uv pip install typesense python-frontmatter markdown beautifulsoup4
+          python scripts/typesense_indexer.py
+
       - name: Deploy to Reflex
         id: deploy
         run: |

.github/workflows/typesense-index.yml

@@ -0,0 +1,80 @@
+name: Typesense Documentation Indexing
+
+env:
+  TELEMETRY_ENABLED: false
+  NODE_OPTIONS: "--max_old_space_size=8192"
+
+on:
+  workflow_dispatch:
+    inputs:
+      force_reindex:
+        description: "Force complete reindexing"
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+
+defaults:
+  run:
+    shell: bash
+
+jobs:
+  index-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install the latest version of uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.11"
+          activate-environment: true
+
+      - name: Install indexing dependencies
+        run: |
+          uv pip install typesense python-frontmatter markdown beautifulsoup4
+
+      - name: Run Typesense indexing
+        env:
+          TYPESENSE_ADMIN_API_KEY: ${{ secrets.TYPESENSE_ADMIN_API_KEY }}
+        run: |
+          python scripts/typesense_indexer.py
+
+      - name: Verify indexing coverage and completeness
+        env:
+          TYPESENSE_SEARCH_API_KEY: ${{ secrets.TYPESENSE_SEARCH_API_KEY }}
+        run: |
+          echo "=== INDEXING VERIFICATION SUMMARY ==="
+          echo "The indexing script includes comprehensive verification that:"
+          echo "✅ All markdown files in /docs are found and processed"
+          echo "✅ No files are skipped or fail processing"
+          echo "✅ Section-by-section coverage is 100%"
+          echo "✅ Final Typesense count matches processed documents"
+          echo ""
+          echo "If any markdown files are missing or fail to index, the script will:"
+          echo "❌ Exit with error code 1"
+          echo "❌ Report specific failed files and reasons"
+          echo "❌ Show detailed section breakdown of coverage"
+          echo ""
+          echo "Performing additional search verification..."
+          python -c "
+          import typesense
+          client = typesense.Client({
+            'nodes': [{'host': 'z2mi3hyewokc16a4p-1.a1.typesense.net', 'port': '443', 'protocol': 'https'}],
+            'api_key': '${{ secrets.TYPESENSE_SEARCH_API_KEY }}',
+            'connection_timeout_seconds': 60
+          })
+          result = client.collections['docs'].documents.search({'q': 'reflex', 'query_by': 'title,content'})
+          print(f'✅ Search verification: Found {result[\"found\"]} documents for \"reflex\" query')
+          
+          # Test different sections
+          sections = ['getting_started', 'library', 'hosting', 'events', 'styling']
+          for section in sections:
+              result = client.collections['docs'].documents.search({
+                  'q': section, 
+                  'query_by': 'section,title,content',
+                  'per_page': 1
+              })
+              print(f'✅ Section \"{section}\": {result[\"found\"]} searchable documents')
+          "

docs/api-reference/browser_javascript.md

@@ -77,8 +77,15 @@ via `rx.call_script`.
 rx.vstack(
     rx.script(
         src="https://cdn.jsdelivr.net/gh/scottschiller/snowstorm@snowstorm_20131208/snowstorm-min.js",
-        on_ready=rx.call_script("snowStorm.autoStart = false; snowStorm.snowColor = '#111'"),
     ),
+    rx.script("""
+        window.addEventListener('load', function() {
+            if (typeof snowStorm !== 'undefined') {
+                snowStorm.autoStart = false;
+                snowStorm.snowColor = '#111';
+            }
+        });
+    """),
     rx.button("Start Duststorm", on_click=rx.call_script("snowStorm.start()")),
     rx.button("Toggle Duststorm", on_click=rx.call_script("snowStorm.toggleSnow()")),
 )

docs/components/conditional_rendering.md

@@ -55,7 +55,7 @@ class PropCondState(rx.State):
     value: int
 
     @rx.event
-    def set_end(self, value: list[int]):
+    def set_end(self, value: list[int | float]):
         self.value = value[0]
 
 

docs/custom-components/command-reference.md

@@ -1,20 +1,13 @@
 # Command Reference
 
-```python exec
-import reflex as rx
-from pcweb.pages.docs import wrapping_react
-from pcweb.pages.gallery import gallery
-from pcweb.pages.docs import custom_components
-from pcweb.templates.docpage import doccmdoutput
-from pcweb.styles.fonts import code
-```
-
 The custom component commands are under `reflex component` subcommand. To see the list of available commands, run `reflex component --help`. To see the manual on a specific command, run `reflex component <command> --help`, for example, `reflex component init --help`.
 
-```python eval
-doccmdoutput(
-    command="reflex component --help",
-    output="""Usage: reflex component [OPTIONS] COMMAND [ARGS]...
+```bash
+reflex component --help
+```
+
+```text
+Usage: reflex component [OPTIONS] COMMAND [ARGS]...
 
   Subcommands for creating and publishing Custom Components.
 
@@ -24,17 +17,19 @@ Options:
 Commands:
   init     Initialize a custom component.
   build    Build a custom component.
-  share    Collect more details on the published package for gallery.""")
+  share    Collect more details on the published package for gallery.
 ```
 
 ## reflex component init
 
 Below is an example of running the `init` command.
 
-```python eval
-doccmdoutput(
-    command="reflex component init",
-    output="""reflex component init
+```bash
+reflex component init
+```
+
+```text
+reflex component init
 ─────────────────────────────────────── Initializing reflex-google-auth project ───────────────────────────────────────
 Info: Populating pyproject.toml with package name: reflex-google-auth
 Info: Initializing the component directory: custom_components/reflex_google_auth
@@ -51,16 +46,13 @@ Custom component initialized successfully!
 [ pyproject.toml ]: Project configuration file. Please fill in details such as your name, email, homepage URL.
 [ custom_components/ ]: Custom component code template. Start by editing it with your component implementation.
 [ google_auth_demo/ ]: Demo App. Add more code to this app and test.
-""",
-)
 ```
 
 The `init` command uses the current enclosing folder name to construct a python package name, typically in the kebab case. For example, if running init in folder `google_auth`, the package name will be `reflex-google-auth`. The added prefix reduces the chance of name collision on PyPI (the Python Package Index), and it indicates that the package is a Reflex custom component. The user can override the package name by providing the `--package-name` option.
 
 The `init` command creates a set of files and folders prefilled with the package name and other details. During the init, the `custom_component` folder is installed locally in editable mode, so a developer can incrementally develop and test with ease. The changes in component implementation is automatically reflected where it is used. Below is the folder structure after the `init` command.
 
-```python eval
-rx._x.code_block("""
+```text
 google_auth/
 ├── pyproject.toml
 ├── README.md
@@ -73,17 +65,6 @@ google_auth/
         google_auth_demo/
         requirements.txt
         rxconfig.py
-""",
-  language="bash",
-  style={
-    "border-radius": "12px",
-    "border": "1px solid var(--c-slate-4)",
-    "background": "var(--c-slate-2)",
-    "color": "var(--c-slate-12)",
-    "font-family": "Source Code Pro",
-    **code
-  }
-)
 ```
 
 ### pyproject.toml
@@ -110,10 +91,12 @@ A demo app is generated inside `google_auth_demo` folder with import statements
 
 The help manual is shown when adding the `--help` option to the command.
 
-```python eval
-doccmdoutput(
-    command="reflex component init --help",
-    output="""Usage: reflex component init [OPTIONS]
+```bash
+reflex component init --help
+```
+
+```text
+Usage: reflex component init [OPTIONS]
 
   Initialize a custom component.
 
@@ -134,7 +117,6 @@ Options:
                                   The log level to use.  [default:
                                   LogLevel.INFO]
   --help                          Show this message and exit.
-""")
 ```
 
 ## reflex component publish
@@ -149,10 +131,11 @@ It is not required to run the `build` command separately before publishing. The
 
 The `build` command generates the `.tar.gz` and `.whl` distribution files to be uploaded to the desired package index, for example, PyPI. This command must be run at the top level of the project where the `pyproject.toml` file is. As a result of a successful build, there is a new `dist` folder with the distribution files.
 
-```python eval
-doccmdoutput(
-    command="reflex component build --help",
-    output="""reflex component build --help
+```bash
+reflex component build --help
+```
+
+```text
 Usage: reflex component build [OPTIONS]
 
   Build a custom component. Must be run from the project root directory where
@@ -167,5 +150,4 @@ Options:
                                   The log level to use.  [default:
                                   LogLevel.INFO]
   --help                          Show this message and exit.
-""")
-```
+```