Fehlerbehebung 1.3.0

Was könnte falsch sein? Häufige Blocker bei Install, Check, Assets und Motion Clips. Für Schritt-für-Schritt-Fixes nutze das Hilfe-Center. Volltext: TROUBLESHOOTING.md. English: Troubleshooting

FAQ Hilfe-Center CLI Forum

Install / CLI

`npx velinstyle` → 404

Paketname ist @birdapi/velinstyle.

npx @birdapi/velinstyle --help

`create` / `check` / `skills` unbekannt

Ab 1.2 Ship-Surface. Installiere @birdapi/velinstyle@1.3.0 oder nutze den CLI aus dem lokalen Clone.

Windows-Pfad / ESM-Fehler

ESM über pathToFileURL. velinstyle doctor ausführen.

Doctor: fehlendes Vendor-CSS

dist/ nach vendor/velinstyle/ kopieren oder Paket installieren.

check / scan / review

`check .` flutet Findings

Nicht auf Docs/Demo-Monorepos zeigen. Scaffold oder einzelne Datei:

velinstyle check ./index.html --profile docs

Review scheitert auf Admin-Seiten

Profil setzen: app, marketing, docs, …

velinstyle check . --profile app

Unbekannte `velin-*`-Klassen

Klassen-Drift — dokumentierte Utilities nutzen oder Blueprints strikt prüfen.

Nested interactive / `aria-hidden`

Echte A11y-Probleme — Markup fixen, Regel nicht stumm schalten.

Build / Assets

Leere Styles nach Clone

dist/ wird generiert: npm install && npm run build.

Icons fehlen

velin-icons.svg neben CSS oder Sprite-Meta setzen.

Theme-CSS 404

Themes unter dist/themes/ — data-velin-themes-base darauf zeigen.

Components / React

Custom Element upgradet nicht

Components-Bundle laden. Placeholders: wc-placeholder.css.

React-Props greifen nicht

@velinstyle/react-Wrapper nutzen — Booleans → Attribute, Objekte → Properties, onVelin* → Events.

Motion Clips / PixVerse

AI-Clip ohne Key

PixVerse-Konto + API-Key, dann velinstyle motion setup pixverse. Leitfaden: PixVerse.

Clip-Input abgelehnt

Nur nicht-leere .webp / .png / .jpg / .jpeg mit echtem Image-Magic.

Immer noch stecken?

Empfohlener Pfad

velinstyle doctor
velinstyle check … --json
BirdAPI-Forum oder GitHub Issues

FAQ · Hilfe-Center · Deploy · CLI · Changelog