Skip to content

fix: rename tailwind export formats for clarity and backwards compat#64

Merged
davideast merged 1 commit into
mainfrom
fix/tailwind-export-naming
May 2, 2026
Merged

fix: rename tailwind export formats for clarity and backwards compat#64
davideast merged 1 commit into
mainfrom
fix/tailwind-export-naming

Conversation

@davideast
Copy link
Copy Markdown
Collaborator

Summary

Renames the export format flags introduced in #45 to avoid the "Tailwind CSS" product name confusion and restore backwards compatibility.

Before (PR #45)

Flag Output Breaking?
--format tailwind v4 CSS @theme block Yes — was JSON
--format tailwind-v3 v3 JSON theme.extend New

After (this PR)

Flag Output Breaking?
--format css-tailwind v4 CSS @theme block New
--format json-tailwind v3 JSON theme.extend New
--format tailwind v3 JSON (alias for json-tailwind) No break

Why output-first naming?

  • tailwind-css reads like the framework's own name ("Tailwind CSS") — confusing
  • css-tailwind reads as "CSS output for Tailwind" — the output type leads
  • An agent seeing css-tailwind immediately knows it gets CSS; json-tailwind means JSON
  • --format tailwind stays backwards-compatible (JSON output, same as before feat: add Tailwind CSS v4 export support #45)

Changes

  • export.ts: FORMATS array updated, dispatch logic remapped
  • README.md: Export section and interop section updated with new format names and a format reference table

Verification

  • ✅ 232 tests pass, 0 failures
  • --format json-tailwind → JSON output
  • --format css-tailwind → CSS @theme output
  • --format tailwind → JSON output (backwards-compatible alias)
  • check-package passes (24/25, pre-existing spec.md issue)

Rename export format flags to avoid 'Tailwind CSS' product name confusion
and restore backwards compatibility:

- css-tailwind: Tailwind v4 CSS @theme block (new)
- json-tailwind: Tailwind v3 theme.extend JSON
- tailwind: backwards-compatible alias for json-tailwind

The output-first naming (css-*, json-*) tells the user what they'll get
before which tool it targets. Bare 'tailwind' preserves existing behavior
(JSON output), preventing a breaking change from PR #45.

Updates README.md export section and interop docs to reflect new naming.
@davideast davideast merged commit 1d002db into main May 2, 2026
9 checks passed
@davideast davideast deleted the fix/tailwind-export-naming branch May 2, 2026 14:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant