Merge remote-tracking branch 'origin/main' into pr6510-conflict-resolution

# Conflicts:
#	docs/app/reflex_docs/templates/docpage/docpage.py

Author: Alek99

docs/app/.github/workflows/whitelist.yml .github/workflows/docs_whitelist.ymldocs/app/.github/workflows/whitelist.yml renamed to .github/workflows/docs_whitelist.yml

@@ -1,15 +1,18 @@
-name: whitelist check
+name: docs whitelist check
 
 on:
   pull_request:
+    paths:
+      - 'docs/app/reflex_docs/whitelist.py'
+      - '.github/workflows/docs_whitelist.yml'
 
 permissions:
   contents: read
 
 jobs:
-  reflex-web:
+  check-whitelist:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       - name: Assert whitelist is empty
-        run: echo -e "\nassert not WHITELISTED_PAGES, f'WHITELISTED_PAGES includes {WHITELISTED_PAGES}'" | cat "reflex_docs/whitelist.py" - | python3
+        run: echo -e "\nassert not WHITELISTED_PAGES, f'WHITELISTED_PAGES includes {WHITELISTED_PAGES}'" | cat "docs/app/reflex_docs/whitelist.py" - | python3

README.md

@@ -21,7 +21,11 @@
 ---
 
 > [!NOTE]
