^{Get started} Useful scripts

This package provides a pre-configured do folder setup that helps organize your development workflow using npm workspaces. The do folder contains scripts for building and running your Eleventy project.

Install #

1. Install /anyblades/eleventy-blades to reuse pre-defined 11ty scripts from there:

npm install @anyblades/eleventy-blades

2. Create a helper folder do to symlink the do/package.json within:

mkdir do
cd do/
ln -s ../node_modules/@anyblades/eleventy-blades/packages/do/package.json

3. Finally register do folder as npm workspace in your root package.json:

{
  ...
  "workspaces": ["do"],
  "scripts": {
    "start": "npm -w do run start",
    "stage": "npm -w do run stage",
    "build": "npm -w do run build"
  },
  ...
}

Done! 🎉 Now you can run:

• npm start to start 11ty dev server with live reload and Tailwind watch mode
• npm run stage to build and serve production-like site locally
• npm run build to finally build the site for production
• all available scripts: /anyblades/eleventy-blades/blob/main/packages/do/package.json

Live examples #

• /anyblades/buildawesome-starters
• /anyblades/subtle/tree/main/.11ty
• /johnheenan/minform

Benefits #

Clean separation

Keep build scripts separate from project configuration

Reusable workflows

Update scripts by upgrading the package

Workspace isolation

Scripts run in their own workspace context

Easy maintenance

No need to manually maintain build scripts

More #

Find and kill 11ty processes #

ps aux | grep eleventy
pkill -f eleventy

You can even combine it with other processes hanging around:

ps aux | grep -E 'eleventy|tailwind|.bin/serve'
pkill -f tailwind
pkill -f .bin/serve