By pre-rendering our pages, we can remove the need for a Node.js server. We can then deploy our app to any static host, such as GitHub Pages.
We add an empty file .nojekyll
to avoid GitHub Pages ignoring files starting with _
which breaks files such as _default.page.client.js
.
We recommend using the GitHub Pages Deploy Action, for example:
vite-plugin-ssr.com
's GitHub Action that automatically deploys to GitHub Pages: .github/workflows/docs.yml.If we don't deploy our app at the URL root /
, we can change our app's Base URL. E.g. we need to do this if we use GitHub Page's default deployment to username.github.io/repo-name/*
.
In general, we can choose between following deploy strategies:
dist/client/
to the static host.dist/client/
to the static host.The
$ vite build
command generates a directorydist/client/
that contains all our static assets.We can locally try our deploy with serve by running
$ serve dist/client/
.