Simply push files to gh-pages on github and manage subdirectories. Also create a index.html file listing subdirectories as root. Easy way to publish documentation for multiple versions of a project for example.

npm i -g @koumoul/gh-pages-multi

Check out the gh-pages publication for this repo as an example of generated index.html.

Push the 'docs' directory into the gh-pages branch of the current repository in a 'latest' subdirectory.

gh-pages-multi deploy

Push the 'dist' directory into the gh-pages branch of the current repository in a 'v1.0.0' subdirectory.

gh-pages-multi deploy -s dist -t v1.0.0

Push the 'docs' directory into the gh-pages branch of the current repository in a 'latest' subdirectory, and erase all previous history concerning 'latest'. Very useful to prevent bloating the git repo if the pushed content contains built files for example.

gh-pages-multi deploy --no-history

Propose a better target directory name from a branch/tag name.

gh-pages-multi better-target v2.0.0

Show help.

gh-pages-multi --help
gh-pages-multi deploy --help