Skip to content

docs: add Node.js/npm prerequisites to build instructions#128

Merged
sanity merged 1 commit intomainfrom
fix-120-readme-npm-prereqs
Mar 5, 2026
Merged

docs: add Node.js/npm prerequisites to build instructions#128
sanity merged 1 commit intomainfrom
fix-120-readme-npm-prereqs

Conversation

@sanity
Copy link
Contributor

@sanity sanity commented Mar 5, 2026

Problem

The README's "Building and Running the UI" section lists Rust, cargo-make, and dioxus-cli as prerequisites but doesn't mention Node.js/npm. The cargo make dev-example task depends on build-tailwind, which runs npm run build:css in the ui/ directory. Anyone following the documented steps on a fresh clone gets a confusing failure when npm isn't installed or when node_modules is missing.

Approach

  • Added Node.js (v20+) installation step to the prerequisites, with a note that system packages may be outdated (as the issue reporter discovered)
  • Added cd ui && npm install && cd .. step before cargo make dev-example

Testing

Verified the instructions are consistent with Makefile.toml task graph (dev-examplebuild-tailwindnpm run build:css in ./ui) and ui/package.json devDependencies.

Closes #120

[AI-assisted - Claude]

The `cargo make dev-example` task depends on `npm run build:css` for
Tailwind CSS, but the README didn't mention installing Node.js/npm or
running `npm install` in the `ui/` directory. New contributors following
the documented steps would hit a confusing failure.

Closes #120

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@sanity sanity merged commit 080be16 into main Mar 5, 2026
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.

Build instructions incomplete

1 participant