Reference

Errors and Troubleshooting

This page lists common errors from the current implementation.

File declaration errors

Error:

File must declare exactly one role: @page, @layout Name, @component Name(props), or @document

Fix: add one valid file declaration.

Error:

Only one file declaration is allowed

Fix: keep only one role per .csc file.

Error:

Page files must begin with @page. Only whitespace and blank lines may appear before it

Fix: move @page to the top of the file.

Error:

Layout not found: Main

Fix: create:

src/layouts/Main.csc

Error:

Unknown layout prop "..." for layout "...".

Fix: declare the prop in the layout or remove it from @use.

Error:

Component "Hero" used but not imported in this file.

Fix:

@import Hero

Fix: check file path inside src/components.

Fix the JSON syntax in the referenced data file.

Fix the @load path or create the missing data file/folder.

Error:

@paginate source "..." was not found in @load aliases

Fix: load the array first using @load.

Fix: make the loaded data an array or load a folder collection.

Error:

Sitemap requires "site.url" in curvea.config.json

Fix: set site.url.

A custom document must include:

2 min read