Faites avancer le projet
avec une contribution utile
DevStarter Kit est développé seul, mais chaque contribution utile, même petite, peut vraiment faire progresser le projet : correction, idée de template, amélioration de doc ou retour d'expérience.
4 façons de contribuer
Pas besoin d'être expert. Chaque forme d'aide est précieuse et bienvenue.
Ajouter un template
Créez un nouveau composant HTML/CSS/JS selon les standards du projet. C'est la contribution la plus impactante — chaque template aide des centaines de développeurs.
Voir le guide →Signaler un bug
Un template qui ne s'affiche pas correctement, une faute de frappe, un lien cassé ? Signalez-le. Un bug signalé est à moitié corrigé.
Signaler →Améliorer la doc
Clarifier un commentaire de code, améliorer une description de template, traduire du contenu. La documentation est toujours perfectible.
Proposer →Partager le projet
Parlez de DevStarter Kit à un ami développeur, partagez-le sur les réseaux sociaux, citez-le dans un article. La visibilité aide le projet à grandir.
Partager →Ajouter un template en 5 étapes
Forkez le dépôt
Depuis GitHub, cliquez sur Fork pour créer votre propre copie du projet. Clonez ensuite votre fork en local.
git clone
https://github.com/votre-nom/devstarter-kit.git
Créez une branche
Nommez votre branche de façon descriptive :
feature/nom-du-template
pour un nouveau composant,
fix/description-du-bug
pour une correction.
git checkout -b feature/hero-section
Développez votre template
Respectez les standards de qualité du projet (voir le tableau ci-dessous). Votre template doit inclure : le HTML sémantique, le CSS avec variables, et optionnellement du JS si nécessaire.
Ajoutez votre template dans la page de sa catégorie (ex :
cards.html) en suivant le pattern
.template-item
existant.
Commitez et poussez
Utilisez des messages de commit clairs et en français ou en anglais, selon votre préférence.
git add .
git commit -m "feat: ajoute hero section avec
animation"
git push origin feature/hero-section
Ouvrez une Pull Request
Depuis GitHub, ouvrez une PR vers la branche
main. Décrivez ce que vous avez ajouté, pourquoi, et ajoutez une
capture d'écran si possible. Je fais au mieux pour relire
rapidement chaque proposition.
Standards de qualité
Un template accepté doit respecter ces règles sans exception.
| Critère | Requis | Description |
|---|---|---|
| HTML sémantique | ✓ Oui |
Utiliser les bonnes balises : <nav>,
<article>, <section>,
etc.
|
| Nommage BEM | ✓ Oui |
Classes CSS en format .block__element--modifier
|
| CSS Variables | ✓ Oui |
Utiliser les variables du système (--primary,
--bg-card, etc.) pour la compatibilité dark
mode
|
| Responsive | ✓ Oui | Fonctionne sur mobile (320px), tablette (768px) et desktop (1200px+) |
| Dark mode | ✓ Oui | Le template doit s'adapter automatiquement via les CSS variables |
| Accessibilité | ✓ Oui |
Attributs aria-label, alt pour les
images, contraste suffisant
|
| Frameworks CSS | ✗ Non | Pas de Bootstrap, Tailwind, etc. CSS pur uniquement |
| Bibliothèques JS | ✗ Non | Pas de jQuery, Alpine.js, etc. Vanilla JS uniquement |
| Commentaires | Recommandé | Commenter les parties complexes pour aider les débutants à comprendre |
Le projet est ouvert
DevStarter Kit est aujourd'hui développé seul, mais les idées, les signalements et les futures contributions externes sont les bienvenus.
FAQ contribution
Absolument pas. Les débutants peuvent tout à fait contribuer — corriger une faute, améliorer un commentaire de code, ou proposer un template simple. Ce projet est justement fait pour les développeurs en apprentissage. Votre regard de débutant est souvent plus précieux que celui d'un expert.
Le code lui-même (noms de classes, commentaires) peut être en anglais — c'est même recommandé pour respecter les conventions. En revanche, la description du template et les textes de l'interface doivent être en français, puisque la plateforme s'adresse à la communauté francophone.
Je fais de mon mieux pour répondre rapidement aux PRs. Si votre proposition respecte les standards du projet, elle pourra être intégrée. Sinon, je laisserai un retour clair pour expliquer ce qu'il faut améliorer.
Non. C'est une règle fondamentale du projet : zéro dépendance externe. Pas de jQuery, pas de Bootstrap, pas de Tailwind. L'objectif est que n'importe quel développeur puisse copier-coller le code dans un fichier HTML vierge et que ça fonctionne immédiatement, sans npm install.
Oui, toute contribution acceptée peut être créditée dans le dépôt et dans le changelog du projet. L'objectif est de reconnaître proprement chaque apport utile.
Prêt à contribuer ?
Chaque ligne de code que vous ajoutez aide des développeurs débutants à progresser. C'est concret, mesurable, et gratifiant.