Django Components

Un projet Django avec auto-reload et Tailwind CSS intégré.

🚀 Démarrage rapide

Prérequis

• Python 3.8+
• Node.js et npm
• Git

Installation

1. Cloner le projet :

   git clone <url-du-repo>
   cd djangocomponents

2. Créer et activer l'environnement virtuel :

   python -m venv venv
   source venv/bin/activate  # Sur Windows: venv\Scripts\activate

3. Installer les dépendances :

   pip install -r requirements.txt
   npm install

4. Effectuer les migrations :

   python manage.py migrate

Lancement du serveur de développement

npm run dev:all

Cette commande lance automatiquement :

• 🔄 Livereload - Rechargement automatique du navigateur
• 🌐 Serveur Django - http://127.0.0.1:8000
• 🎨 Tailwind CSS - Compilation en temps réel

Le projet sera accessible sur http://127.0.0.1:8000

📁 Structure du projet

djangocomponents/
├── components/         # Application Django principale
├── templates/          # Templates HTML
│   ├── cotton/        # Composants Cotton
│   └── index.html     # Template principal
├── theme/             # Thème et assets
│   ├── static/        # Fichiers statiques compilés
│   └── static_src/    # Sources Tailwind CSS
└── venv/              # Environnement virtuel

🛠️ Technologies utilisées

• Django 5.2.4 - Framework web Python
• Django Cotton - Système de composants pour Django
• Tailwind CSS 4.1 - Framework CSS utility-first
• DaisyUI 5.0 - Composants UI pour Tailwind CSS
• Livereload - Rechargement automatique du navigateur

📖 Documentation détaillée

Pour plus d'informations sur le développement, consultez README_DEV.md.

🔧 Scripts disponibles

• npm run dev:all - Lance tout le stack de développement
• npm run dev - Lance seulement la compilation Tailwind CSS
• npm run django - Lance seulement le serveur Django
• npm run livereload - Lance seulement le serveur Livereload

🐛 Dépannage

Si vous rencontrez des problèmes, vérifiez que :

• L'environnement virtuel est activé
• Toutes les dépendances sont installées
• Les ports 8000 et 35729 sont libres
• Les migrations ont été effectuées

Pour plus de détails, consultez la section dépannage dans README_DEV.md.