Stripstream

Une application web moderne pour lire des bandes dessinées numériques, construite avec Next.js 14 et l'API Komga.

🚀 Technologies

• Next.js 14
• React 18
• TypeScript
• Tailwind CSS
• Shadcn/ui
• Docker

🛠 Prérequis

• Node.js 20.x ou supérieur
• npm 10.x ou supérieur
• Docker et Docker Compose (optionnel)

📦 Installation

Méthode classique

1. Cloner le repository

git clone [url-du-repo]
cd stripstream

2. Installer les dépendances

npm install

3. Créer un fichier .env.local à la racine du projet

4. Lancer le serveur de développement

npm run dev

Avec Docker

1. Cloner le repository et se placer dans le dossier

git clone [url-du-repo]
cd stripstream

2. Lancer avec Docker Compose

docker-compose up --build

L'application sera accessible sur http://localhost:3000

🔧 Scripts disponibles

• npm run dev - Lance le serveur de développement
• npm run build - Crée une version de production
• npm start - Lance la version de production
• npm run lint - Vérifie le code avec ESLint

🌐 API Komga

L'application utilise l'API Komga pour la gestion des bandes dessinées. La documentation de l'API est disponible ici : Documentation Komga API

🏗 Structure du projet

src/
├── app/                 # Pages et routes Next.js
├── components/          # Composants React réutilisables
│   ├── home/           # Composants spécifiques à la page d'accueil
│   ├── layout/         # Composants de mise en page
│   ├── reader/         # Composants du lecteur de BD
│   └── ui/             # Composants UI réutilisables
├── lib/                # Utilitaires et services
│   └── services/       # Services pour l'API et autres fonctionnalités
└── styles/             # Styles globaux

🤝 Contribution

1. Créer une branche pour votre fonctionnalité
2. Commiter vos changements
3. Pousser vers la branche
4. Ouvrir une Pull Request

📝 Guidelines de développement

• Suivre les principes DRY (Don't Repeat Yourself)
• Utiliser TypeScript pour tout nouveau code
• Utiliser les classes Tailwind pour le styling
• Implémenter les fonctionnalités d'accessibilité
• Mettre à jour le devbook.md pour toute modification significative

📄 Licence

Ce projet est sous licence [insérer type de licence]