Les contributions de code, de documentation, de traduction et les rapports de bugs sont les bienvenues.
Avant de commencermodifier
- Si le changement est important ou discutable, ouvrez d'abord une issue.
- Travaillez sur une branche propre créée depuis
develop. - Faites des commits petits et descriptifs.
- Mettez à jour la documentation si les règles du projet changent.
Signaler un problèmemodifier
Ouvrez une issue avec :
- Une description claire du problème.
- Les étapes pour le reproduire.
- La version de CubicLauncher et du système d'exploitation.
- Un lien vers le log sur mclo.gs si applicable.
Commitsmodifier
Le format est :
text
<type>(<portée optionnelle>): <description courte>
[corps optionnel]
[breaking change / référence d'issue]Types courants : feat, fix, refactor, perf, style, docs, test, chore, i18n, et core pour le backend Rust.
- Les messages sont en espagnol, à l'infinitif ou à l'impératif.
- La première ligne ne doit pas dépasser 72 caractères.
- Décrivez le quoi, pas le comment.
- Un commit par changement logique.
- Marquez les changements incompatibles avec
!ouBREAKING CHANGE:dans le corps.
Flux de pull requestmodifier
- Créez une branche depuis
develop. - Implémentez le changement et mettez à jour les tests.
- Exécutez les vérifications locales :bash
bun run lint bun run check bun run test:all cargo fmt --all --check cargo clippy --workspace -- -D warnings - Ouvrez la PR contre
developet assignez au moins une label. - Répondez à la révision avec de nouveaux commits sur la même branche ; évitez de réécrire l'historique sauf demande explicite.
Labels de PRmodifier
| Label | Utilisation |
|---|---|
breaking | Changement qui casse la compatibilité. |
feature | Nouvelle fonctionnalité visible. |
core | Backend Rust. |
ui | Changements visuels en Svelte ou CSS. |
i18n | Traductions ou fichiers de langue. |
bug / fix / patch | Corrections. |
perf | Performances. |
test | Tests. |
docs | Documentation. |
chore / refactor / deps / ci | Maintenance. |
ignore-for-release | Ne doit pas apparaître dans le changelog. |
Conventions de codemodifier
- Rust :
rustfmtet Clippy sans avertissement. Les erreurs sont sérialisées en{"code":"...","params":{...}}pour l'i18n. - Svelte/TypeScript : runes de Svelte 5, pas de
any,keydans les blocs{#each}et$derivedpour les valeurs calculées. - CI : formatage, lints et tests s'exécutent sur GitHub Actions ; une PR ne passe pas en révision complète tant que tout n'est pas au vert.
Traductionsmodifier
Les traductions sont maintenues dans CubicLauncherDevs/Translations. Le launcher inclut es-ES et en-US comme solutions de repli locales.
Pour ajouter une nouvelle clé :
- Ajoutez-la dans
src/lib/i18n/en-US.jsonetsrc/lib/i18n/es-ES.json. - Dans le dépôt de traductions, modifiez
src/locales/*.json. - Incrémentez le champ
versionde chaque langue modifiée. - Ajoutez l'entrée dans
src/changelog.json. - Exécutez
bun run build && bun run deploydans le Worker.
Pour compléter les clés manquantes par rapport à en-US, utilisez bun run sync-locales dans le dépôt de traductions.