Skip to content

floupette/gustave

Repository files navigation

Chez Gustave

Logo

Specifications Assets

Templates

Templates are branches of this repository.

Starting a template

The only thing needed is Docker.

Go the the root of the template and run docker compose up -d.

This should start the server and the client.

The server should be accessible on localhost:3630, and the client on localhost:5173.

If you want to close them docker compose kill to close the server, client and database and docker compose down to delete the containers.

Tests

Server

To run server tests your need to run the docker-compose.test.yml instead of the normal docker-compose.yml

To do that you should run: docker compose -f docker-compose.test.yml up -d.

Client

To run client tests you need to start docker as normal and then cd into the client directory and run npx cypress open.

This should open a browser where you can access, edit and create e2e tests.

Guidelines

When you want to start working on something, be it a new feature a bug fix or tests you need to create a new branch to hold your changes.

Firstly you need to create the branch by doing git checkout -b branch_type/branch_name.

The branch_type should be one of: features for new features, bugs for bug fixes or tests for updating/adding tests.

The branch_name should describe what's being done, some example: features/login-page, bugs/fixing-the-modal-component, ...

When you have made a branch you can code as normal and commit regularly.

To push your changes you can use git push -u origin branch_name. branch_name being the whole branch name with the prefix (features, ...).

Once that is done you should be able to see the branch on the github repository.

When you are ready you can then create a pull request, and wait for a review.

You can always push commits to the branch when the pull request is created, they will be automaticly added to the pull request.