Cursor Rules - Règles de développement

Ce dépôt contient des règles de développement personnalisées pour Cursor, organisées par technologie et domaine d'application.

📁 Structure des dossiers de règles

🐘 Laravel

• coding-standard.mdc - Standards de codage Laravel avec bonnes pratiques PHP
• docker.mdc - Configuration et règles Docker pour Laravel

⚛️ Next.js + Tailwind CSS

• general-project.mdc - Règles générales du projet (conventions, TypeScript, etc.)
• next-js-app-router.mdc - Règles spécifiques au App Router de Next.js
• templates.mdc - Modèles et structures de composants
• ui-components.mdc - Règles pour les composants d'interface utilisateur
• containers.mdc - Règles pour les composants conteneurs
• keycloak-themes.mdc - Règles pour les thèmes Keycloak

🚀 Comment utiliser ces règles dans Cursor

1. Configuration des règles globales

Pour appliquer ces règles à tous vos projets Cursor :

1. Ouvrez les Paramètres Cursor (Cmd/Ctrl + ,)
2. Allez dans AI > Rules
3. Cliquez sur "Add Rule"
4. Choisissez "From File"
5. Sélectionnez le fichier .mdc correspondant à votre projet

2. Configuration par projet

Pour appliquer des règles spécifiques à un projet :

1. Dans votre projet, créez un dossier .cursorrules à la racine
2. Copiez les fichiers .mdc pertinents dans ce dossier
3. Cursor détectera automatiquement ces règles

3. Application automatique

Les fichiers marqués avec alwaysApply: true seront automatiquement appliqués. Pour les autres, vous pouvez :

• Les appliquer manuellement via la commande /rules
• Les activer pour des fichiers spécifiques via globs dans le header

4. Utilisation des règles

Une fois configurées, les règles s'appliquent automatiquement :

• Génération de code : Cursor respectera vos conventions
• Refactoring : Les suggestions respecteront vos standards
• Code review : L'IA vérifiera la conformité avec vos règles

📋 Exemples d'utilisation

Pour un projet Laravel

# Copier les règles Laravel dans votre projet
cp -r laravel/ .cursorrules/

Pour un projet Next.js

# Copier les règles Next.js dans votre projet
cp -r nextjs-tailwind/ .cursorrules/

🔧 Personnalisation des règles

Chaque fichier .mdc contient :

• Header YAML : Métadonnées et configuration
• Description : Explication des règles
• Globs : Fichiers concernés (optionnel)
• alwaysApply : Application automatique (true/false)
• Contenu : Règles détaillées en markdown

Exemple de header

---
description: Description des règles
globs: **/*.{ts,tsx,js,jsx}
alwaysApply: true
---

📚 Documentation des règles

Laravel

• Standards PSR-12 et bonnes pratiques PHP 8.1+
• Architecture MVC et patterns Laravel
• Conventions de nommage et structure de dossiers
• Gestion des erreurs et logging

Next.js + Tailwind

• Conventions TypeScript et React
• Structure App Router et composants
• Accessibilité et performance
• Gestion des thèmes et composants UI

🤝 Contribution

Pour ajouter de nouvelles règles :

1. Créez un nouveau fichier .mdc
2. Suivez le format des fichiers existants
3. Ajoutez une description claire et des exemples
4. Testez dans Cursor avant de commiter

📖 Ressources

• Documentation Cursor Rules
• Format Markdown pour les règles
• Variables et placeholders

---

Note : Ces règles sont optimisées pour Cursor mais peuvent être adaptées pour d'autres éditeurs supportant le format .mdc.