Troubleshooting

Build fails: vitepress cannot be found

Confirm dependencies are installed and that Cloudflare Pages runs the install step before building.

npm install
npm run build

Build succeeds but pages return 404

Check that the build output directory is .vitepress/dist. A wrong output directory deploys the wrong files.

.vitepress/dist

docs.hideapps.top does not open

1. Confirm docs.hideapps.top is added in Pages Custom domains.
2. Confirm the docs CNAME record exists.
3. Confirm the target is the Pages project domain.
4. Wait for Cloudflare to finish certificate issuance if the domain was just added.

HTTPS certificate stays pending

Check whether hideapps.top has CAA records that restrict certificate issuance. If so, allow the certificate authorities used by Cloudflare.

Local preview works but online styles are missing

This project is deployed at the subdomain root, so VitePress does not need a base value. Only set base when deploying under a subpath such as /docs/.