Reference

Configuration Reference

Curvea project configuration lives in:

curvea.config.json

Default site config

{
  "site": {
    "name": "My Site",
    "url": "",
    "description": "A professional site built with Curvea.",
    "language": "en",
    "favicon": "/favicon.ico",
    "image": "",
    "basePath": "/",
    "theme": {
      "defaultMode": "system",
      "storageKey": "curvea-theme"
    }
  }
}

`site.name`

Website name.

Used in templates as:

{{ site.name }}

Also used as an SEO fallback title.

`site.url`

Absolute site URL without trailing slash.

Used for canonical URLs and sitemap output.

Example:

"url": "https://example.com"

`site.description`

Default site description.

Used as an SEO fallback.

`site.language`

Language code injected into <html lang="...">.

Default:

en

`site.favicon`

Favicon path.

Default:

/favicon.ico

`site.image`

Default SEO/social image.

`site.basePath`

Base path for subdirectory deployment.

Default:

`site.theme.defaultMode`

Default theme mode.

Supported:

light
dark
system

`site.theme.storageKey`

Local storage key used by the theme runtime.

1 min read