Shiny for Python Release Train

Getting Started

1. Ask the user which version of py-shiny is being released (e.g., 1.3.0)
2. Ask if py-htmltools also needs a release (and what version)
3. Ask if any Shiny HTML Dependencies were updated (triggers shinyswatch prerequisite)
4. Create a TodoWrite checklist of all 13 phases
5. Begin with Phase 1

Phase Overview

[ ] Phase 1:  Prerequisites (shinyswatch update if HTML deps changed)
[ ] Phase 2:  Release py-htmltools
[ ] Phase 3:  Release py-shiny
[ ] Phase 4:  Release py-shinyswatch
[ ] Phase 5:  Release py-shinywidgets
[ ] Phase 6:  Update Shinylive (JS) repo
[ ] Phase 7:  Update py-shinylive
[ ] Phase 8:  Update r-shinylive
[ ] Phase 9:  Update py-shiny (bump shinylive docs version)
[ ] Phase 10: Update py-shiny-site
[ ] Phase 11: Conda-forge
[ ] Phase 12: Huggingface
[ ] Phase 13: Publish blog post

For detailed steps in each phase, read references/release-phases.md.

Repos

General Package Release Pattern

Many phases (2-5, 7) follow this common flow:

1. Checkout branch rc-vX.Y.Z
2. Verify pyproject.toml has no git-based deps (e.g., no htmltools @ git+https://...)
3. Bump version (changelog + __init__.py, or tag-based for py-shiny)
4. Commit, push, open PR, wait for CI
5. Verify no additional commits were added to the RC branch beyond the release prep
6. Run the pre-release gate (see above) - present summary and get explicit user confirmation
7. Squash merge the RC PR into main via GitHub (this is the release commit)
8. Tag the squash commit on main: git checkout main && git pull && git tag vX.Y.Z && git push origin vX.Y.Z
9. Create GH Release with changelog content, mark as "Latest"
10. Wait for PyPI publish to succeed
11. If publish fails: delete tag + GH Release, fix, redo

On Failure

• For PyPI failures: remind user to delete the tag and GH Release before retrying
• For CI failures: help investigate logs with gh run view
• For shinylive build failures: check make clean && make all output
• Never proceed to the next phase until the current one is resolved or explicitly skipped