Add default 404 page to sbt-typelevel-site#871
Open
abby-ql wants to merge 8 commits intotypelevel:mainfrom
Open
Add default 404 page to sbt-typelevel-site#871abby-ql wants to merge 8 commits intotypelevel:mainfrom
abby-ql wants to merge 8 commits intotypelevel:mainfrom
Conversation
added 6 commits
February 23, 2026 21:23
added 2 commits
February 24, 2026 04:05
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR closes issue #217
-adds a default
404.htmlpage tosbt-typelevel-siteinjected at the theme level so that all sites using the plugin automatically receive a 404 page by default-page added programmatically via
ThemeBuilder.addInputs, similar to how the API forwarder page is injected-allow users to override it by providing their own
docs/404.mdordocs/404.html-the default 404 page keeps the Helium style & allow click to go back to homepage(index.html)
Manual testing done to:
-verify
404.htmlis generated when no user defined 404 exists-confirm a user-provided
docs/404.mdoverrides the default-checked correct behavior in
tlSitePreviewand in generated static outputBefore:


Now:
(I initially explored an alternative approach where a default
404.mdwas written intomdocOutso that Laika would render it through Helium and apply full layout styling. This worked visually, but the 404 page appeared in the sidebar and it requires additional task wiring so I gave up on that approach)