Skip to content

Commit 7cd2eae

Browse files
auge2uclaude
andcommitted
fix(tokens): pin install to @^0.2.2, add Tailwind compat matrix + upgrade notice
Addresses convoy-009 bead gt-ti003: - Pin install command to @syncupsuite/themes@^0.2.2 (v0.2.0 has broken subpath exports) - Add Tailwind compatibility matrix: version → transformer → dark mode selector - Add upgrade notice for existing v0.2.0 users with path to diagnose-tokens Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent b28960c commit 7cd2eae

1 file changed

Lines changed: 15 additions & 1 deletion

File tree

skills/theme-inspired-tokens/skill.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,28 @@ A Claude Code skill for generating culturally-grounded design token systems wher
88

99
## Quick Start (pre-built)
1010

11+
> **Upgrading from v0.2.0?** Versions before v0.2.2 have broken subpath exports. Run `npm install @syncupsuite/themes@latest` to fix, then run `/webplatform4sync:diagnose-tokens` to audit your integration.
12+
1113
`@syncupsuite/themes` provides pre-built implementations of this pattern. If you want production-ready cultural themes without building from scratch, install the package:
1214

1315
```bash
14-
npm install @syncupsuite/themes # v0.2.2 OKLCH color math, security-audited, zero runtime deps
16+
npm install @syncupsuite/themes@^0.2.2 # OKLCH color math, security-audited, zero runtime deps
1517
```
1618

1719
> **Package quality**: v0.1.1 has been through a comprehensive review — P0 CSS generation bugs fixed, P1 security hardening (CSS injection prevention), PERF_BUDGETS enforced, and 7 Architecture Decision Records (ADR-001 through ADR-007) governing all major design decisions. See `syncupsuite/themes/docs/adr/` for full detail.
1820
21+
### Tailwind Compatibility
22+
23+
Choose the transformer that matches your Tailwind version. Using the wrong one is a silent failure -- utilities register but resolve to nothing.
24+
25+
| Tailwind Version | Transformer | Dark Mode Selector | Config File |
26+
|-----------------|-------------|-------------------|-------------|
27+
| v4 (CSS-first, no config file) | `tailwind-v4` | `[data-theme="dark"]` | None -- uses `@theme` in CSS |
28+
| v3 (`tailwind.config.js`) | `tailwind-v3` | `.dark` | `tailwind.config.js` with `darkMode: 'class'` |
29+
| v3 + `darkMode: 'media'` | `tailwind-v3` | `@media (prefers-color-scheme: dark)` | `tailwind.config.js` with `darkMode: 'media'` |
30+
31+
**How to detect your version**: If you have a `tailwind.config.js` or `tailwind.config.ts` file, you're on v3. If your CSS has `@import "tailwindcss"` and `@theme { }` blocks with no config file, you're on v4.
32+
1933
**CSS usage** -- import directly into your stylesheet:
2034

2135
```css

0 commit comments

Comments
 (0)