(FOSS) Een pull request is een inzending
Een thema is één JSON-bestand. Een plug-in is één JavaScript-bestand. Maak het, probeer het in de app en voeg het dan toe aan de Winkel: één map in één pull request, of het bestand in een issue als je geen git gebruikt. Voor beide heb je een gratis account op git.crt.fyi nodig, en verder niets.
Begin met een werkend bestand. De scaffolder schrijft er een; het onderdeel Maken in de app zelf (wayBetter → Maken) heeft voorbeelden en de actuele themawaarden.
Kleuren, lettertypen, hoeken, dichtheid, indeling, achtergrond, effecten. Drie kleuren zijn genoeg; de rest wordt afgeleid en tekst blijft leesbaar.
Of bouw het in de app: Weergave → Themabouwer → Exporteren. THEMES.md somt alles op wat een thema kan instellen.
Een klasse met start() en stop(), en een header die zegt wie het heeft gemaakt en wat het gebruikt.
Voeg --ts toe voor een TypeScript-project. PLUGINS.md beschrijft de API, de machtigingen en live herladen.
De repository op 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'); }
};De Winkel leest de naam, auteur, versie, beschrijving en machtigingen van een plug-in uit deze header, en de naam, auteur en beschrijving van een thema uit zijn JSON. Het installatiescherm toont dezelfde waarden, dus die twee kunnen nooit van elkaar afwijken.
De Winkel is optioneel. Een bestand dat werkt, is al te delen.
custom.css wordt in alle tabbladen tegelijk herladen.waybetter://install-link naar een https-URL op waybetter.fyi, cdn1.crt.fyi of een raw-bestand op git.crt.fyi. Het wordt nooit geïnstalleerd zonder het installatiescherm.Elk item in de Winkel is een map onder store/<app>/ in de repository. De mapnaam is het id van het item en zijn adres 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 of tools. Thema’s: dark of light, overgenomen uit de mode van het thema als je het weglaat.tagsversionDat is de hele inzending. De pagina, de kaart, het zoekresultaat, het linkvoorbeeld, de gestructureerde gegevens en de sitemapvermelding worden gegenereerd uit de ondertekende catalogus wanneer de site wordt gebouwd. store/README.md bevat alle regels.
Er is geen gehoste CI. De controles zijn opdrachten die je uitvoert voordat je verstuurt, en die een beheerder nog eens uitvoert vóór de merge.
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 -, maximaal 40), name.plugin.js, geen dubbelen binnen een app@name, @version, een beschrijving en een @permissions-regel die network of network:none noemtnetwork:none wordt geweigerd wanneer de code fetch, XMLHttpRequest, WebSocket, EventSource of sendBeacon aanroept; aanroepen van de afgeschermde API moeten worden opgegeveneval, new Function of import(); geen scripts of externe bestanden in een voorbeeld; geen @import of externe URL’s in de CSS van een themaTwee manieren om bij te dragen. Voor allebei heb je een gratis git.crt.fyi-account nodig: iedereen kan zich aanmelden, en een beheerder keurt elk nieuw account met de hand goed.
De ondertekeningssleutel van de Winkel is bewust offline, dus mergen is nog geen publiceren. Na de merge leest een beheerder de code, voert waybetter store build en waybetter store sign uit op de computer waar de sleutel staat, en pusht. De site wordt opnieuw gebouwd, je item krijgt zijn pagina, en elke app ziet het de volgende keer dat hij de ondertekende catalogus leest.
Voor alles in de ondertekende catalogus staat die sleutel in; daarom leest een mens elke plug-in voordat hij wordt ondertekend.
Eén bestand voor elke wayBetter-app. Je bewerkt het nooit met de hand: het wordt uit de mappen gebouwd.
{ "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. Een app verifieert het hele bestand en houdt alleen zijn eigen items.Geen items in de Winkel: alle 51 talen zijn in de app ingebouwd en worden geladen wanneer dat nodig is.
apps/desktop/locales/<tag>.json, via een pull request of via een issue met het gewijzigde bestand als bijlage.bun run i18n:check: sleutels, plaatshouders, meervoudsvormen, geen opmaak. De uitvoer moet 0 error(s) zijn.