- Docs
- Help
- Build output
Docs for VelinStyle 1.3.x · verified against 1.3.0
Build output is missing 1.3.0
Check the published distribution files and production output configuration. Deutsch
Problem
Expected CSS/JS under dist/ or dist/velin-production/ is missing or incomplete.
First check
Run the general diagnostic from the project directory first.
npx @birdapi/velinstyle doctor
Deeper check
npx @birdapi/velinstyle production . --explain
npx @birdapi/velinstyle blueprint --strict
Quick check
- Run commands from the intended project directory.
- Use only documented profiles and flags.
- Check again after every change.
Distribution files are missing
Cause: The page references assets that were never built or never published into the deploy tree.
- Solution 1: Confirm
dist/velinstyle.min.css and dist/velinstyle-components.min.js exist for 1.3.0. - Solution 2: Point HTML to those paths (or the matching theme files under
dist/themes/). - Solution 3: Re-run your framework/site sync so the deployed tree matches the package.
Verify againnpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs
Production output is incomplete
Cause: production wrote a trimmed bundle that no longer contains required classes or assets.
- Solution 1: Inspect with
npx @birdapi/velinstyle production . --explain before changing flags. - Solution 2: Add only needed dynamic classes via
--safelist (example: --safelist .my-dynamic-class). - Solution 3: Rebuild into
dist/velin-production/ and verify the page against that output.
Verify againnpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs