Cargando

Cargando...

Перейти к содержимому
CubicLauncherDocs

Как создать тему

Пошаговое руководство по созданию темы CubicLauncher с нуля — палитра, фон, типографика, иконки, собственный CSS, упаковка и публикация.

Тема меняет весь внешний вид CubicLauncher: цвета, типографику, фон, иконки и детали интерфейса. Ничего не нужно компилировать или трогать код лаунчера: тема — это два текстовых файла и, при желании, несколько изображений и шрифтов.

Это руководство собирает настоящую тему от начала до конца, короткими шагами, с контрольной точкой после каждого. В итоге у вас будет устанавливаемый и опубликованный ZIP.

Перед началом
  • Текстовый редактор и программа для создания ZIP-архивов.
  • Недавняя версия CubicLauncher.
  • Десять минут на первую рабочую тему.

Если вы хотите просто установить тему, сделанную другим автором, смотрите Как установить тему.

Как устроена темаредактировать

Лаунчер читает файлы темы, превращает их в CSS-переменные и применяет к интерфейсу. Поэтому почти всё настраивается объявлением значений, без написания селекторов:

text
Meta.toml        → идентичность: имя, автор, версия, наследование
Definition.toml  → внешний вид: цвета, фон, шрифты, иконки
Inject.css       → детали, которых не хватает переменным (необязательно)
Layout.css       → перестройка каркаса (необязательно)

Каждый ключ в Definition.toml создаёт переменную с фиксированным префиксом. Например, accent = "#8FBF6A" в [colors] превращается в --accent, а primary = "#E6EFDC" в [text] — в --text-primary.

Существует две версии формата. В этом руководстве используется V2, текущая. V1 (theme.json) по-прежнему загружается для совместимости, но не поддерживает иконки, наследование и собственный CSS.

Шаг 1 — Создайте папку и манифестредактировать

Создайте папку для темы, например bosque, и внутри неё файл Meta.toml:

toml
name = "Bosque"
author = "your_username"
version = "0.1.0"
description = "Тёмная тема с зелёным акцентом и лесным фоном."
format = 2
api_version = "2.1"

С этими полями у вас уже есть корректная тема. format должен быть ровно 2, а api_version объявляет серию API, под которую написана тема: сейчас "2.1".

Затем добавьте Definition.toml с одной пустой секцией:

toml
[colors]

Сожмите папку в ZIP и перетащите его в окно лаунчера.

Контрольная точка: тема появляется в списке как Bosque, и при её активации интерфейс выглядит как прежде. Это правильно: вы ещё не изменили ни одного значения.

Имя и идентификатор

Лаунчер создаёт внутренний идентификатор из name и author: "Bosque" + "your_username" сохраняется как bosque_your_username в ~/.cubic/themes/. Именно этот идентификатор используется для наследования от другой темы.

Шаг 2 — Определите палитруредактировать

Тема держится на пяти цветах: фон, поверхность, текст, акцент и граница. Выберите их до того, как что-либо писать, — так остальное получится согласованным.

Добавьте эти две секции в Definition.toml:

toml
[colors]
accent = "#8FBF6A"
accent-rgb = "143, 191, 106"
accent-hover = "#A5D182"
accent-text = "#0B120A"
bg-main = "#0B0F0B"
bg-sidebar = "#0F150F"
bg-card = "#131A13"
bg-input = "#080C08"
bg-item-active = "#1B261B"
bg-overlay = "rgba(5, 8, 5, 0.72)"
border-color = "rgba(143, 191, 106, 0.18)"

[text]
primary = "#E6EFDC"
secondary = "#AEBBA2"
muted = "#74806B"

Что делает каждый из них:

КлючЭффект
bg-mainФон окна.
bg-sidebarФон боковой панели, на ступень светлее фона.
bg-cardКарточки, модальные окна и панели.
bg-inputТекстовые поля, на ступень темнее.
accentКнопки, фокус, ссылки и активные элементы.
accent-textТекст, который находится поверх акцента.
border-colorГраницы и разделители.

Контрольная точка: лаунчер меняется сразу. Если какой-то цвет не применяется, проверьте, что ключ находится в правильной секции, и загляните в консоль: повторяющиеся имена вызывают предупреждение о конфликте.

Два триплета, о которых забывают

accent-rgb должен быть тем же цветом, что и accent, записанным как R, G, B без rgb(). Интерфейс использует его в rgba(var(--accent-rgb), 0.15) для свечений и границ. Если о нём забыть, эти детали сохранят исходный белый.

surface-rgb работает так же, но для полупрозрачных поверхностей. В тёмной теме он равен 255, 255, 255 (по умолчанию); в светлой теме он должен быть 0, 0, 0, иначе границы станут светлее, а не темнее.

Шаг 3 — Настройте границы, тени и размерыредактировать

Когда палитра готова, определите формы. Эти секции необязательны, но именно они делают тему законченной, а не просто перекрашенной:

toml
[borders]
radius = "10px"
radius-sm = "6px"
radius-lg = "18px"

[shadows]
shadow-sm = "0 2px 8px rgba(0, 0, 0, 0.28)"
shadow-md = "0 10px 28px rgba(0, 0, 0, 0.36)"
shadow-lg = "0 18px 52px rgba(0, 0, 0, 0.50)"

[layout]
sidebar-width = "248px"

[spacing]
md = "12px"
lg = "16px"

[borders] добавляет префикс --border-, [spacing] добавляет --space-, а [layout] не добавляет ничего: ключ — это полная переменная.

Контрольная точка: углы меняют радиус, карточки приобретают глубину, а боковая панель становится шире или уже.

Шаг 4 — Добавьте фоновое изображениередактировать

Фон придаёт больше всего индивидуальности. Положите изображение в папку темы и укажите его относительным путём:

toml
[background]
reference_path = "bg.webp"
image_blur = 12.0
image_opacity = 0.32
mode = "cover"
position = "center"
brightness = 0.45
КлючЧто контролируетПолезный диапазон
reference_pathПуть к изображению относительно темы.—
image_blurРазмытие в пикселях.0–24
image_opacityПрозрачность слоя.0.2–0.6
modeКадрирование: cover, contain.—
positioncenter, top, bottom left…—
brightnessЯркость изображения.0.3–0.7

Чем ниже brightness и выше непрозрачность, тем лучше читается текст, но тем меньше видно изображение. Оптимальная точка обычно находится в диапазоне brightness от 0.35 до 0.5 и image_opacity около 0.35.

Контрольная точка: изображение видно за содержимым, размытое и затемнённое, не мешая чтению.

Ограничения фона

Изображение не может превышать 25 МБ и должно быть настоящим файлом изображения. Лаунчер проверяет заголовок файла, а не расширение: .png, который на самом деле является текстом, будет отклонён.

Используйте относительные пути. Абсолютные пути и file: работают на вашей машине, но ломают тему на любой другой.

Шаг 5 — Собственная типографикаредактировать

Вы можете использовать любой шрифт, который находится внутри пакета. Скопируйте файлы в fonts/ и объявите каждый вариант:

toml
[[fonts]]
family = "Inter"
src = "fonts/Inter-Regular.woff2"
weight = "400"
style = "normal"

[[fonts]]
family = "Inter"
src = "fonts/Inter-SemiBold.woff2"
weight = "600"
style = "normal"

[typography]
family = "Inter, system-ui, sans-serif"
size_base = "14px"
line_height = "1.5"

Важное правило: [typography].family должен упоминать то же семейство, которое объявлено в [[fonts]]. Если имя не совпадает, шрифт загружается, но интерфейс продолжает использовать типографику по умолчанию.

Контрольная точка: заголовки и текст меняют вид. Если ничего не изменилось, проверьте имя семейства и наличие пути src внутри ZIP.

Сколько шрифтов

Достаточно одного или двух семейств. Свыше 12 список показывает предупреждение, а лаунчер загружает только первые 20 вариантов.

