This project requires the caswow.library to function correctly.
See the section on installing the caswow.library as part of the overall local development setup.
This project has transitioned to using PNPM as the package manager. The goal is to improve performance and efficiency in managing dependencies.
Install PNPM globally if you haven't already:
npm install -g pnpmImport existing lockfiles from NPM, if they exist:
pnpm importInstall dependencies:
pnpm installAll subsequent commands that previously used npm should now use pnpm without declaring run. For example, to run the development server, instead of npm run dev use:
pnpm devTo run CAS WOW locally, simply clone the repository and install dependencies. Currently, this project requires Node v22, which can be set on a project basis by entering nvm use in the terminal.
git clone git@github.com:ComponentAssemblySystems/casWOW.gitpnpm install
casWOW depends on a released version of @componentassemblysystems/caswow.library, pinned to its git tag in package.json (github:ComponentAssemblySystems/caswow.library#v0.24.0). pnpm install fetches that tag with your GitHub access; no registry token is needed. pnpm-lock.yaml records the exact commit.
To move to a new release, read its entry in the library's MIGRATION.md, change the tag in package.json, and run:
pnpm install
pnpm buildTo work against your local copy of the library instead, for example while changing the library and casWOW together:
pnpm link-cas # links ../caswow.library
pnpm unlink-cas # back to the pinned releasepnpm link-cas writes a link: override into pnpm-workspace.yaml. Run pnpm unlink-cas before you commit, so the override and a linked pnpm-lock.yaml are never committed.
Build the site to copy the library stylesheet and its self-hosted fonts directly into the published output:
pnpm buildThe application loads only docs/library/caswow.css. Eleventy copies it, its source map, and docs/library/fonts/ from node_modules/@componentassemblysystems/caswow.library. Do not add local CSS copies or extra stylesheets.
pnpm copy-cas and pnpm css also rebuild the site. pnpm watch:cas watches ../caswow.library and rebuilds when its CSS or fonts change; it is only useful while the library is linked.
The casWOW demo site has two entry points - /casWOW/ and /casWOW/index-old/. The baseline /casWOW/ page is the dashboard, whereas /casWOW/index-old/ shows all of the available pages, without having to dive into each according to the standard user workflow.
Architectural drawing found under
/plansPhoto by Amsterdam City Archives on Unsplash