Contribuer

Merci :) Ton aide est la bienvenue !

Le guide de contribution se trouve dans le fichier CONTRIBUTING.md

Requirements

You need minimum node@12 to be able to properly run ViteJS

Don't hesitate to install multiple node version in your dev environment using n

Boostrap

Install dependencies : npm ci

Run vite : npm run dev or vite (see package.json scripts)

Open your browser : http://localhost:3000/ and enjoy live reload / on-the-fly typescript compilation

You can also click on this link in order to open a Gitpod workspace with everything loaded in it.

Alternative: Running with docker

If you don't want to install node.js on your machine, you can isolate it with docker:

Start docker container (that executes npm run dev) : docker-compose up

Docker how-to

The first time docker-compose up is run, it will build the base docker image with npm install inside node:14 docker image.

When the package*.json have changed, you need to rebuild the base image:

docker-compose down --volumes
docker-compose build

.. then start again with docker-compose up.

To inspect what happens inside : docker-compose exec frontend bash

Production

Package for production with vite build : dist directory will contain minified assets for production

For debug purposes, if you want to generate sourcemaps for production build, you can configure vite.config.ts file by changing the build.sourcemap config property to true

Mobile apps

TODO

Development workflow

• main is automatically deployed on TODO

  => Push on this branch only when you're ready.

• dev is the development branch, start any new feature/fix from it.

  We generally try to create dedicated feature branches with issue number in it, except when the commit is really small

Stack pointers

We're using :

• Typescript as the main language => typescript for js programmers
• lit-element as the web-component library => https://lit.dev/
• pagejs as our routing library => documentation
• Bootstrap as the CSS library => https://getbootstrap.com/docs/5.0/getting-started/introduction/ (icons)
• SASS as CSS transpiler => documentation
• ViteJS for the development/production build toolchain => guide

Crédits

Terre icônes créées par Freepik - Flaticon