Se aceptan contribuciones de código, documentación, traducciones y reportes de bugs.
Antes de empezareditar
- Si el cambio es grande o puede discutirse, abrí un issue primero.
- Trabajá en una rama propia creada desde
develop. - Hacé commits pequeños y descriptivos.
- Actualizá la documentación si cambian las reglas del proyecto.
Reportar un problemaeditar
Abrí un issue con:
- Descripción clara del problema.
- Pasos para reproducir.
- Versión de CubicLauncher y sistema operativo.
- Enlace al log en mclo.gs si aplica.
Commitseditar
El formato es:
text
<tipo>(<alcance opcional>): <descripción breve>
[cuerpo opcional]
[breaking change / referencia a issue]Tipos habituales: feat, fix, refactor, perf, style, docs, test, chore, i18n y core para el backend Rust.
- Los mensajes van en español, en infinitivo o imperativo.
- La primera línea no debe superar los 72 caracteres.
- Describí el qué, no el cómo.
- Un commit por cambio lógico.
- Marcá los cambios incompatibles con
!o conBREAKING CHANGE:en el cuerpo.
Flujo de pull requesteditar
- Creá una rama desde
develop. - Implementá el cambio y actualizá los tests.
- Ejecutá las comprobaciones locales:bash
bun run lint bun run check bun run test:all cargo fmt --all --check cargo clippy --workspace -- -D warnings - Abrí el PR contra
developy asigná al menos una label. - Respondé a la revisión con nuevos commits en la misma rama; evitá reescribir el historial salvo que se te pida.
Labels de PReditar
| Label | Uso |
|---|---|
breaking | Cambio que rompe compatibilidad. |
feature | Nueva funcionalidad visible. |
core | Backend Rust. |
ui | Cambios visuales en Svelte o CSS. |
i18n | Traducciones o archivos de idioma. |
bug / fix / patch | Correcciones. |
perf | Rendimiento. |
test | Tests. |
docs | Documentación. |
chore / refactor / deps / ci | Mantenimiento. |
ignore-for-release | No debe aparecer en el changelog. |
Convenciones de códigoeditar
- Rust:
rustfmty Clippy sin warnings. Los errores se serializan como{"code":"...","params":{...}}para i18n. - Svelte/TypeScript: runes de Svelte 5, sin
any,keyen bloques{#each}y$derivedpara valores calculados. - CI: formato, lints y tests se ejecutan en GitHub Actions; un PR no pasa a revisión completa hasta que todo esté en verde.
Traduccioneseditar
Las traducciones se mantienen en CubicLauncherDevs/Translations. El launcher incluye es-ES y en-US como fallback local.
Para agregar una clave nueva:
- Añadila en
src/lib/i18n/en-US.jsonysrc/lib/i18n/es-ES.json. - En el repo de traducciones, editá
src/locales/*.json. - Incrementá el campo
versionde cada idioma modificado. - Añadí la entrada en
src/changelog.json. - Ejecutá
bun run build && bun run deployen el Worker.
Para completar claves faltantes respecto a en-US, usá bun run sync-locales en el repositorio de traducciones.