Шаг 6 — Иконкиредактировать

Иконки объявляются по группам. Итоговый ключ — группа:имя, и он должен точно совпадать с именем, которое запрашивает компонент.

toml
[icons]
preview = "icons/preview.png"

[icons.nav]
settings = "icons/nav/settings.svg"
create = "icons/nav/create.svg"

[icons.ui]
play = "icons/ui/play.svg"

preview — изображение, представляющее вашу тему в списке; лучше, чтобы это был снимок лаунчера с применённой темой.

SVG используются как маска: они окрашиваются в цвет текста, поэтому монохромная иконка работает и в светлых, и в тёмных темах. PNG, WEBP и JPG отрисовываются своими собственными цветами.

Контрольная точка: иконки боковой панели меняются. Если какая-то иконка не меняется, ключ не совпадает с реальным именем: полный список находится в Справочнике по токенам.

Шаг 7 — Тонкие детали с помощью CSSредактировать

Переменные покрывают почти всё, но есть вещи, которые решаются только через CSS: псевдоэлементы, анимации, разделители. Для этого существует Inject.css.

Объявите секцию в Definition.toml и создайте файл:

toml
[inject]
path = "Inject.css"
enabled = true
layer = "theme"
css
/* Inject.css */
[data-part="sidebar"] {
  border-right: 1px solid var(--border-color);
}

[data-part="sidebar"] .sidebar-header {
  letter-spacing: 0.04em;
  text-transform: uppercase;
}

Ключевой момент — layer:

  • theme (по умолчанию) оборачивает ваш CSS в @layer cubic.theme. Он побеждает глобальные стили лаунчера, но проигрывает стилям каждого компонента.
  • unlayered оставляет CSS без слоя. Он соревнуется по специфичности со всем, включая компоненты. Это мощнее и хрупче.

Контрольная точка: изменение применяется без перезапуска. Если эффекта нет, попробуйте layer = "unlayered", прежде чем считать, что селектор неверен.

CSS и обновления

Избегайте зависимости от классов, сгенерированных Svelte (тех, что заканчиваются хешем), и от внутренних структур. Атрибуты data-part стабильны; остальное может меняться между версиями.

Шаг 8 — Упаковка, установка и проверкаредактировать

  1. В папке должны быть Meta.toml и Definition.toml в корне вместе с ресурсами.
  2. Сожмите её в ZIP. Файлы могут лежать в корне ZIP или внутри одной папки-контейнера.
  3. Измените расширение на .cbth, если хотите использовать формат пакета тем: это тот же ZIP под другим именем.
  4. Установите его, перетащив в окно лаунчера или через Настройки → Темы → Импорт темы.
  5. Выберите его в списке.

Как лаунчер обрабатывает пакет:

  • Ищет Meta.toml в корне или в папке-контейнере. Если находит больше одного, отклоняет ZIP.
  • Если присутствуют и Meta.toml, и theme.json, побеждает V2.
  • .zip сначала проверяется как V1, затем как V2; .cbth интерпретируется только как V2.
  • Установка атомарна: архив распаковывается во временную папку и перемещается в место назначения. Если проверка не прошла, ничего не остаётся в полусобранном виде.
  • Место назначения — ~/.cubic/themes/<id>/. Повторный импорт темы с тем же именем и автором заменяет предыдущую версию.

Проверка изменений без повторного импортаредактировать

Пока тема активна, лаунчер следит за её папкой и перезагружает её сам. Редактируйте файлы в ~/.cubic/themes/<id>/ и смотрите результат в реальном времени: это гораздо быстрее, чем сжимать и заново импортировать при каждой правке.

Панель диагностики в списке тем сообщает о трёх вещах, которые не блокируют загрузку, но влияют на производительность: более 12 шрифтов, CSS больше 256 КиБ и фон больше 4096×4096 пикселей.

Шаг 9 — Публикация в каталогередактировать

Пользовательские темы живут в CubicLauncherDevs/Themes и появляются на cubiclauncher.org/themes.

