-
Notifications
You must be signed in to change notification settings - Fork 1.7k
Migrate documentation and base template to uv + pyproject.toml #6269
Copy link
Copy link
Open
Labels
enhancementAnything you want improvedAnything you want improved
Description
Summary
All documentation examples and the base project template should use uv as the recommended Python package manager, replacing pip + requirements.txt with uv + pyproject.toml. This gives users strong dependency locking by default via uv.lock.
Motivation
uvprovides fast, reliable dependency resolution with a proper lock file (uv.lock) out of the box — no extra steps needed.requirements.txtdoes not support locking transitive dependencies without additional tooling (pip freeze,pip-tools, etc.), which most users skip.- Aligning on
uvimproves supply chain security posture for the Python side of Reflex apps, complementing efforts to lock JS dependencies as well. uvis rapidly becoming the standard in the Python ecosystem and is what many users already expect.
Proposed Changes
- Base template: Update
reflex inittemplates to generate apyproject.tomlinstead of (or in addition to)requirements.txt. Includereflexas a dependency with a version constraint. - Documentation: Update all installation and quickstart guides to use
uvcommands (e.g.uv init,uv add reflex,uv run reflex init) instead ofpip install. - README / Getting Started: Reflect the
uv-first approach in the repo README and any onboarding materials. - Backward compatibility: Continue to support
pipandrequirements.txtfor users who prefer it, but makeuvthe recommended default.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
enhancementAnything you want improvedAnything you want improved