The postinstall script will run whenever you install the dependencies for a project. It handles converting any legacy 3rd party commonjs dependencies into browser-runnable ESM. The resulting ESM files are placed in ./public/web_modules/*
and can be cached if you wish (as long as you re-run postinstall when you install new dependencies).
This is the command you'll be running most often.
npm run build
The build command runs the CSS build (Tailwind) and the site build (Toast).
The CSS build compiles Tailwind via PostCSS using Tailwind's "jit" mode.
npm run build:css
postcss-cli
hasn't enabled node v12+ ESM yet, so we have to put our config in a special folder. This folder is legacy-commonjs
and the only reason it is special is that it has a package.json
with a single field: "type": "commonjs"
, which tells node that the files in that folder are all CommonJS files (that is, they use require()
and not import
).
Same as build:css
except it's a watch process that will update your css files as you make changes.
The site build command runs a full Toast build and outputs the results in public/
.
npm run build:site