text
src/
└── TuAutor/
    └── TuTema/
        ├── theme.md          # описание темы
        ├── vflag.txt         # необязательно, только staff: помечает тему как проверенную
        └── V1/
            ├── Meta.toml
            ├── Definition.toml
            ├── bg.webp
            ├── Showcase.png  # необязательно, снимок для каталога
            └── fonts/
  1. Сделайте форк репозитория.
  2. Создайте src/TuAutor/TuTema/theme.md с кратким описанием.
  3. Создайте src/TuAutor/TuTema/V1/ с Meta.toml, Definition.toml и ресурсами.
  4. Откройте Pull Request.

Непрерывная интеграция оптимизирует изображения, генерирует предпросмотр, загружает двоичные файлы в хранилище каталога и обновляет themes.json. Двоичные файлы не хранятся в Git.

Оптимизация темыредактировать

Тема читается при каждой активации: лаунчер разбирает оба манифеста, проверяет фон, открывая файл, просматривает каждую иконку, разрешает каждый шрифт и загружает CSS в память. Затем фронтенд декодирует изображение и регистрирует типографику, прежде чем показать интерфейс полностью. Тяжёлая тема выглядит не лучше: она просто появляется дольше.

Вот решения с наибольшим влиянием, от большего к меньшему.

Фон: самое большое изображение и то, что меньше всего нуждается в деталяхредактировать

Изображение отрисовывается размытым и с низкой непрозрачностью, поэтому разрешение почти не заметно. Фон 1600×900 выглядит так же, как 4K после размытия, но весит в восемь раз меньше и декодируется мгновенно.

ПрактикаПочему
Экспортируйте в WebP с качеством 75–85.Тот же вид, что у PNG, за долю веса.
Снизьте разрешение до 1600×900 или 1920×1080.Размытие скрывает недостаток деталей.
Стремитесь к размеру менее 500 КБ.Предел — 25 МБ, но реальная цель другая.
Размывайте изображение в редакторе и используйте низкий image_blur.Размытие в реальном времени пересчитывается по всему окну.
Избегайте размеров больше 4096×4096.Список предупреждает о расходе памяти при декодировании.

Высокий image_blur поверх большого изображения — самая дорогая комбинация: размытие оплачивается при каждой перерисовке. Если изображение уже размыто, image_blur = 0 даёт тот же результат без затрат.

Шрифты: только то, что используетсяредактировать

Каждый объявленный файл скачивается, регистрируется и применяется. Семейство с четырьмя начертаниями добавляет четыре файла.

  • Используйте WOFF2. Это самый маленький формат и с наилучшей поддержкой.
  • Объявляйте только те начертания, которые теме действительно нужны: обычно 400 и 600.
  • Предпочитайте шрифты с латинским подмножеством; шрифт с кириллицей, греческим и CJK может весить в десять раз больше.
  • Два семейства — разумный максимум. Одного хорошо выбранного достаточно почти для всего.

Иконки: SVG и только те, что меняютсяредактировать

SVG весят несколько КБ и окрашиваются сами. Растровые (PNG, WEBP, JPG) загружаются со своими цветами и обычно весят гораздо больше.

  • Заменяйте только иконки, которые придают индивидуальность. Каждая запись проверяется при загрузке темы, даже если она никогда не показывается.
  • Не включайте иконку, если исходная вас устраивает.
  • Если используете растровые изображения, держите их меньше 64×64 и 50 КБ: предел — 2 МБ, но иконка на 2 МБ появляется долго.

CSS: сначала переменные, потом селекторыредактировать

Inject.css загружается и интерпретируется при каждой активации. Всё, что решается переменной, должно решаться переменной.

  • Если цвет, радиус или тень можно изменить из Definition.toml, не пишите CSS.
  • Держите Inject.css меньше 16 КБ; рекомендуемый предел — 256 КиБ.
  • Не анимируйте filter, backdrop-filter и box-shadow: это самые дорогие для перерисовки свойства.
  • Избегайте !important. Если он нужен, селектор выбран неправильно.
  • Не дублируйте в CSS то, что уже делает Layout.css.

