SILL WEB

sill.etalab.gouv.fr frontend

Development

You'll need Node and Yarn 1.x. (Find here instructions by OS on how to install them)

It is much more easy to navigate the code with VSCode.

cd ~/github
git clone https://github.com/etalab/sill-api
cd sill-api
yarn
# Each time you change something on the server
# you should re-run the two following command.
yarn build # 'npx tsc -w' for watch mode compilation
yarn dev #Start the server on port 8080

# Open a new terminal

cd ~/github
git clone https://github.com/etalab/sill-web
cd sill-web
yarn
yarn link_api #This make sure that you use your local version of "sill-web" and not the latest NPM release.
yarn start #The app is running on http://localhost:3000

Linking inhouse dependencies

sill-web leverage a lot of inhouse NPM module, namely:

You may want to debug theses lib directly in sill-web. To do so simply do (we make an example with keycloakify but replace keycloakify by any of the above)

cd ~/github
git clone https://github.com/InseeFrLab/keycloakify
cd keycloakify
yarn
yarn build
npx tsc -w # This will start compilation in watch mode on Keycloakify

# Open a new terminal

cd ~/github/sill-web
ts-node --skip-project src/bin/link_inhouse_deps.ts keycloakify
yarn start
# Now, you can change Keycloakify and you will see the changes live in https://localhost:3000

Deploying changes in production

Frontend (sill-web)

Update the package.json version number and push.

Backend (sill-api)

Same, update the package.json version number and push. Don't forget however to wait for the latest version to be published on NPM. And update the version sill-web's package.json. (You'll need to update the package.lock as well by running yarn again, you can just run yarn add sill-api, it's faster).