// tailwind.config.js - Extinde tema în loc să hardcodezi în JSX
module.exports = {
theme: {
extend: {
colors: {
brand: {
surface: '#f8fafc',
primary: '#2563eb',
text: '#0f172a',
},
},
spacing: {
'18': '4.5rem', // 72px recurent
},
},
},
};Parantezele drepte din Tailwind sunt ca zahărul în cafea: merge puțin când te grăbești, dar dacă exagerezi îți strici dinții și codebase-ul. Scrii w-[342px] la un card pentru că așa a desenat omul de UI în Figma și ai închis ticketul în 5 minute. Problema e ce lași în urmă.
Am avut acum doi ani un proiect de e-commerce cu vreo 14k vizitatori zilnici și o echipă de 4 oameni pe frontend. După 8 luni de sprinturi haotice, am dat un grep prin fișierele .tsx după text-[ și bg-[. Am găsit peste 180 de valori hardcodate. Aveam vreo 12 nuanțe de gri extrem de apropiate, gen #1f2937, #1e293b și #212529. Când clientul ne-a cerut un dark mode curat, a trebuit să luăm la mână fiecare componentă, pentru că nimeni nu mai știa ce culoare are rol semantic și ce culoare a fost doar o lene de moment.
Când e justificat să folosești arbitrary values
Nu sunt extremist, parantezele pătrate există cu un motiv bun. Sunt ideale pentru cazuri izolate, care n-au nicio legătură cu un sistem de design repetabil:
- Integrări cu embed-uri externe sau iframe-uri. Dacă ai un widget de la Stripe sau o hartă care are nevoie strict de
min-h-[480px]ca să nu facă overflow, nu are sens să poluezitailwind.config.jscu o clasă nouă doar pentru asta. - Grid-uri ciudate sau poziționări milimetrice. Un tooltip legat de un icon cu
top-[calc(100%+6px)]sau un grid auto-fit de tipulgrid-cols-[repeat(auto-fill,minmax(280px,1fr))]. - Prototipare rapidă. Dacă vrei să vezi cum stă un element într-un sandbox timp de 20 de minute, bagă ce valori vrei. Doar curăță după tine înainte de PR.
Trade-off-ul e simplu: câștigi 30 de secunde pe moment, dar pierzi predictibilitatea pe termen lung.
Linia roșie: culori, fonturi și spacing recurent
Dacă te prinzi că scrii bg-[#0f172a] a doua oară în componente diferite, e deja greșit. La fel și cu text-[13px]. În momentul în care aduci valori custom în paleta de culori sau tipografie, ignori complet motivul pentru care folosim un design system: consistența vizuală.
La noi în echipă am băgat o regulă de bun simț: regula de 3. Dacă o valoare apare în 3 locuri diferite dintr-un feature, primește nume și merge direct în tema de Tailwind. Dacă designerul insistă cu un padding de 18px în loc de 16px (p-4) sau 20px (p-5), prima reacție ar trebui să fie o discuție pe Slack: „Chiar avem nevoie de 18px aici sau ai scăpat mouse-ul pe artboard?”. În 90% din cazuri, designerul zice „ah, greșeala mea, pune 16px”.
Cum împaci designul cu config-ul
Când ai valori specifice de brand pe care Tailwind nu le acoperă default, extinde config-ul. Nu suprascrie toată tema, doar fă un extend. Astfel păstrezi tot ce oferă framework-ul, dar ai autocomplete în IDE și colegii tăi folosesc aceleași token-uri fără să ghicească hex-uri.
Arbitrary values sunt un bypass pentru cazuri speciale, nu stilul de lucru de zi cu zi. Voi ce regulă aveți în echipă la review-uri când vedeți paranteze pătrate prin PR?