GitHub Pages

Curvea static output can be hosted on GitHub Pages.

Project-site base path

A project site is normally served below the repository name:

/<repository-name>/

Configure the public origin and base path:

{
  "site": {
    "url": "https://username.github.io",
    "basePath": "/repository-name/"
  }
}

Curvea rewrites root-relative href and src values using site.basePath and uses the same configuration when constructing SEO/sitemap URLs.

Build

npm ci
npm run build

Publish the generated dist directory using your GitHub Pages workflow.

For a user/organization site or custom-domain deployment served from /, use "basePath": "/".