Deploy a Vite site with ESA Pages.

Know the hosting model

ESA Pages serves the static output produced by Vite. It does not keep npm run dev or an Express listener running.

Build and verify

1. Run npm ci to install the locked dependencies.
2. Run npm run build and confirm that dist/ is created.
3. Run npm run preview and test every route.
4. Push the source and package-lock.json to GitHub; do not commit node_modules/ or dist/.

Connect the repository

In Functions & Pages, create or edit a Pages project, authorize GitHub, select the repository and production branch, then configure:

Install: npm ci
Build: npm run build
Root: /
Static assets: ./dist
Function file: blank
Node.js: 22.x

A new push to the configured production branch can trigger a new build and deployment.

Plan for limits

Official documentation currently lists a maximum of 2,000 Pages files, 25 MB per file and a 1,024 MB compressed package. Use OSS for large downloads instead of placing them in the Pages build.