- Docs
- Help
- npm install
Docs for VelinStyle 1.3.x · verified against 1.3.0
npm install does not work 1.3.0
Resolve package, version, and Windows module setup problems before changing your project. Deutsch
Problem
Install fails, the wrong package resolves, or the CLI is missing after install.
First check
Run the general diagnostic from the project directory first.
npx @birdapi/velinstyle doctor
Deeper check
npm install @birdapi/velinstyle@1.3.0
npx @birdapi/velinstyle doctor
Quick check
- Run commands from the intended project directory.
- Use only documented profiles and flags.
- Check again after every change.
Wrong package name
Cause: Bare velinstyle is not the published package; the scoped name is required.
- Solution 1: Install with
npm install @birdapi/velinstyle@1.3.0. - Solution 2: Replace bare
npx velinstyle with npx @birdapi/velinstyle …. - Solution 3: Confirm
package.json lists @birdapi/velinstyle, not an unscoped name.
Verify againnpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs
An older version is installed
Cause: Docs and CLI examples for 1.3.x need package 1.3.0 (or later matching the docs line).
- Solution 1: Pin or upgrade to
@birdapi/velinstyle@1.3.0. - Solution 2: Re-run
npx @birdapi/velinstyle doctor and compare the reported version. - Solution 3: Clear a stale global/npx cache only after the local dependency is correct.
Verify againnpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs
Windows / ESM resolution fails
Cause: Node cannot resolve the package exports or the CLI entry on this machine.
- Solution 1: Use a current Node LTS and reinstall
@birdapi/velinstyle in the project root. - Solution 2: Import only documented exports such as
@birdapi/velinstyle/css or /motion. - Solution 3: Run the CLI via
npx @birdapi/velinstyle doctor from the project directory.
Verify againnpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs
VelinStyle