(FOSS) Une pull request vaut soumission
Un thème, c’est un fichier JSON. Un plugin, c’est un fichier JavaScript. Créez-le, essayez-le dans l’app, puis ajoutez-le à la Boutique : un dossier dans une pull request, ou le fichier dans un ticket si vous n’utilisez pas git. Les deux demandent un compte gratuit sur git.crt.fyi, et rien d’autre.
Partez d’un fichier qui fonctionne. Le générateur en écrit un ; la section Créer de l’app elle-même (wayBetter → Créer) propose des exemples et les valeurs du thème en direct.
Couleurs, polices, angles, densité, mise en page, arrière-plan, effets. Trois couleurs suffisent ; le reste en découle et le texte reste lisible.
Ou créez-le dans l’app : Apparence → Éditeur de thèmes → Exporter. THEMES.md liste tout ce qu’un thème peut définir.
Une classe avec start() et stop(), et un en-tête qui dit qui l’a créé et ce qu’il utilise.
Ajoutez --ts pour un projet TypeScript. PLUGINS.md décrit l’API, les autorisations et le rechargement à chaud.
Le dépôt sur 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'); }
};La Boutique lit le nom, l’auteur, la version, la description et les autorisations d’un plugin dans cet en-tête, et le nom, l’auteur et la description d’un thème dans son JSON. L’écran d’installation affiche les mêmes valeurs : les deux ne peuvent donc jamais diverger.
La Boutique est facultative. Un fichier qui fonctionne se partage déjà.
custom.css enregistré se recharge dans tous les onglets à la fois.waybetter://install vers une URL https sur waybetter.fyi, cdn1.crt.fyi ou un fichier brut sur git.crt.fyi. Il n’est jamais installé sans l’écran d’installation.Chaque élément de la Boutique est un dossier sous store/<app>/ dans le dépôt. Le nom du dossier est l’identifiant de l’élément et son adresse ici : /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 ou tools. Thèmes : dark ou light, déduit du mode du thème si vous l’omettez.tagsversionVoilà toute la soumission. La page, la carte, l’entrée de recherche, l’aperçu du lien, les données structurées et l’entrée du sitemap sont générés à partir du catalogue signé lors de la construction du site. store/README.md contient toutes les règles.
Il n’y a pas de CI hébergée. Les vérifications sont des commandes que vous lancez avant d’envoyer, et qu’un mainteneur relance avant de fusionner.
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 au plus), name.plugin.js, pas de doublon dans une app@name, @version, une description et une ligne @permissions qui indique network ou network:nonenetwork:none est refusé quand le code appelle fetch, XMLHttpRequest, WebSocket, EventSource ou sendBeacon ; les appels à l’API protégée doivent être déclaréseval, new Function ni import() ; pas de scripts ni de fichiers externes dans un aperçu ; pas de @import ni d’URL externes dans le CSS d’un thèmeDeux façons d'entrer. Les deux demandent un compte git.crt.fyi gratuit : tout le monde peut s'inscrire, et un mainteneur valide chaque nouveau compte à la main.
La clé de signature de la Boutique est hors ligne par conception : fusionner n’est donc pas publier. Après la fusion, un mainteneur lit le code, lance waybetter store build et waybetter store sign sur la machine qui détient la clé, puis pousse. Le site est reconstruit, votre élément obtient sa page, et chaque app le voit à sa prochaine lecture du catalogue signé.
Tout ce qui figure dans le catalogue signé est garanti par cette clé ; c’est pourquoi une personne lit chaque plugin avant qu’il soit signé.
Un seul fichier pour toutes les apps wayBetter. Vous ne le modifiez jamais à la main : il est construit à partir des dossiers.
{ "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. Une app vérifie le fichier entier et ne garde que ses propres éléments.Ce ne sont pas des éléments de la Boutique : les 51 langues sont intégrées à l’app et chargées à la demande.
apps/desktop/locales/<tag>.json, par pull request ou par un ticket avec le fichier modifié en pièce jointe.bun run i18n:check : clés, espaces réservés, formes du pluriel, pas de balisage. La commande doit afficher 0 error(s).