Troubleshooting

The health endpoint fails

Open /api/pagiera/health and address the first failing dependency. Verify environment variables are available to the Next.js server process, then test PostgreSQL and Redis independently.

The editor has no styles

Import pagiera/full.css before your own stylesheet. CSS @import rules must appear before ordinary style rules. Restart the dev server after changing the root stylesheet.

getEditorBootstrap is not a function

Your application and generated lockfile may be resolving different package versions. Inspect the installed pagiera version, reinstall dependencies and restart Next.js.

AI generation fails

Confirm that OPENROUTER_API_KEY is present on the server and that OPENROUTER_MODEL names a model available to the account. AI is optional; remove its configuration while diagnosing the core editor.

Published API data is missing from HTML

Load the published document with request context on the server. Verify route parameters and query values match the placeholders used by Request blocks. Inspect the raw HTML response rather than only the hydrated browser view.

A page saves but does not change publicly

Saving changes the draft only. Open preview to verify the draft, then publish it. If the public page remains stale, check Redis connectivity and cache invalidation.