חזרה למאמרים

AI Tools

איך להגדיר Design Tokens ב-CSS כדי שמחוללי AI לא יהרסו את הממשק

מחוללי קוד כמו Cursor ו-v0 נוטים להמציא ערכי CSS אקראיים ולפרק דיזיין סיסטמס. מדריך פרקטי להגדרת CSS Design Tokens נקיים שמכוונים את ה-AI בול לתוצאה המבוקשת.

3 דקות קריאהCSS · Design Tokens · Cursor · v0 · AI Web Development

TL;DR

כלי AI כמו Cursor, v0 ו-Claude Code מעולים ביצירת קוד מהיר, אבל ללא הדרכה נכונה הם מציפים את קובצי ה-CSS בערכים מומצאים. הגדרת Design Tokens ברורים ב-CSS נקי יוצרת חומת אש המונעת מ-AI לשבור את הדיזיין סיסטם שלך.

פיתחתם רכיב חדש בעזרת Cursor או v0. הבקשה הייתה פשוטה: "בנה כפתור פעולה ראשי". אחרי 3 שניות קיבלתם קוד שעובד, אבל הצבע הוא #3b82f6 במקום כחול המותג שלכם, ה-padding הוא 17px מוזר, והפונט בכלל נלקח מ-Google Fonts ללא קשר לשאר האתר. ה-AI חסך לכם 5 דקות כתיבה, אבל גבה 20 דקות של ניקוי אשפה ניהולית.

ה-AI אוהב לנחש. כשאין לו גבולות קשיחים, הוא ממלא את החלל בהסתברויות סטטיסטיות מתוך המידע שעליו הוא התאמן.

למה מחוללי AI מפרקים דיזיין סיסטמס?

מודלי שפה חושבים בטקסט, לא בפיקסלים. כשאנחנו מבקשים מהם לעצב ממשק, הם לא "רואים" את האתר שלכם אלא מנחשים איזה מזהה CSS סביר להופיע ליד המילה Button.

80%

ירידה בהזיות העיצוב של מחוללי AI בעת עבודה עם קובץ Design Tokens מוגדר

מקור: Adir Ben Yaakov, 2026

אם הפרויקט כולל ערכים צפים כמו margin: 12px או צבעים מפורשים כגון rgb(15, 23, 42) המפוזרים בקוד, ה-AI מסיק שאין חוקים. התוצאה היא אנרכיה וויזואלית: 14 גוונים שונים של אפור ואוסף שוליים מקרי.

הארכיטקטורה של Design Tokens עבור AI

הגדרה · Design Tokens

ערכים מופשטים (כמו צבעים, מרווחים ופונטים) המיוצגים כמשתנים קבועים. הם מהווים את המקור הבודד לאמת (Single Source of Truth) במערכת העיצוב.

כדי שמודל AI יבין את החוקים, המבנה חייב להיות היררכי. אל תציפו את ה-AI במאות משתנים שטוחים. חלצו את המשתנים לשלוש רמות קלאסיות:

רמהתפקידדוגמה
Primitivesערכים גולמיים של המותג--color-blue-500: #0055ff;
Semanticsמשמעות פונקציונלית--color-action-primary: var(--color-blue-500);
Componentמשתנה ספציפי לרכיב--button-bg: var(--color-action-primary);

היררכיה כזו גורמת לכלי AI להשתמש בשכבה הסמנטית בלבד. המודל מבין מיד מהו הצבע של כפתור ראשי, מבלי להמר על ערכי Hex מקריים.

תבנית מעשית: CSS Variables נקיים

הנה הדרך היעילה ביותר להגדיר משתנים ב-CSS נקי כך שפורסרי קוד ו-AI יזהו אותם באופן מיידי:

:root {
  /* Primitives */
  --brand-blue: #0f62fe;
  --gray-100: #f4f4f4;
  --gray-900: #161616;

  /* Semantics */
  --bg-surface: var(--gray-100);
  --text-main: var(--gray-900);
  --interactive-primary: var(--brand-blue);

  /* Spacing Scale */
  --space-xs: 0.25rem;
  --space-sm: 0.5rem;
  --space-md: 1rem;
  --space-lg: 2rem;
}

משתנים אלה קצרים ואינטואיטיביים. ה-AI לא צריך לנחש מה מטרת --space-md. המשמעות שקופה לחלוטין.

מומלץ להוסיף קובץ SYSTEM_PROMPT.md או קובץ .cursorrules בורש הפרויקט, ולהנחות את ה-AI להשתמש אך ורק במשתנים המוגדרים ב-:root.

איך להנחות את Cursor ו-v0 לעבוד עם ה-Tokens

טכנולוגיה בלי הנחיה לא תעבוד מעצמה. כדי למנוע זליגת סגנונות, הוסיפו את ההנחיה הבאה לקובץ ההגדרות של ה-AI בפרויקט:

"אתה מעצב UI קפדני. חל איסור מוחלט להשתמש בערכי Hex, RGB או פיקסלים קשיחים בקוד. השתמש אך ורק במשתני CSS המוגדרים ב-:root עבור צבעים, מרווחים וגופנים."

💡

Design Tokens אינם רק כלי לצוותי עיצוב — הם השפה הסמנטית שבאמצעותה מודלי AI מבינים את גבולות הגזרה של האתר שלך.

התוצאה מיידית: ה-AI מפסיק להזות ערכים ומייצר קוד שמסתנכרן בדיוק מלא עם מותג החברה.

שאלות נפוצות

כל מה שעוד רצית לדעת

מה זה Design Tokens ואיך זה שונה מסתם CSS Variables?
Design Tokens הם תפיסה ארכיטקטונית המגדירה ערכי עיצוב כמשתנים מופשטים (כמו צבעים, טיפוגרפיה ומרווחים). CSS Variables הם המנגנון הטכני שבאמצעותו אנו מממשים את ה-Tokens בדפדפן.
איך כלי AI כמו Cursor ו-v0 מזהים את ה-Tokens שלי?
כלי AI סורקים את קובצי ה-CSS בפרויקט. כשאנחנו מנגישים קובץ tokens מובנה בשמות סמנטיים ברורים, המודל משתמש בהם כהקשר (Context) ומעדיף אותם על פני המצאת ערכים אקראיים.
האם כדאי להשתמש ב-Tailwind או ב-CSS נקי עבור עבודה עם AI?
שתי השיטות עובדות מעולה. ב-Tailwind v4 השתמשו בדירקטביות theme ב-CSS, וב-CSS נקי השתמשו ב-CSS Variables בתוך root. העיקר הוא להפנות את ה-AI לקובץ ההגדרות המרכזי.
AB

כתב

אדיר בן יעקב · Adir Ben Yaakov

מקים JustBetterSite, סוכנות בניית אתרים ושיווק דיגיטלי בתל אביב. מתמחה ב-GEO (Generative Engine Optimization) — בנייה של אתרים שמופיעים בתשובות של ChatGPT, Claude, Perplexity ו-Gemini, לא רק בגוגל.

עוד עליי →

להמשך הקריאה

מאמרים קשורים