flutterwindcss 1.0.3

Tailwind CSS v4 design system and styling vocabulary for Flutter — tokens, theming, and a typed utility API over the widgets layer.

Changelog

1.0.3

• Theme fonts now apply. FwTheme applies the theme's sans family as the subtree's default text family, and fontSans/fontSerif/fontMono resolve to the active theme's families (like roundedMd/shadowMd do for radius/shadow) instead of generic names. A pasted/generated theme's fonts take effect once you register the font (bundle it or wire google_fonts). font('Family') remains a literal override. See the new Fonts docs page.
• New utilities: overline (Tailwind overline text-decoration), fit(BoxFit, {alignment}) (Tailwind object-{position}), and FwScroll(trackColor:) (the scrollbar track colour).
• No theme? No problem. The theme-role sugars (fontSans/roundedMd/shadowMd) now fall back to the stock FwTokens.light defaults when no theme is present instead of throwing — so the raw palette + your own fonts work with no FwTheme at all. New context.fwOrNull reads tokens without throwing when a theme is optional. Added a SKILLS.md guide for agentic development.

1.0.2

• Docs — the install instructions are now version-agnostic (flutter pub add flutterwindcss) so the README never disagrees with the version pub.dev shows. No API or behaviour change.

1.0.1

• Docs — the documentation site is live at flutterbits.vercel.app; the README and links now point to it (guides, the .tw utility reference, theming, layout, and the theme generator). No API or behaviour changes.

1.0.0

Initial release.

flutterwindcss is Tailwind CSS v4's design system and styling vocabulary for Flutter — a Material-free styling engine over the framework's primitive widgets layer.

• Tokens — the full Tailwind v4 color palette (FwPalette, baked, no runtime color math) and the complete shadcn semantic vocabulary (FwColors — 32 roles: the 19 core + chart1…5 + 8 sidebar*), plus radius, shadow, typography, opacity, border-width, z-index, blur and breakpoint scales.
• Theming — FwTheme (pure path) and FwThemeExtension (Material interop), read via context.fw; FwTokens.light / FwTokens.dark; and FwAnimatedTheme, which crossfades every token (FwTokens.lerp) on a theme or brightness change.
• The .tw utility API — an accumulator with last-wins conflict resolution that resolves lazily against interaction states (hover/focus/pressed/disabled, plus group/peer) and viewport/container breakpoints (sm…xl, containerSm…). Covers spacing, sizing, color, gradients, borders, radius, typography, effects, filters, transforms (2D + 3D), blend modes, and interactivity.
• Layout widgets — FwRow / FwColumn / FwWrap, FwStack / FwPositioned, and FwGrid (a real CSS-grid render object), all directional (RTL-aware) and responsive.

Requires Flutter ≥ 3.29 / Dart ≥ 3.7.