`@birdapi/velinstyle-tailwind` 1.4.0

Optional Compatibility Layer for migrating Tailwind projects to VelinStyle. Compatibility ≠ Design System. Deutsch

Purpose

Ship Tailwind-near utilities that must not bloat Core
Opt-in via npm package + CLI --compat tailwind
Keep Core semantic (@birdapi/velinstyle)

Architecture

Core (@birdapi/velinstyle)
  ↓
Compatibility (@birdapi/velinstyle-tailwind)  — optional CSS + catalog
  ↓
Heuristic (--heuristic palette-roles)         — optional map-only

Installation

npm install @birdapi/velinstyle@1.4.0 @birdapi/velinstyle-tailwind@1.4.0

@import '@birdapi/velinstyle';
@import '@birdapi/velinstyle-tailwind';

Import Core first. Class names use the velin-* prefix (e.g. px-4 → velin-px-4). There is no velin-tw-* prefix.

Root subpaths: @birdapi/velinstyle/tailwind and @birdapi/velinstyle/tailwind/css.

Package facts (1.4.0)

Field	Value
version	1.4.0 (tracks Core minor)
type	module
license	MIT
engines	node >= 18
CSS entry	`./src/index.css`
repository.directory	`packages/velinstyle-tailwind`

Sheet structure (exports)

spacing, sizing, flex-grid, misc
opacity-color (Tier 1), opacity-color-tier2
static-scale, medium-static, final-static
responsive (sm|md|lg|xl only)

Catalog & collisions

Catalog	Size
Core	1427
Compat	2736
Core ∩ Compat	∅ (enforced on merge)

CLI

See Tailwind migrate guide. Without --compat, Compat classes are never applied silently.

Compat catalog ≠ Migration Intelligence Rewrite Catalog. Residual Theme/Palette mappings stay empty until explicitly freigegeben — see Migration Intelligence.

Out of this package

Heuristics, State/Dark engines, arbitrary values, and cn() rewriting are not Compat CSS responsibilities.

@birdapi/velinstyle-tailwind 1.4.0