- Docs
- Help
- Icons missing
Docs for VelinStyle 1.3.x · verified against 1.3.0
Icons are missing 1.3.0
Validate the sprite path and build the icon set with the supported icon commands. Deutsch
Problem
Icons render empty, the sprite 404s, or requested names are absent from the sprite.
First check
Run the general diagnostic from the project directory first.
npx @birdapi/velinstyle doctor
Deeper check
npx @birdapi/velinstyle icons list
npx @birdapi/velinstyle icons build
Quick check
- Run commands from the intended project directory.
- Use only documented profiles and flags.
- Check again after every change.
The icon sprite returns 404
Cause: The sprite URL in meta/markup does not point at a deployed dist/velin-icons.svg.
- Solution 1: Set
<meta name="velin-icon-sprite" content="…/dist/velin-icons.svg"> to a real path. - Solution 2: Confirm the file exists after install/build of 1.3.0.
- Solution 3: There is no
icons doctor — use global doctor plus icons list / icons build.
Verify againnpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs
Requested icons are not in the sprite
Cause: Icons were never added to the local set or the sprite was not rebuilt.
- Solution 1: Add icons, e.g.
npx @birdapi/velinstyle icons add lucide --icons menu,search. - Solution 2: Rebuild with
npx @birdapi/velinstyle icons build. - Solution 3: Verify names via
npx @birdapi/velinstyle icons list.
Verify againnpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs
VelinStyle