Skip to content

Feat: site build enhancements#9247

Open
espy wants to merge 17 commits intoapache:masterfrom
neighbourhoodie:feat-site-build-enhancements
Open

Feat: site build enhancements#9247
espy wants to merge 17 commits intoapache:masterfrom
neighbourhoodie:feat-site-build-enhancements

Conversation

@espy
Copy link
Copy Markdown
Contributor

@espy espy commented May 5, 2026

This PR adds various improvements to the site, mainly concerning the build process, and removes, simplifies and hardens a bunch of build and dev server related stuff. These are in preparation for #9246, so that all gets easier to do.

Overview

  • Uses eleventy-plugin-syntaxhighlight instead of custom highlighting code, adapts code.js to work with this new output.
  • Restructures layouts and enforces full filenames with extensions when using includes (faster and less error-prone).
  • Use a less roundabout way of compiling LESS files.
  • Different handling of js and css minification (js via an 11ty transform, css via an npm cli command).
  • Removes a bunch of pre- and post-processing from build-site.js and the 11ty config that don't seem to be needed any longer.
  • Use execa instead of exec to run CLI scripts in build-site, this now correctly displays logs from 11ty, handles cleanup of orphaned child processes properly, and resumes work after an 11ty crash and subsequent rebuild without having to restart the process manually.
  • Removes the stickyfill polyfill, as position: sticky is widely available.
  • Reformats the serviceworker output and adds a line to stop SW from intercepting browser extension requests, and another to only intercept GET requests. This broke the use of the PouchDB instance in the browser console, for example when demoing replication to a local CouchDB, since the SW would intercept the POST requests and then fail, because it can’t cache them.
  • Fixed the github edit button linking to the wrong place occasionally.
  • Various other smaller CSS improvements and fixes to the site content.

Testing recommendations

Build the site locally and compare it to pouchdb.com:

$ npm i
$ npm run build-site

Checklist

  • I am not a bot
  • This is my own work, I did not use AI, LLM's or similar technology for code or docs generation
  • Code is written and works correctly

espy added 17 commits May 4, 2026 10:43
No longer maxes out CPUs and no more orphaned node processes
… any longer, plus some cleanup in the config file
No longer swallows logs from eleventy and leaves child processes hanging on crash. Also rebuilds after 11ty crashing, no need to restart process anymore.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant