(FOSS) Un pull request es un envío
Un tema es un archivo JSON. Un plugin es un archivo JavaScript. Créalo, pruébalo en la app y añádelo a la Tienda: una carpeta en un pull request, o el archivo en una incidencia si no usas git. Ambas opciones necesitan una cuenta gratuita en git.crt.fyi, y nada más.
Parte de un archivo que funcione. El generador escribe uno; la sección Crear de la propia app (wayBetter → Crear) tiene ejemplos y los valores del tema en vivo.
Colores, fuentes, esquinas, densidad, diseño, fondo, efectos. Con tres colores basta; el resto se deriva y el texto se mantiene legible.
O créalo en la app: Apariencia → Creador de temas → Exportar. THEMES.md enumera todo lo que un tema puede definir.
Una clase con start() y stop(), y una cabecera que dice quién lo hizo y qué usa.
Añade --ts para un proyecto en TypeScript. PLUGINS.md tiene la API, los permisos y la recarga en vivo.
El repositorio en 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 Tienda lee el nombre, el autor, la versión, la descripción y los permisos de un plugin de esta cabecera, y el nombre, el autor y la descripción de un tema de su JSON. La pantalla de instalación muestra los mismos valores, así que nunca pueden discrepar.
La Tienda es opcional. Un archivo que funciona ya se puede compartir.
custom.css guardados se recargan en todas las pestañas a la vez.waybetter://install a una URL https en waybetter.fyi, cdn1.crt.fyi o un archivo raw en git.crt.fyi. Nunca se instala sin la pantalla de instalación.Cada elemento de la Tienda es una carpeta bajo store/<app>/ en el repositorio. El nombre de la carpeta es el id del elemento y su dirección aquí: /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. Temas: dark o light, tomado del mode del tema si lo omites.tagsversionEse es todo el envío. La página, la tarjeta, la entrada de búsqueda, la vista previa del enlace, los datos estructurados y la entrada del mapa del sitio se generan a partir del catálogo firmado cuando se compila el sitio. store/README.md tiene todas las reglas.
No hay CI alojada. Las comprobaciones son comandos que ejecutas antes de enviar y que un mantenedor vuelve a ejecutar antes de fusionar.
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 -, hasta 40), name.plugin.js, sin duplicados en una app@name, @version, una descripción y una línea @permissions que indique network o network:nonenetwork:none se rechaza cuando el código llama a fetch, XMLHttpRequest, WebSocket, EventSource o sendBeacon; las llamadas a la API restringida deben declararseeval, new Function ni import(); sin scripts ni archivos externos en una vista previa; sin @import ni URL externas en el CSS de un temaDos formas de entrar. Las dos necesitan una cuenta gratuita en git.crt.fyi: cualquiera puede registrarse, y un mantenedor aprueba a mano cada cuenta nueva.
La clave de firma de la Tienda está sin conexión a propósito, así que fusionar no es publicar. Tras la fusión, un mantenedor lee el código, ejecuta waybetter store build y waybetter store sign en la máquina que guarda la clave y sube los cambios. El sitio se recompila, tu elemento obtiene su página y cada app lo ve la próxima vez que lee el catálogo firmado.
Todo lo que hay en el catálogo firmado está avalado por esa clave; por eso una persona lee cada plugin antes de firmarlo.
Un archivo para todas las apps de wayBetter. Nunca lo editas a mano: se genera a partir de las carpetas.
{ "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. Una app verifica el archivo entero y se queda solo con sus propios elementos.No son elementos de la Tienda: los 51 idiomas vienen integrados en la app y se cargan cuando hacen falta.
apps/desktop/locales/<tag>.json, con un pull request o con una incidencia que adjunte el archivo modificado.bun run i18n:check: claves, marcadores, formas de plural, sin marcado. Debe imprimir 0 error(s).