FAQ 1.3.0

What is it? Short answers for first-time users. For “what might be wrong?” see Troubleshooting; for “how do I fix it?” see the Help center. Full prose: FAQ.md. Deutsch: FAQ

Get started Troubleshooting Help center CLI ship surface

Basics What is VelinStyle?

An accessibility-first CSS + Web Components framework with a CLI, plus Design Intelligence and AI Skills (beta). Not just utility classes.

Install What is the npm package name?

@birdapi/velinstyle — not velinstyle. Prefer a pinned tag for production:

npm i @birdapi/velinstyle@1.3.0
npx @birdapi/velinstyle --help

Install Which version should I install?

Current line: 1.3.0 (Motion Clips). See the Changelog for Security → Debt → RC → Clips.

A11y Does AAA mean my app is certified?

No. Defaults are AAA-oriented. Your markup, content, and flows still need review. Guide: Accessibility.

Fit What can I ship today?

Strong: marketing landings, docs shells, simple admin starters (create + check).
Not yet primary: large multipage shop + enterprise admin without custom work.

Setup Do I need a bundler?

No. CDN CSS + optional component bundle works. Vite/React are optional via @velinstyle/react.

API CSS classes vs Web Components?

Use CSS/BEM for look. Upgrade to a <velin-*> element when you need behavior (modals, search, tables, toasts).

CLI What is velinstyle check?

doctor + blueprint --strict + scan + review. Use on consumer scaffolds — not as one gate over a huge docs/demo tree.

1.3 What are Motion Clips?

Image→clip pipeline in @birdapi/velinstyle-motion (local HTML/CSS effects; optional PixVerse AI). Guides: Motion clips · PixVerse.

Beta What is Design Intelligence?

Plan → registries → constraints → review. Encodes “what a good page is” beyond class lists. Beta. Guide

Beta What are AI Skills?

Machine-readable skill records + workflows so agents and humans share vocabulary. Assistive — they do not replace you. Guide

Themes How do I customize themes?

data-velin-theme="…" on <html>, optional data-velin-contrast="aa". Tokens via CSS variables / velinstyle tokens. See Design tokens.

Compare Why not just Tailwind?

Heavy Tailwind UIs often pile 10–15 utilities on one control. VelinStyle is component-first (velin-btn velin-btn--primary), with utilities for tweaks. See Migration: Tailwind sprawl.

Legal License?

MIT — License page.

Troubleshooting · Help center · Deploy · CLI · Changelog