An open API service indexing awesome lists of open source software.

https://github.com/kevinnizet/hackathon1

Projet réalisé dans le cadre du premier hackathon (24h) à la Wild Code School
https://github.com/kevinnizet/hackathon1

hackaton javascript react

Last synced: about 1 month ago
JSON representation

Projet réalisé dans le cadre du premier hackathon (24h) à la Wild Code School

Awesome Lists containing this project

README

          

## Concept

Dans le cadre du Hackaton N°1, thème "Vacances", nous avons développé l'application DansMaValise pour ne plus jamais rien oublier lors de la préparation de ses vacances !
L'application propose une liste des choses indispensables à ne pas oublier en amont du départ en fonction du pays de destination choisi.
Elle permet également de personnaliser sa ToDo List afin d'emporter dans sa valise le nécessaire à des vacances réussies.

## Setup & Use

### Project Initialization

- In VSCode, install plugins **Prettier - Code formatter** and **ESLint** and configure them
- Clone this repo, enter it
- If you are using `yarn` or `pnpm`, adapt the `config/cli` in `package.json`
- Run command `npm install`
- _NB: To launch the backend server, you'll need an environment file with database credentials. You'll find a template one in `backend/.env.sample`_

### Available Commands

- `migrate` : Run the database migration script
- `dev` : Starts both servers (frontend + backend) in one terminal
- `dev-front` : Starts the React frontend server
- `dev-back` : Starts the Express backend server
- `lint` : Runs validation tools, and refuses unclean code (will be executed on every _commit_)
- `fix` : Fixes linter errors (run it if `lint` growls on your code !)

## FAQ

### Tools

- _Concurrently_ : Allows for several commands to run concurrently in the same CLI
- _Husky_ : Allows to execute specific commands that trigger on _git_ events
- _Vite_ : Alternative to _Create-React-App_, packaging less tools for a more fluid experience
- _ESLint_ : "Quality of code" tool, ensures chosen rules will be enforced
- _Prettier_ : "Quality of code" tool as well, focuses on the styleguide
- _ Airbnb Standard_ : One of the most known "standards", even though it's not officially linked to ES/JS
- _Nodemon_ : Allows to restart the server everytime a .js file is udated

### Deployment

For deployment, you have to go to `secrets` → app `actions` on the github repo to insert via `New repository secret` :

- CAPROVER_BACK_APPNAME : name app on caprover
- CAPROVER_FRONT_APPNAME : name app on caprover
- CAPROVER_PASSWORD : password caprover
- CAPROVER_SERVER : link of domain