Skip to content

🏠 A terminal-style home page to browse my personal projects.

License

Notifications You must be signed in to change notification settings

FlorianLeChat/Homepage

Repository files navigation

🏠 Homepage

In French

Introduction

Ce projet est un petit site Internet conçu sous forme de page d'accueil pour les utilisateurs cherchant à avoir un accÚs rapide vers mes projets les plus aboutis. Il sert également de porte d'entrée vers mon Portfolio. Comme vous avez pu le deviner, l'apparence générale du site Internet est grandement inspirée de craig-feldman/personal-website-react et perverse/vue-terminal-homepage, le style est trÚs orienté comme pour simuler un vrai terminal de commande sous Linux. Néanmoins, j'ai pris soin d'ajouter ma propre touche personnelle et d'utiliser des technologies différentes pour le développement de ce projet.

Important

L'entiĂšretĂ© du code de ce projet est commentĂ© dans ma langue natale (en français) et n'est pas vouĂ© Ă  ĂȘtre traduit en anglais par soucis de simplicitĂ© de dĂ©veloppement.

Installation

Warning

Le déploiement en environnement de production nécessite un serveur Web déjà configuré comme Nginx, Apache ou Caddy pour servir les fichiers statiques générés par Vite.

DĂ©veloppement local

  • Installer NodeJS LTS (>18 ou plus) ;
  • Installer les dĂ©pendances du projet avec la commande npm install ;
  • DĂ©marrer le serveur local Vite avec la commande npm run dev.

DĂ©ploiement en production

  • Installer NodeJS LTS (>18 ou plus) ;
  • Installer les dĂ©pendances du projet avec la commande npm install ;
  • Compiler les fichiers statiques du site Internet avec la commande npm run build ;
  • Utiliser un serveur Web pour servir les fichiers statiques gĂ©nĂ©rĂ©s Ă  l'Ă©tape prĂ©cĂ©dente.

Tip

Pour tester le projet, vous pouvez Ă©galement utiliser Docker. Une fois installĂ©, il suffit de lancer l'image Docker de dĂ©veloppement Ă  l'aide de la commande docker compose up --detach --build. Le site devrait ĂȘtre accessible Ă  l'adresse suivante : http://localhost:5173/. Si vous souhaitez travailler sur le projet avec Docker, vous devez utiliser la commande docker compose watch --no-up pour que vos changements locaux soient automatiquement synchronisĂ©s avec le conteneur. 🐳

Caution

L'image Docker ne peut pas et n'a pas Ă©tĂ© conçue pour fonctionner dans un environnement de production. Ce projet gĂ©nĂšre des fichiers statiques que vous devez servir avec un serveur Web dĂ©jĂ  configurĂ© et respectant aux bonnes pratiques de sĂ©curitĂ© et d'optimisation. ⚠

In English

Introduction

This project is a small website designed as a homepage for users looking for quick access to my most advanced projects. It also serves as a gateway to my Portfolio. As you may have guessed, the overall layout of the website is heavily inspired by craig-feldman/personal-website-react and perverse/vue-terminal-homepage, the style being very oriented to simulate a real Linux command terminal. However, I took care to add my own personal touch and to use different technologies for the development of this project.

Important

The whole code of this project is commented in my native language (in French) and will not be translated in English for easier programming.

Setup

Warning

Deployment in a production environment requires a pre-configured web server such as Nginx, Apache, or Caddy to serve the static files generated by Vite.

Local development

  • Install NodeJS LTS (>18 or higher) ;
  • Install project dependencies using npm install ;
  • Start Vite local server using npm run dev.

Production deployment

  • Install NodeJS LTS (>18 or higher) ;
  • Install project dependencies using npm install ;
  • Build static website files using npm run build ;
  • Remove development dependencies using npm prune --production ;
  • Use a web server to serve the static files generated in the previous step.

Tip

To try the project, you can also use Docker installed. Once installed, simply start the development Docker image with docker compose up --detach --build command. The website should be available at http://localhost:5173/. If you want to work on the project with Docker, you need to use docker compose watch --no-up to automatically synchronize your local changes with the container. 🐳

Caution

The Docker image cannot and was not designed to run in a production environment. This project generates static files that must be served with a pre-configured web server adhering to security and optimization best practices. ⚠

image