(FOSS) Una pull request è una candidatura
Un tema è un file JSON. Un plugin è un file JavaScript. Crealo, provalo nell’app, poi aggiungilo allo Store: una cartella in una pull request, oppure il file in una issue se non usi git. Entrambe le strade richiedono un account git.crt.fyi gratuito, e nient’altro.
Parti da un file che funziona. Lo scaffolder ne scrive uno; la sezione Crea dell’app (wayBetter → Crea) ha esempi e i valori del tema in tempo reale.
Colori, font, angoli, densità, layout, sfondo, effetti. Tre colori bastano; il resto viene derivato e il testo resta leggibile.
Oppure costruiscilo nell’app: Aspetto → Creatore di temi → Esporta. THEMES.md elenca tutto ciò che un tema può impostare.
Una classe con start() e stop(), e un’intestazione che dice chi l’ha fatto e cosa usa.
Aggiungi --ts per un progetto TypeScript. PLUGINS.md contiene l’API, i permessi e il ricaricamento in tempo reale.
Il repository su 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'); }
};Lo Store legge nome, autore, versione, descrizione e permessi di un plugin da questa intestazione, e nome, autore e descrizione di un tema dal suo JSON. La schermata di installazione mostra gli stessi valori, così i due non possono mai divergere.
Lo Store è facoltativo. Un file che funziona è già condivisibile.
custom.css appena salvato si ricarica in tutte le schede contemporaneamente.waybetter://install a un URL https su waybetter.fyi, cdn1.crt.fyi o a un file raw su git.crt.fyi. Non viene mai installato senza la schermata di installazione.Ogni elemento dello Store è una cartella sotto store/<app>/ nel repository. Il nome della cartella è l’id dell’elemento e il suo indirizzo qui: /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 o tools. Temi: dark o light, ricavato dal mode del tema quando lo ometti.tagsversionLa candidatura è tutta qui. La pagina, la scheda, la voce di ricerca, l’anteprima del link, i dati strutturati e la voce nella sitemap vengono generati dal catalogo firmato quando il sito viene compilato. store/README.md contiene tutte le regole.
Non c’è una CI ospitata. I controlli sono comandi che esegui prima di inviare, e che un maintainer esegue di nuovo prima del 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 -, fino a 40), name.plugin.js, nessun duplicato in un’app@name, @version, una descrizione e una riga @permissions che indica network o network:nonenetwork:none viene rifiutato quando il codice chiama fetch, XMLHttpRequest, WebSocket, EventSource o sendBeacon; le chiamate alle API protette vanno dichiarateeval, new Function o import(); niente script o file esterni in un’anteprima; niente @import o URL esterni nel CSS di un temaDue modi per entrare. Entrambi richiedono un account git.crt.fyi gratuito: chiunque può registrarsi, e un maintainer approva a mano ogni nuovo account.
La chiave di firma dello Store è offline per scelta, quindi fare il merge non significa pubblicare. Dopo il merge un maintainer legge il codice, esegue waybetter store build e waybetter store sign sul computer che custodisce la chiave, e fa il push. Il sito viene ricompilato, il tuo elemento ottiene la sua pagina, e ogni app lo vede alla successiva lettura del catalogo firmato.
Tutto ciò che sta nel catalogo firmato è garantito da quella chiave, ed è per questo che una persona legge ogni plugin prima che venga firmato.
Un solo file per tutte le app wayBetter. Non lo modifichi mai a mano: viene generato dalle cartelle.
{ "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. Un’app verifica l’intero file e tiene solo i propri elementi.Non sono elementi dello Store: tutte le 51 lingue sono integrate nell’app e caricate su richiesta.
apps/desktop/locales/<tag>.json, con una pull request o con una issue a cui alleghi il file modificato.bun run i18n:check: chiavi, segnaposto, forme plurali, nessun markup. Deve stampare 0 error(s).