Токены: не повторяйте значения по умолчаниюредактировать

Каждая объявленная переменная вставляется в таблицу стилей. Повторение значения по умолчанию ничего не меняет и затрудняет чтение темы.

  • Объявляйте только те токены, которые отличаются от лаунчера.
  • Если два ключа создают одну и ту же переменную, оставьте один: другой вызовет предупреждение о конфликте.
  • Для вариантов цвета используйте extends вместо копирования всей палитры.
  • Объявите --color-scheme ("dark" или "light") в [others], чтобы полосы прокрутки и нативные элементы управления соответствовали теме.

Целевые размерыредактировать

РесурсЦельТехнический предел
Полный ZIPменее 3 МБ—
Фоновое изображениеменее 500 КБ25 МБ
Шрифтыменее 300 КБ суммарно12 рекомендуемых, 20 загружаемых
Иконкименее 20, SVG100 предзагруженных
Inject.cssменее 16 КБ256 КиБ рекомендуемый
Объявленные токеныот 25 до 40 ключей—

Как измерятьредактировать

  • Смотрите на размер ZIP перед публикацией: это число видит тот, кто его скачивает.
  • Панель диагностики в списке тем сообщает, если фон слишком большой, шрифтов слишком много или CSS превышает размер.
  • Если тема долго появляется при переключении между темами, проблема почти всегда в фоновом изображении или количестве шрифтов.

Полный примерредактировать

Готовые к копированию Meta.toml и Definition.toml со всем из предыдущих шагов. Ресурсы (bg.webp, fonts/, icons/, Inject.css) необязательны: если их нет, лаунчер игнорирует их и продолжает с остальной частью темы.

toml
# Meta.toml
name = "Bosque"
author = "your_username"
version = "1.0.0"
description = "Тёмная тема с зелёным акцентом и лесным фоном."
format = 2
api_version = "2.1"
toml
# Definition.toml
[colors]
accent = "#8FBF6A"
accent-rgb = "143, 191, 106"
accent-hover = "#A5D182"
accent-text = "#0B120A"
bg-main = "#0B0F0B"
bg-sidebar = "#0F150F"
bg-card = "#131A13"
bg-input = "#080C08"
bg-item-active = "#1B261B"
bg-overlay = "rgba(5, 8, 5, 0.72)"
border-color = "rgba(143, 191, 106, 0.18)"

[text]
primary = "#E6EFDC"
secondary = "#AEBBA2"
muted = "#74806B"

[borders]
radius = "10px"
radius-sm = "6px"
radius-lg = "18px"

[shadows]
shadow-sm = "0 2px 8px rgba(0, 0, 0, 0.28)"
shadow-md = "0 10px 28px rgba(0, 0, 0, 0.36)"
shadow-lg = "0 18px 52px rgba(0, 0, 0, 0.50)"

[layout]
sidebar-width = "248px"

[background]
reference_path = "bg.webp"
image_blur = 12.0
image_opacity = 0.32
mode = "cover"
position = "center"
brightness = 0.45

[[fonts]]
family = "Inter"
src = "fonts/Inter-Regular.woff2"
weight = "400"
style = "normal"

[[fonts]]
family = "Inter"
src = "fonts/Inter-SemiBold.woff2"
weight = "600"
style = "normal"

[typography]
family = "Inter, system-ui, sans-serif"
size_base = "14px"
line_height = "1.5"

[icons]
preview = "icons/preview.png"

[icons.nav]
settings = "icons/nav/settings.svg"
create = "icons/nav/create.svg"

[inject]
path = "Inject.css"
enabled = true
layer = "theme"

Справочник полейредактировать

Meta.tomlредактировать

