Eleventy Dev Server v2.0.1

• Adds messageOnStart callback to customize console log message when server starts. #79
• Adds Node 22 to test suite.
• Disables disk cache by default (useCache: true option to re-enable). Fixes #60
• Fixes issue with default domDiff option when using as CLI (enabled by default)
• Included with Eleventy core v3.0.0-alpha.11.
• Full Changelog: v2.0.0...v2.0.1
• Milestone: https://github.com/11ty/eleventy-dev-server/milestone/5?closed=1

Eleventy Dev Server v2.0.0

• Full Changelog: v1.0.4...v2.0.0
• Milestone: https://github.com/11ty/eleventy-dev-server/milestone/4?closed=1
• Eleventy Dev Server documentation

Changes

Breaking

• Node minimum bumped from 14 to 18+.

Minor Changes

• Adds support for on-request handling via the onRequest option passed as third argument to the server constructor (or passed in via setServerOptions in Eleventy. Read more on the Eleventy documentation. Here’s an Eleventy usage example:

eleventyConfig.setServerOptions({
  onRequest: {
    "/foo/:name": function({ url, pattern, patternGroups }) {
      // Can return false (to skip), a string (for body content), or object for more advanced processing, e.g.:
      return {
        status: 200,
        headers: {
          "Content-Type": "text/html",
        },
        body: `Hello.`
      };
    }
  }
});

• Fix CSS live reload behavior when some stylesheets have no URL by @bcole808 in #76
• Add support for byte-range requests by @joemaller in #62
• Add indexFileName option to change default index filename from index.html by @dpikt in #69
• Bugfix for trailing slash redirects when using pathPrefix option. by @petershafer in #64

New Contributors

• @bcole808 made their first contribution in #76
• @joemaller made their first contribution in #62
• @dpikt made their first contribution in #69
• @petershafer made their first contribution in #64

Eleventy Dev Server v1.0.4

What's Changed

• Allows setting content type header via middleware by @sguter90 in #47
• Add sec-fetch-mode check for XHR/Fetch content by @thomaswilburn in #52
• Fix for JS errors on custom 404 pages (via Dev Server CSP) #55
• Fix for extra 404 page content on serverless routes on projects using a custom 404 page #58
• Full Changelog: v1.0.3...v1.0.4
• Milestone: https://github.com/11ty/eleventy-dev-server/milestone/3?closed=1

Eleventy Dev Server documentation

Eleventy Dev Server v1.0.2

A tiny bug fix release to re-enable a regression in the DOM diff updates, more at #48.

• Milestone: https://github.com/11ty/eleventy-dev-server/milestone/2?closed=1
• Full Changelog: v1.0.1...v1.0.2

If you’re using this server with Eleventy (2.0 or newer), note that it is bundled with Eleventy and does not require a separate install!

• Review the full Eleventy Dev Server docs on 11ty.dev.

Eleventy Dev Server v1.0.0

The stable release! This development server was originally developed for Eleventy to replace its browser-sync dependency but evolved to include its own standalone CLI for independent use!

Features

• Minimalist footprint (super fast npm install times):
  • 39 modules
  • node_modules weigh 1.4 MB, compare to vite at 24 MB or browser-sync at 101 MB.
• Bundler-decoupled: your code is not modified or transpiled.
• Super fast startup times: ~2ms (Macbook Air M1 2020)
• Live reload using WebSockets
  • No page refresh CSS updates
  • dom-diffing updates for HTML (via morphdom)
• https support locally
• Automatic port reassignment when port is already in use.
• Milestone: https://github.com/11ty/eleventy-dev-server/issues?q=is%3Aclosed+milestone%3Av1.0.0
• Full Changelog: https://github.com/11ty/eleventy-dev-server/commits/v1.0.0

Usage

With Eleventy

If using with Eleventy (2.0 or newer), this server is bundled with Eleventy and does not require a separate install!

Please review the full Eleventy Dev Server docs on 11ty.dev.

Relevant videos on the Eleventy YouTube Channel

• The Brand New Eleventy Development Server, Eleventy Weekly №3 (2022-W9)
• Shipping the new Eleventy Dev Server; the new Server API; a Vite Demo—Eleventy Weekly №4 (2022-W10)
• The Dreaded Markdown Indented Code Blocks, Twig Templates, Dev Server CLI—Eleventy 🎈 Weekly №14

Standalone CLI

Eleventy Dev Server includes a CLI. The CLI is for standalone (non-Eleventy) use only: separate installation is unnecessary if you’re using this server with @11ty/eleventy.

npm install -g @11ty/eleventy-dev-server

# Alternatively, install locally into your project
npm install @11ty/eleventy-dev-server

This package requires Node 14 or newer.

Contributions from:

• fixes error on LAN live-reload by @wommy in #23
• fix: reload client gets injected before importmaps, breaking importmaps by @p-ob in #33