-> 🚀 **Try [Reflex Build](https://build.reflex.dev/)** – our AI-powered app builder that generates full-stack Reflex applications in seconds.
+> Build faster with Reflex:
+>
+> - **[AI Builder](https://build.reflex.dev/)** - Generate full-stack Reflex apps in seconds.
+> - **[Agent Toolkit](https://reflex.dev/docs/ai/integrations/ai-onboarding/)** - Connect MCP and Skills to your coding assistant.
+> - **[App Management](https://reflex.dev/hosting)** - Deploy and manage your Reflex apps.
 
 ---
 
@@ -33,7 +37,6 @@ Key features:
 
 - **Pure Python** - Write your app's frontend and backend all in Python, no need to learn Javascript.
 - **Full Flexibility** - Reflex is easy to get started with, but can also scale to complex apps.
-- **Deploy Instantly** - After building, deploy your app with a [single command](https://reflex.dev/docs/hosting/deploy-quick-start/) or host it on your own server.
 
 See our [architecture page](https://reflex.dev/blog/2024-03-21-reflex-architecture/#the-reflex-architecture) to learn how Reflex works under the hood.
 
@@ -43,250 +46,77 @@ See our [architecture page](https://reflex.dev/blog/2024-03-21-reflex-architectu
 
 ## 🥳 Create your first app
 
-### 1. Create the project directory
+Create a project, add Reflex, and start the development server with [uv](https://docs.astral.sh/uv/):
 
-Replace `my_app_name` with your project name:
-
-```bash
+```shell
 mkdir my_app_name
 cd my_app_name
-```
-
-### 2. Install uv
-
-Reflex recommends [uv](https://docs.astral.sh/uv/) for managing your project environment and dependencies.
-See the [uv installation docs](https://docs.astral.sh/uv/getting-started/installation/) for your platform.
-
-```bash
-# macOS/Linux
-curl -LsSf https://astral.sh/uv/install.sh | sh
-
-# Windows (PowerShell)
-powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
-```
-
-### 3. Initialize the Python project
-
-```bash
 uv init
-```
-
-### 4. Add Reflex
 
-Reflex requires Python 3.10+:
-
-```bash
 uv add reflex
-```
-
-### 5. Initialize the project
-
-This command initializes a template app in your new directory:
-
-```bash
 uv run reflex init
-```
-
-### 6. Run the app
-
-You can run this app in development mode:
-
-```bash
 uv run reflex run
 ```
 
 You should see your app running at http://localhost:3000.
 
 Now you can modify the source code in `my_app_name/my_app_name.py`. Reflex has fast refreshes so you can see your changes instantly when you save your code.
 
-### Troubleshooting
-
-If the `reflex` command is not on your PATH, run it through uv instead: `uv run reflex init` and `uv run reflex run`
-
 ## 🫧 Example App
 
-Let's go over an example: creating an image generation UI around [DALL·E](https://platform.openai.com/docs/guides/images/image-generation?context=node). For simplicity, we just call the [OpenAI API](https://platform.openai.com/docs/api-reference/authentication), but you could replace this with an ML model run locally.
-
- 
+Build an image generation app in Python with Reflex: define the UI, manage state in a class, and call an image model from an event handler.
 
 <div align="center">
-<img src="https://raw.githubusercontent.com/reflex-dev/reflex/main/docs/images/dalle.gif" alt="A frontend wrapper for DALL·E, shown in the process of generating an image." width="550" />
+<video src="https://github.com/user-attachments/assets/aaff28ad-8b3c-43bf-967e-439ee34c8a87" width="900" controls muted poster="https://raw.githubusercontent.com/reflex-dev/reflex/main/docs/images/reflex-image-generation-app.png">
+  <a href="https://github.com/user-attachments/assets/aaff28ad-8b3c-43bf-967e-439ee34c8a87">
+    <img src="https://raw.githubusercontent.com/reflex-dev/reflex/main/docs/images/reflex-image-generation-app.png" alt="Preview of an image generation app built with Reflex" width="900">
+  </a>
+</video>
 </div>
 
-&nbsp;
-
-Here is the complete code to create this. This is all done in one Python file!
-
 ```python
 import reflex as rx
 import openai
 
-openai_client = openai.OpenAI()
+client = openai.AsyncOpenAI()
 
 
 class State(rx.State):
-    """The app state."""
-
-    prompt = ""
-    image_url = ""
-    processing = False
-    complete = False
+    prompt: str = ""
+    image_url: str = ""
+    processing: bool = False
 
-    def get_image(self):
-        """Get the image from the prompt."""
-        if self.prompt == "":
-            return rx.window_alert("Prompt Empty")
+    @rx.event
+    def set_prompt(self, value: str):
+        self.prompt = value
 
-        self.processing, self.complete = True, False
+    @rx.event
+    async def generate(self):
+        self.processing = True
         yield
-        response = openai_client.images.generate(
-            prompt=self.prompt, n=1, size="1024x1024"
+        response = await client.images.generate(
+            model="gpt-image-1.5",
+            prompt=self.prompt,
         )
-        self.image_url = response.data[0].url
-        self.processing, self.complete = False, True
+        self.image_url = f"data:image/png;base64,{response.data[0].b64_json}"
+        self.processing = False
 
 
 def index():
-    return rx.center(
-        rx.vstack(
-            rx.heading("DALL-E", font_size="1.5em"),
-            rx.input(
-                placeholder="Enter a prompt..",
-                on_blur=State.set_prompt,
-                width="25em",
-            ),
-            rx.button(
-                "Generate Image",
-                on_click=State.get_image,
-                width="25em",
-                loading=State.processing,
-            ),
-            rx.cond(
-                State.complete,
-                rx.image(src=State.image_url, width="20em"),
-            ),
-            align="center",
-        ),
-        width="100%",
-        height="100vh",
+    return rx.vstack(
+        rx.heading("Image Generator"),
+        rx.input(placeholder="Enter a prompt...", on_change=State.set_prompt),
+        rx.button("Generate", on_click=State.generate, loading=State.processing),
+        rx.image(src=State.image_url),
     )
 
 
-# Add state and page to the app.
-app = rx.App()
-app.add_page(index, title="Reflex:DALL-E")
-```
-
-## Let's break this down.
-
-<div align="center">
-<img src="https://raw.githubusercontent.com/reflex-dev/reflex/main/docs/images/dalle_colored_code_example.png" alt="Explaining the differences between backend and frontend parts of the DALL-E app." width="900" />
-</div>
-
-### **Reflex UI**
-
-Let's start with the UI.
-
-```python
-def index():
-    return rx.center(...)
-```
-
-This `index` function defines the frontend of the app.
-
-We use different components such as `center`, `vstack`, `input`, and `button` to build the frontend. Components can be nested within each other
-to create complex layouts. And you can use keyword args to style them with the full power of CSS.
-
-Reflex comes with [60+ built-in components](https://reflex.dev/docs/library) to help you get started. We are actively adding more components, and it's easy to [create your own components](https://reflex.dev/docs/wrapping-react/overview/).
-
-### **State**
-
-Reflex represents your UI as a function of your state.
-
-```python
-class State(rx.State):
-    """The app state."""
-
-    prompt = ""
-    image_url = ""
-    processing = False
-    complete = False
-```
-
-The state defines all the variables (called vars) in an app that can change and the functions that change them.
-
-Here the state is comprised of a `prompt` and `image_url`. There are also the booleans `processing` and `complete` to indicate when to disable the button (during image generation) and when to show the resulting image.
-
-### **Event Handlers**
-
-```python
-def get_image(self):
-    """Get the image from the prompt."""
-    if self.prompt == "":
-        return rx.window_alert("Prompt Empty")
-
-    self.processing, self.complete = True, False
-    yield
-    response = openai_client.images.generate(prompt=self.prompt, n=1, size="1024x1024")
-    self.image_url = response.data[0].url
-    self.processing, self.complete = False, True
-```
-
-Within the state, we define functions called event handlers that change the state vars. Event handlers are the way that we can modify the state in Reflex. They can be called in response to user actions, such as clicking a button or typing in a text box. These actions are called events.
-
-Our DALL·E app has an event handler, `get_image` which gets this image from the OpenAI API. Using `yield` in the middle of an event handler will cause the UI to update. Otherwise the UI will update at the end of the event handler.
-
-### **Routing**
-
-Finally, we define our app.
-
-```python
 app = rx.App()
+app.add_page(index, title="Reflex:Image Generation")
 ```
 
-We add a page from the root of the app to the index component. We also add a title that will show up in the page preview/browser tab.
-
-```python
-app.add_page(index, title="DALL-E")
-```
-
-You can create a multi-page app by adding more pages.
-
-## 📑 Resources
-
-<div align="center">
-
-📑 [Docs](https://reflex.dev/docs/getting-started/introduction) &nbsp; | &nbsp; 🗞️ [Blog](https://reflex.dev/blog) &nbsp; | &nbsp; 📱 [Component Library](https://reflex.dev/docs/library) &nbsp; | &nbsp; 🖼️ [Templates](https://reflex.dev/templates/) &nbsp; | &nbsp; 🛸 [Deployment](https://reflex.dev/docs/hosting/deploy-quick-start) &nbsp;
-
-</div>
-
-## ✅ Status
-
-Reflex launched in December 2022 with the name Pynecone.
-
-🚀 Introducing [Reflex Build](https://build.reflex.dev/) — Our AI-Powered Builder
-Reflex Build uses AI to generate complete full-stack Python applications. It helps you quickly create, customize, and refine your Reflex apps — from frontend components to backend logic — so you can focus on your ideas instead of boilerplate code. Whether you’re prototyping or scaling, Reflex Build accelerates development by intelligently scaffolding and optimizing your app’s entire stack.
-
-Alongside this, [Reflex Cloud](https://cloud.reflex.dev) launched in 2025 to offer the best hosting experience for your Reflex apps. We’re continuously improving the platform with new features and capabilities.
-
-Reflex has new releases and features coming every week! Make sure to :star: star and :eyes: watch this repository to stay up to date.
-
-## Contributing
-
-We welcome contributions of any size! Below are some good ways to get started in the Reflex community.
-
-- **Join Our Discord**: Our [Discord](https://discord.gg/T5WSbC2YtQ) is the best place to get help on your Reflex project and to discuss how you can contribute.
-- **GitHub Discussions**: A great way to talk about features you want added or things that are confusing/need clarification.
-- **GitHub Issues**: [Issues](https://github.com/reflex-dev/reflex/issues) are an excellent way to report bugs. Additionally, you can try and solve an existing issue and submit a PR.
-
-We are actively looking for contributors, no matter your skill level or experience. To contribute check out [CONTRIBUTING.md](https://github.com/reflex-dev/reflex/blob/main/CONTRIBUTING.md)
-
 ## All Thanks To Our Contributors:
 
 <a href="https://github.com/reflex-dev/reflex/graphs/contributors">
   <img src="https://contrib.rocks/image?repo=reflex-dev/reflex" />
 </a>
-
-## License
-
-Reflex is open-source and licensed under the [Apache License 2.0](https://raw.githubusercontent.com/reflex-dev/reflex/main/LICENSE).

docs/advanced_onboarding/code_structure.md

@@ -228,6 +228,10 @@ import reflex as rx
 class State(rx.State):
     v: str = "foo"
 
+    @rx.event
+    def set_v(self, value: str):
+        self.v = value
+
 
 @lru_cache
 def foo():

docs/app/agent_files/_plugin.py

@@ -892,6 +892,10 @@ class AgentFilesPlugin(Plugin):
     def get_static_assets(
         self, **context: Unpack[CommonContext]
     ) -> Sequence[tuple[Path, str | bytes]]:
-        return [
-            (Dirs.PUBLIC / path, content) for path, content in generate_agent_files()
-        ]
+        from reflex_base.config import get_config
+
+        root = Path(Dirs.PUBLIC)
+        if frontend_path := get_config().frontend_path:
+            # Make sure the pre-rendered HTML does not get overwritten by md files.
+            root = root / frontend_path.lstrip("/")
+        return [(root / path, content) for path, content in generate_agent_files()]

docs/app/assets/tailwind-theme.css

@@ -1,3 +1,4 @@
+@import 'tailwindcss-scroll-mask';
 @import "tailwindcss-animated";
 
 @custom-variant dark (&:where(.dark, .dark *));