ПолеТипОбязательноОписание
namestringДаВидимое имя. Не может быть пустым.
authorstringРекомендуетсяАвтор. Показывается в нижнем регистре и входит в идентификатор.
versionstringРекомендуетсяВерсия, желательно МАЖОР.МИНОР.ПАТЧ.
descriptionstringНеобязательноОписание в одну строку для каталога.
formatцелое числоДаДолжно быть ровно 2.
api_versionstringНеобязательноСерия API: "2.1". Допустимо любое значение 2.x; другое значение вызывает предупреждение.
injects_cssлогическоеНеобязательноЕсли false, Inject.css не загружается.
extendsstringНеобязательноИдентификатор установленной темы V2, от которой наследовать.

Идентификатор вычисляется при импорте: нижний регистр, пробелы заменяются на _, формат имя_автор. Максимум 64 символа, без :, / и обратной косой черты.

Как ключи превращаются в переменныередактировать

СекцияСоздаваемая переменнаяПример ключаРезультат
[colors]--{ключ}accent = "#8FBF6A"--accent
[text]--text-{ключ}primary = "#E6EFDC"--text-primary
[borders]--border-{ключ}radius = "10px"--border-radius
[layout]--{ключ}sidebar-width = "248px"--sidebar-width
[shadows]--{ключ}shadow-md = "0 10px 28px #0006"--shadow-md
[backgrounds]--bg-{ключ}input = "#080C08"--bg-input
[backdrop]--backdrop-blur-{ключ}modal = 8.0--backdrop-blur-modal: 8px
[others]--{ключ}icon-filter = "invert(1)"--icon-filter
[typography]фиксированная таблицаsize_base = "14px"--font-size-base
[spacing]--space-{ключ}lg = "16px"--space-lg
[motion]--transition-{ключ}fast = "0.15s"--transition-fast
[components.nombre]--component-nombre-{ключ}—Зарезервировано
[tokens]буквально"--bg-image-blur" = "12px"--bg-image-blur

Правила приоритета:

  • Секции применяются в порядке таблицы, а [tokens] идёт последним, поэтому всегда побеждает.
  • Если два ключа создают одну и ту же переменную, побеждает последний, и выдаётся предупреждение Key collision. [colors] bg-main и [backgrounds] main — это одна и та же переменная.
  • [tokens] — это путь для переменных без собственной секции, таких как --bg-image-blur или --font-family-mono. Ключ должен начинаться с --.
  • [components] превращается в переменные --component-*, но пока ни один компонент их не использует.

Значения копируются в CSS как есть: если CSS нужна единица измерения, включите её в значение ("12px", а не "12").

Typographyредактировать

ПолеПеременная
family--font-family
size_base--font-size-base
size_sm--font-size-sm
size_lg--font-size-lg
size_control--font-size-control
size_label--font-size-label
weight_normal--font-weight-normal
weight_medium--font-weight-medium
weight_bold--font-weight-bold
line_height--line-height

Наследование с extendsредактировать

Тема может наследовать токены другой установленной темы V2:

toml
name = "Светлый лес"
author = "your_username"
version = "1.0.0"
format = 2
extends = "bosque_your_username"
  • extends содержит установленный идентификатор, а не видимое имя. Префикс user: допускается и отбрасывается.
  • Базовая тема должна быть установлена и быть V2.
  • Максимальная глубина: 8 уровней. Цикл является ошибкой.
  • Дочерняя тема побеждает ключ за ключом: то, что она не определяет, она наследует.
НаследуетсяНе наследуется
colors, text, borders, layout, shadowsfonts
backgrounds, backdrop, others, tokensicons
spacing, motion, components[inject]
typography поле за полем[layout_pack]
[background] поле за полемbackground.reference_path

Ресурсы не наследуются, потому что пути относительны к теме, которая их объявляет.

Layout packредактировать

Layout.css загружается в конце, без слоя, и служит для перестройки каркаса через стабильные атрибуты:

