(FOSS) Пул-реквест — это и есть заявка
Тема — это один JSON-файл. Плагин — один JavaScript-файл. Сделайте, попробуйте в приложении, а затем добавьте в Каталог: одна папка в одном пул-реквесте или файл в issue, если вы не пользуетесь git. Для обоих способов нужен бесплатный аккаунт git.crt.fyi — и больше ничего.
Начните с рабочего файла. Генератор шаблонов создаст его за вас; в разделе «Создать» самого приложения (wayBetter → «Создать») есть примеры и актуальные значения темы.
Цвета, шрифты, углы, плотность, вёрстка, фон, эффекты. Трёх цветов достаточно; остальное выводится автоматически, а текст остаётся читаемым.
Или соберите её в приложении: «Оформление» → «Конструктор тем» → «Экспорт». В THEMES.md перечислено всё, что может задавать тема.
Класс с start() и stop() и заголовок, в котором сказано, кто его сделал и что он использует.
Добавьте --ts, чтобы получить проект на TypeScript. В PLUGINS.md описаны API, разрешения и живая перезагрузка.
Репозиторий на git.crt.fyi/**
* @name Hide Trends
* @description Hides the trends box in the right column, so the timeline is the only thing moving.
* @version 1.0.0
* @author you
* @permissions network:none
*/
module.exports = class HideTrends {
start() { wayBetter.api.injectCSS('hide-trends', '[data-testid="sidebarColumn"] section { display: none }'); }
stop() { wayBetter.api.clearCSS('hide-trends'); }
};Каталог читает название, автора, версию, описание и разрешения плагина из этого заголовка, а название, автора и описание темы — из её JSON. Экран установки показывает те же значения, поэтому они никогда не расходятся.
Каталог необязателен. Рабочим файлом уже можно делиться.
custom.css сразу перезагружается во всех вкладках.waybetter://install на https-адрес на waybetter.fyi, cdn1.crt.fyi или на исходный файл на git.crt.fyi. Без экрана установки он никогда не устанавливается.Каждый элемент Каталога — это папка внутри store/<app>/ в репозитории. Имя папки — это id элемента и его адрес здесь: /store/plugins/<id>/.
store/x/plugins/hide-trends/
hide-trends.plugin.js the plugin, exactly as it installs
item.json { "category": "focus", "tags": ["trends", "sidebar"] }
preview.svg optional, 640×400 (.svg or .png); drawn for you without one
store/x/themes/midnight-mint/
theme.json the theme, as Appearance → Export writes it
item.json { "version": "1.0.0" }
preview.svg optional; drawn from the theme without onecategoryreading, writing, filters, focus или tools. Темы: dark или light — берётся из mode темы, если вы его не указали.tagsversionЭто и есть вся заявка. Страница, карточка, запись в поиске, превью ссылки, структурированные данные и запись в карте сайта создаются из подписанного каталога при сборке сайта. Полные правила — в store/README.md.
Внешнего CI нет. Проверки — это команды, которые вы запускаете перед отправкой, а мейнтейнер запускает ещё раз перед слиянием.
git submodule update --init
bun install --frozen-lockfile
bun run check:store # your folder, against the Store's rules
bun run test # everything else, including the site's SEO testa-z 0-9 -, до 40 символов), name.plugin.js, без дубликатов внутри приложения@name, @version, описание и строка @permissions, в которой указано network или network:nonenetwork:none отклоняется, если код вызывает fetch, XMLHttpRequest, WebSocket, EventSource или sendBeacon; вызовы защищённого API должны быть заявленыeval, new Function или import(); никаких скриптов и внешних файлов в превью; никаких @import и внешних URL в CSS темыДва пути. Для обоих нужен бесплатный аккаунт на git.crt.fyi: зарегистрироваться может любой, а каждый новый аккаунт вручную одобряет сопровождающий.
Ключ подписи Каталога намеренно хранится офлайн, поэтому слияние — ещё не публикация. После слияния мейнтейнер читает код, запускает waybetter store build и waybetter store sign на компьютере, где хранится ключ, и отправляет изменения. Сайт пересобирается, у вашего элемента появляется страница, и каждое приложение видит его при следующем чтении подписанного каталога.
За всё, что есть в подписанном каталоге, ручается этот ключ, и именно поэтому каждый плагин перед подписью читает человек.
Один файл для всех приложений wayBetter. Вручную его никогда не редактируют: он собирается из папок.
{ "format": 2, "name": "wayBetter Store", "generatedAt": "2026-09-30T…Z", "items": [
{ "apps": ["x"], "kind": "plugin", "id": "thread-reader", "name": "Thread Reader",
"author": "wayBetter", "version": "1.2.0", "description": "…",
"category": "reading", "tags": ["threads"],
"url": "https://waybetter.fyi/store/plugins/bt-thread-reader.plugin.js",
"file": "bt-thread-reader.plugin.js", "sha256": "<64 hex>", "size": 10961,
"preview": "https://waybetter.fyi/store/previews/plugin-thread-reader.svg",
"permissions": ["ui", "clipboard", "commands", "network:none"] }
] }apps. Приложение проверяет весь файл и оставляет только свои элементы.Это не элементы Каталога: все 51 язык встроены в приложение и загружаются по требованию.
apps/desktop/locales/<tag>.json — пул-реквестом или через issue с приложенным изменённым файлом.bun run i18n:check: ключи, заполнители, формы множественного числа, никакой разметки. Она должна вывести 0 error(s).