The dev.py script is an interactive CLI tool used to control which documentation pages are loaded during local development.
It replaces manual environment variable setup and makes it easier to selectively run parts of the documentation site while developing.
This script uses questionary for interactive prompts.
Install it using your project setup:
uv add questionary
You can also add it manually to your pyproject.toml:
dependencies = ["questionary"]
Instead of running the full documentation build every time, dev.py lets you:
It then automatically configures the correct environment variables and starts the Reflex server.
Run the script from your project root to start the interactive flow:
uv run dev.py
The CLI follows this flow:
Before selecting what to run, you must choose the environment.
This determines whether the CLI runs the full documentation site or a filtered development subset.
Development mode allows you to work on specific parts of the documentation without loading the entire site.
It enables selective loading of pages through the dev.py CLI.
Use this mode when:
Production mode runs the full documentation site without any filtering.
Select individual pages from all available documentation. Useful when working on specific content or debugging a single page.
Select one or more sections. All pages inside those sections will be loaded automatically. Useful when working on a feature area.
Select one or more sections first, then choose specific pages inside them. Useful when you want focused work inside a feature area without loading everything.