toml
[layout_pack]
path = "Layout.css"
enabled = true
data-partЭлемент
appКорневой контейнер.
sidebarКонтейнер боковой панели.
sidebar-panelВнутренняя панель (обычная или компактная).
sidebar-headerЗаголовок боковой панели.
sidebar-contentСодержимое боковой панели.
sidebar-sectionsСписок секций.
contentОсновная область.
background-overlayСлой фонового изображения.
css
/* Layout.css — плавающая боковая панель */
[data-part="sidebar"] {
  margin: 8px;
  border-radius: var(--border-radius-lg);
  border: 1px solid var(--border-color);
  overflow: hidden;
}

Пределы и проверкиредактировать

РесурсПределЕсли превышен
Фоновое изображение25 МБ, корректное изображениеФон игнорируется.
Растровые иконки2 МБ, SVG/PNG/WEBP/JPGИконка игнорируется.
Количество иконок100 рекомендуемыхПредзагружаются только первые 100.
Шрифты12 рекомендуемых, 20 загружаемыхПредупреждение; остальные не загружаются.
Inject.css256 КиБ рекомендуемыхПредупреждение; всё равно загружается.
Разрешение фона4096×4096Предупреждение из-за памяти.
Глубина extends8 уровнейОшибка; тема не устанавливается.
Идентификатор64 символаОшибка; тема не устанавливается.

Частые ошибкиредактировать

Сообщение или симптомПричинаРешение
Meta.toml или theme.json не найденВ ZIP нет манифеста ни в корне, ни в папке-контейнере.Проверьте структуру ZIP.
Недопустимый Meta.tomlНекорректный TOML: незакрытые кавычки, повторяющаяся таблица.Проверьте TOML любым линтером.
format X не поддерживается; ожидался 2format отсутствует или не равен 2.Добавьте format = 2.
базовая тема 'x' не установлена или не является V2extends указывает на несуществующий идентификатор.Используйте идентификатор установленной темы V2.
Цикл наследованияA → B → A.Уберите один из extends.
Наследование слишком глубокоБольше 8 уровней.Упростите цепочку.
Цвета не меняютсяКлюч в неправильной секции или несуществующая переменная.Проверьте таблицу соответствия и консоль.
Один цвет остался прежнимВы изменили accent, но не accent-rgb.Обновите триплет.
Фон не появляетсяНеверный путь, больше 25 МБ или файл не является изображением.Используйте относительный путь и корректное изображение.
Шрифт не применяется--font-family не упоминает семейство или src не существует.Проверьте family, src и [typography].family.
Иконка не меняетсяКлюч не совпадает с группа:имя.Скопируйте точное имя из справочника.
Inject.css не действуетОтсутствует [inject] или селектор проигрывает из-за слоя.Объявите [inject] и попробуйте layer = "unlayered".

Контрольный списокредактировать

Перед тем как поделиться темой:

  • format = 2 и непустой name.
  • ZIP открывается с Meta.toml и Definition.toml в корне или в папке-контейнере.
  • accent-rgb совпадает с accent; surface-rgb соответствует светлой или тёмной теме.
  • Контраст не менее 4.5:1 между --text-primary и --bg-main.
  • Фон весит менее 25 МБ и использует относительный путь.
  • Шрифты находятся внутри пакета, с совместимой лицензией, и --font-family их упоминает.
  • Иконки используют точные ключи группа:имя.
  • Если вы используете extends, базовая тема — V2 и установлена.
  • Вы проверили обычное, компактное и развёрнутое окно.
  • Тема устанавливается с нуля на чистой копии лаунчера.

Дизайн тем с помощью ИИредактировать

Агент может написать полноценную тему, если получит точный формат, имена токенов и ограничения. Без этого он придумывает несуществующие переменные, и результат не применяется. А без бюджета веса он склонен заполнять тему ресурсами, которые ничего не добавляют.

Контракт форматаредактировать

Минимальная сводка, которую нужно дать модели:

  • Два обязательных файла: Meta.toml и Definition.toml.
  • Meta.toml: name, author, version, description, format = 2, api_version = "2.1".
  • Definition.toml: секции [colors], [text], [borders], [shadows], [layout], [backdrop], [others], [typography], [spacing], [motion], [tokens].
  • Префиксы: [colors] и [layout] без префикса; [text] → --text-, [borders] → --border-, [spacing] → --space-, [motion] → --transition-.
  • accent-rgb и surface-rgb — это триплеты R, G, B без rgb().
  • Значения включают единицу измерения, когда она нужна CSS.
  • Существуют только токены из справочника: новые имена не придумываются.
  • Минимальный контраст 4.5:1 для основного текста.

