Custom Markdown error pages — blocked on #111 #153

Closed
opened 2026-10-25 13:56:20 +00:00 by eleith-gitea-agent · 1 comment

Status

Blocked on #111 — SvelteKit 3 migration, which is currently blocked on Auth.js compatibility.

Keep built-in, non-customizable error pages until this dependency is resolved. The unpublished Kit 2 implementation has been reverted rather than introducing per-callsite error wrappers or shared error content in healthy pages.

Desired behavior

  • Optional author-managed Markdown for a distinct 404 page and the 5xx class; decide whether a separate remaining-4xx fallback is useful when resuming.
  • Short boolean control for the built-in recovery/home button.
  • Ordinary Markdown only: raw HTML disabled, no authored helpers/directives/interpolation and no asset publication or transformation.
  • Preserve the actual HTTP status and safe built-in fallback when customization is unavailable.
  • Load/cache only the selected error content; do not load or serialize error copy on healthy pages.
  • Leave normal SvelteKit error calls, authentication redirects, JSON/API responses and inline form validation behavior intact.

Implementation direction after #111

Use SvelteKit 3's native unified error hook and error presentation. Do not require every error caller to use an application-specific throwing wrapper. Keep configuration paths/private exception details server-only; only safe rendered copy/settings may travel with a UI error.

Retain built-in fallback for browser-only failures that cannot obtain server content. Verify expected, framework-generated and unexpected server errors, server-backed navigation, HTTP statuses, body/button selection and failure isolation before publication.

Home/feed Markdown sections already landed in #152 and are not blocked or reverted by this issue.

## Status **Blocked on #111 — SvelteKit 3 migration**, which is currently blocked on Auth.js compatibility. Keep built-in, non-customizable error pages until this dependency is resolved. The unpublished Kit 2 implementation has been reverted rather than introducing per-callsite error wrappers or shared error content in healthy pages. ## Desired behavior - Optional author-managed Markdown for a distinct **404** page and the **5xx class**; decide whether a separate remaining-4xx fallback is useful when resuming. - Short boolean control for the built-in recovery/home button. - Ordinary Markdown only: raw HTML disabled, no authored helpers/directives/interpolation and no asset publication or transformation. - Preserve the actual HTTP status and safe built-in fallback when customization is unavailable. - Load/cache only the selected error content; do not load or serialize error copy on healthy pages. - Leave normal SvelteKit error calls, authentication redirects, JSON/API responses and inline form validation behavior intact. ## Implementation direction after #111 Use SvelteKit 3's native unified error hook and error presentation. Do not require every error caller to use an application-specific throwing wrapper. Keep configuration paths/private exception details server-only; only safe rendered copy/settings may travel with a UI error. Retain built-in fallback for browser-only failures that cannot obtain server content. Verify expected, framework-generated and unexpected server errors, server-backed navigation, HTTP statuses, body/button selection and failure isolation before publication. Home/feed Markdown sections already landed in #152 and are not blocked or reverted by this issue.
eleith-gitea-agent Bot added the enhancement label 2026-10-25 13:56:20 +00:00

Implemented in 65f2ffe5, with demo overrides and the startup follow-up in db6d2076. Merged via #177: distinct Markdown presentations for 404, remaining 4xx and server errors.

Implemented in [65f2ffe5](https://git.eleith.com/eleith/luzzle/commit/65f2ffe57d26e5a08ef4b561733bf08fb8549469), with demo overrides and the startup follow-up in [db6d2076](https://git.eleith.com/eleith/luzzle/commit/db6d20767431f100ed5816efa1727f367ede3263). Merged via #177: distinct Markdown presentations for 404, remaining 4xx and server errors.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Reference: eleith/luzzle#153