Instructions and notes for preparing and publishing a release.

Pre-Release check

Step 1. Clean your local repo copy:

git clean -fdx

Step 2. Build the JS and CSS:

npm install
npm run build

Step 3. Check for updated version numbers in

  • package.json


Step 4. Tag the repo with:

git tag -a release_tag -m "Release msg"
git push origin release_tag

Step 5. Build sdist and wheels packages:

python sdist
python bdist_wheel

Step 6. Upload sdist and wheels to PyPI:

twine upload dist/*

Step 7. Push changes to conda-forge:

The conda recipe to build the RISE package is maintained in a separate github repo at

  • First read this section:
  • You need to update the version number here:
  • You need to update the sha number here:
  • (Optional) You need to update any dependencies if you have new ones or remove old ones.
  • (Optional) You may want to update the recipe, for instance, eventually, we will get rid of the post-link steps (see,
  • (Optional) You may need to rerender the feedstock, eventually.

Open a PR with those changes and when the PR is merged, several CI runs will be triggered and the packages will be generated and uploaded to