Правила оптимизацииредактировать

Тема, сгенерированная ИИ, склонна к перегрузке: объявляет все 60 переменных, хотя меняются только 20, добавляет ненужный Inject.css и предлагает фон 4K. Эти ограничения предотвращают это:

  • Минимум жизнеспособного: только ключи, которые меняют результат. Если значение совпадает с лаунчером, оно не нужно.
  • Без CSS, если не запрошено явно: всё, что решается токенами, решается токенами.
  • Пять ролей цвета: фон, поверхность, текст, акцент и граница. Больше ничего.
  • Без выдуманных ресурсов: не просите изображения или шрифты, которых у пользователя нет. Если нужен фон, укажите размеры вместо файла.
  • Бюджет веса: фон < 500 КБ, шрифты < 300 КБ, иконки < 20, Inject.css < 16 КБ.
  • Стабильный порядок: всегда одни и те же секции, в одном и том же порядке, с комментарием на секцию. Так файл просматривается с одного взгляда.

Базовый промптредактировать

text
Создай тему V2 для CubicLauncher: чистую, минималистичную и оптимизированную.
Верни два блока кода: Meta.toml и Definition.toml.

Meta.toml, в этом порядке:
name, author, version, description, format = 2, api_version = "2.1"

Definition.toml:
- Используй только эти секции: [colors], [text], [borders], [shadows], [layout],
  [typography], [tokens].
- Пиши только те ключи, которые меняют результат. Не повторяй значения
  по умолчанию и не добавляй ключи, которые не будешь использовать.
- Каждая секция сопровождается однострочным комментарием, объясняющим её назначение.
- Не создавай Inject.css, Layout.css и файлы ресурсов.

Палитра, пять ролей и ничего больше:
фон <цвет>, поверхность <цвет>, текст <цвет>, акцент <цвет>, граница <цвет>

Обязательные правила:
- accent-rgb повторяет accent как "R, G, B". surface-rgb — это "255, 255, 255"
  в тёмных темах и "0, 0, 0" в светлых.
- Минимальный контраст 4.5:1 между --text-primary и --bg-main.
- Все значения включают единицу измерения, когда она нужна CSS (px, rem, s).
- Не выдумывай переменные: используй только токены, которые есть в справочнике.
- Если объявляешь [background], используй относительный путь и консервативные
  значения: image_opacity от 0.25 до 0.4, brightness от 0.35 до 0.5, image_blur от 0 до 12.

Вне блоков добавь три строки:
1. Рекомендуемое типографическое семейство и необходимые начертания.
2. Идеальные размеры и формат для фона.
3. Что сократить, если тема получилась тяжёлой.

Как избежать шаблонных результатовредактировать

  • Выберите цвета до промпта. Модель склонна возвращать один и тот же фиолетовый на сером, если не дать ей направление.
  • Просите роли, а не отдельные значения. «Почти чёрный фон с зелёным оттенком, обесцвеченные поверхности, насыщенный лаймово-зелёный акцент» даёт лучшие результаты, чем «зелёная тема».
  • Зафиксируйте контраст как требование. Без этого ограничения вторичные тексты становятся нечитаемыми.
  • Проверяйте триплеты. Это самая частая ошибка в сгенерированных темах: accent меняется, а accent-rgb остаётся белым.
  • Итерируйте по файлу, а не по промпту. Попросите тему, установите её и настраивайте конкретные значения; это быстрее, чем переписывать инструкцию.
  • Просите бюджет, а не только палитру. «Фон 1600×900 в WebP, два начертания одного семейства, без лишнего CSS» не даст результату прийти с двенадцатью мегабайтами ресурсов.