Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tonylapoche/kasa_app
Kasa est une application frontend à destination d'une agence de location immobilière. Projet fictif pour l'école Openclassrooms, projet numéro 6 du parcours Développeur Web.
https://github.com/tonylapoche/kasa_app
openclassroom react react-router scss visual-studio-code vitejs
Last synced: 19 days ago
JSON representation
Kasa est une application frontend à destination d'une agence de location immobilière. Projet fictif pour l'école Openclassrooms, projet numéro 6 du parcours Développeur Web.
- Host: GitHub
- URL: https://github.com/tonylapoche/kasa_app
- Owner: TonyLaPoche
- License: mit
- Created: 2024-09-16T06:07:23.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-09-26T15:31:39.000Z (about 2 months ago)
- Last Synced: 2024-10-09T15:20:14.840Z (about 1 month ago)
- Topics: openclassroom, react, react-router, scss, visual-studio-code, vitejs
- Language: TypeScript
- Homepage: https://tonylapoche.github.io/kasa_app/
- Size: 3.7 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Kasa_App
Bienvenue sur **Kasa_App**, une application web de location immobilière développée en **React** avec **TypeScript**. Ce projet fait partie du parcours "Développeur Web" d'OpenClassrooms. Le projet est disponible en ligne sur GitHub Pages : [https://tonylapoche.github.io/kasa_app/](https://tonylapoche.github.io/kasa_app/).
## Table des matières
- [Kasa\_App](#kasa_app)
- [Table des matières](#table-des-matières)
- [Aperçu](#aperçu)
- [Fonctionnalités](#fonctionnalités)
- [Technologies utilisées](#technologies-utilisées)
- [Installation](#installation)
- [Hébergement et Routage](#hébergement-et-routage)
- [Subtilité du routage selon les branches](#subtilité-du-routage-selon-les-branches)
- [Contribuer](#contribuer)
- [Licence](#licence)
## Aperçu
**Kasa_App** est une application web conçue pour la location de logements. Elle permet aux utilisateurs de consulter une liste de logements, d'accéder aux détails de chaque propriété, et de naviguer entre différentes pages à l'aide de routes dynamiques.
Accédez à la version en ligne de l'application : [Kasa_App sur GitHub Pages](https://tonylapoche.github.io/kasa_app/).
## Fonctionnalités
- Affichage d'une liste de logements.
- Consultation des détails de chaque propriété (description, photos, équipements, etc.).
- Navigation entre différentes pages de l'application via un routeur.
- Gestion des erreurs 404 en cas de route incorrecte.
## Technologies utilisées
- **React** avec **TypeScript** pour la création de composants dynamiques.
- **Vite** pour une configuration de projet rapide et optimisée.
- **React Router** pour la gestion des routes.
- **GitHub Pages** pour l'hébergement de la version en production.
## Installation
Pour installer et exécuter ce projet en local, suivez les étapes ci-dessous :
1. Clonez ce dépôt sur votre machine :
```bash
git clone https://github.com/tonylapoche/kasa_app.git
```
2. Accédez au dossier du projet :
```bash
cd kasa_app
```
3. Installez les dépendances :
```bash
npm install
```
4. Lancez l'application en mode développement :
```bash
npm run dev
```
5. Accédez à l'application en ouvrant votre navigateur à l'adresse : `http://localhost:3000`.
## Hébergement et Routage
### Subtilité du routage selon les branches
L'application **Kasa_App** est hébergée sur **GitHub Pages** à l'adresse suivante : [https://tonylapoche.github.io/kasa_app/](https://tonylapoche.github.io/kasa_app/).
Cependant, une subtilité est à prendre en compte concernant le routage :
- **Branche `github-pages`** : La version hébergée utilise **createHashRouter**. Cette approche est nécessaire car GitHub Pages ne gère pas correctement les routes côté client.
- **Branche `main`** : En local ou dans un environnement où le serveur peut gérer les routes, nous utilisons **createBrowserRouter**, qui offre une gestion plus fluide des URL et des routes.
Cette différence de routage est simplement due aux limitations techniques de GitHub Pages.
## Contribuer
Les contributions sont les bienvenues ! Si vous souhaitez apporter des améliorations ou corriger des bugs, merci de suivre les étapes suivantes :
1. **Fork** le projet.
2. Créez une **branche** pour vos modifications : `git checkout -b feature/nom-de-la-fonctionnalité`.
3. **Commitez** vos modifications : `git commit -m 'Ajout d'une nouvelle fonctionnalité'`.
4. **Poussez** vers la branche : `git push origin feature/nom-de-la-fonctionnalité`.
5. Ouvrez une **pull request** pour examen.
## Licence
Ce projet est sous licence MIT - voir le fichier [LICENSE](LICENSE) pour plus de détails.
Retrouver également mes autres projets sur mon [portfolio](https://antoineterrade.com)
---