docs: create README with project documentation and rename project to Stripstream
This commit is contained in:
110
README.md
Normal file
110
README.md
Normal file
@@ -0,0 +1,110 @@
|
|||||||
|
# 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](https://nextjs.org/)
|
||||||
|
- [React 18](https://reactjs.org/)
|
||||||
|
- [TypeScript](https://www.typescriptlang.org/)
|
||||||
|
- [Tailwind CSS](https://tailwindcss.com/)
|
||||||
|
- [Shadcn/ui](https://ui.shadcn.com/)
|
||||||
|
- [Docker](https://www.docker.com/)
|
||||||
|
|
||||||
|
## 🛠 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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone [url-du-repo]
|
||||||
|
cd stripstream
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Installer les dépendances
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Créer un fichier `.env.local` à la racine du projet
|
||||||
|
|
||||||
|
```bash
|
||||||
|
NEXT_PUBLIC_API_URL=https://cloud.julienfroidefond.com
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Lancer le serveur de développement
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run dev
|
||||||
|
```
|
||||||
|
|
||||||
|
### Avec Docker
|
||||||
|
|
||||||
|
1. Cloner le repository et se placer dans le dossier
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone [url-du-repo]
|
||||||
|
cd stripstream
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Lancer avec Docker Compose
|
||||||
|
|
||||||
|
```bash
|
||||||
|
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](https://cloud.julienfroidefond.com/swagger-ui/index.html#/)
|
||||||
|
|
||||||
|
## 🏗 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]
|
||||||
Reference in New Issue
Block a user