Introduction
Cette documentation a été créée pour vous guider et harmoniser le développement front-end. Elle fixe des principes de base à suivre, tout en offrant une certaine flexibilité. Le starter est une fondation: utilisez-le pour poser des bases solides, mais adaptez-le selon les besoins spécifiques de votre projet.
Les Fondamentaux
Voici quatre fondamentaux qui structurent notre approche:
1. Une organisation claire des fichiers
Structurez vos fichiers de manière logique et modulaire pour favoriser leur réutilisation et garantir une meilleure maintenabilité à long terme.
2. Une approche Mobile First
Développez vos interfaces en privilégiant d'abord les écrans les plus étroits, en élargissant ensuite les styles pour les tailles d'écrans plus larges (sauf consigne contraire).
3. Maximiser l'utilisation de Tailwind avec WordPress
- Intégrez les classes Tailwind directement dans les templates Blade.
- Pour éviter la redondance, utilisez
@applydans les fichiers SCSS. - Les breakpoints de Tailwind permettent de concevoir des interfaces responsives rapidement et efficacement.
4. Flexibilité et bon sens avant tout
La perfection n'est pas le but: si vous devez dévier des conventions, assurez-vous que cela soit justifié et améliore le résultat. Commentez vos choix pour permettre aux autres contributeurs de comprendre votre logique.
- Cette adaptation améliore-t-elle le projet?
- Est-ce cohérent avec les objectifs?
- Les autres développeurs pourront-ils comprendre mon choix?