(FOSS) Ein Pull Request ist eine Einreichung
Ein Theme ist eine JSON-Datei. Ein Plugin ist eine JavaScript-Datei. Bau es, probier es in der App aus und füg es dann dem Store hinzu: ein Ordner in einem Pull Request, oder die Datei in einem Issue, wenn du kein git nutzt. Beides braucht ein kostenloses Konto auf git.crt.fyi, sonst nichts.
Starte mit einer funktionierenden Datei. Das Gerüst-Werkzeug schreibt dir eine; der Bereich Erstellen in der App selbst (wayBetter → Erstellen) hat Beispiele und die aktuellen Theme-Werte.
Farben, Schriften, Ecken, Dichte, Layout, Hintergrund, Effekte. Drei Farben genügen; der Rest wird abgeleitet, und Text bleibt lesbar.
Oder bau es in der App: Darstellung → Theme-Builder → Exportieren. THEMES.md listet alles auf, was ein Theme festlegen kann.
Eine Klasse mit start() und stop() und ein Header, der sagt, wer es gemacht hat und was es nutzt.
Füg --ts für ein TypeScript-Projekt hinzu. PLUGINS.md beschreibt die API, die Berechtigungen und das Live-Neuladen.
Das Repository auf 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'); }
};Der Store liest Name, Autor, Version, Beschreibung und Berechtigungen eines Plugins aus diesem Header und Name, Autor und Beschreibung eines Themes aus dessen JSON. Der Installationsbildschirm zeigt dieselben Werte, die beiden können also nie voneinander abweichen.
Der Store ist optional. Eine Datei, die funktioniert, lässt sich schon teilen.
custom.css lädt in allen Tabs gleichzeitig neu.waybetter://install-Link auf eine https-URL bei waybetter.fyi, cdn1.crt.fyi oder eine Rohdatei auf git.crt.fyi. Ohne den Installationsbildschirm wird es nie installiert.Jeder Store-Eintrag ist ein Ordner unter store/<app>/ im Repository. Der Ordnername ist die Id des Eintrags und seine Adresse hier: /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 oder tools. Themes: dark oder light, aus dem mode des Themes übernommen, wenn du es weglässt.tagsversionDas ist die ganze Einreichung. Seite, Karte, Sucheintrag, Link-Vorschau, strukturierte Daten und Sitemap-Eintrag entstehen beim Bauen der Website aus dem signierten Katalog. store/README.md enthält alle Regeln.
Es gibt kein gehostetes CI. Die Prüfungen sind Befehle, die du vor dem Senden ausführst und die ein Maintainer vor dem Merge noch einmal ausführt.
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 -, bis zu 40), name.plugin.js, keine Duplikate innerhalb einer App@name, @version, eine Beschreibung und eine @permissions-Zeile, die network oder network:none nenntnetwork:none wird abgelehnt, wenn der Code fetch, XMLHttpRequest, WebSocket, EventSource oder sendBeacon aufruft; Aufrufe der geschützten API müssen angegeben seineval, new Function oder import(); keine Skripte oder fremden Dateien in einer Vorschau; kein @import und keine fremden URLs im CSS eines ThemesZwei Wege hinein. Beide brauchen ein kostenloses git.crt.fyi-Konto: Jeder kann sich registrieren, und ein Maintainer gibt jedes neue Konto von Hand frei.
Der Signaturschlüssel des Stores ist absichtlich offline, ein Merge ist also noch keine Veröffentlichung. Nach dem Merge liest ein Maintainer den Code, führt waybetter store build und waybetter store sign auf dem Rechner mit dem Schlüssel aus und pusht. Die Website wird neu gebaut, dein Eintrag bekommt seine Seite, und jede App sieht ihn, sobald sie den signierten Katalog das nächste Mal liest.
Für alles im signierten Katalog bürgt dieser Schlüssel; deshalb liest ein Mensch jedes Plugin, bevor es signiert wird.
Eine Datei für alle wayBetter-Apps. Du bearbeitest sie nie von Hand: Sie wird aus den Ordnern gebaut.
{ "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. Eine App prüft die ganze Datei und behält nur ihre eigenen Einträge.Keine Store-Einträge: Alle 51 Sprachen sind in die App eingebaut und werden bei Bedarf geladen.
apps/desktop/locales/<tag>.json, per Pull Request oder per Issue mit der geänderten Datei im Anhang.bun run i18n:check: Schlüssel, Platzhalter, Pluralformen, kein Markup. Die Ausgabe muss 0 error(s) lauten.