> For the complete documentation index, see [llms.txt](https://fredericheem.gitbook.io/starhackit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fredericheem.gitbook.io/starhackit/deployment/releasing.md).

# Releasing

## Change version

Change the version of the backend and frontend in the following files:

* [client/package.json](https://github.com/FredericHeem/starhackit/tree/41c810447e4291f350fd78a50252973f37ce3bac/client/package.json)
* [server/package.json](https://github.com/FredericHeem/starhackit/tree/41c810447e4291f350fd78a50252973f37ce3bac/client/package.json)
* [docker-compose.yml](https://github.com/FredericHeem/starhackit/tree/41c810447e4291f350fd78a50252973f37ce3bac/docker-compose.yml)
* [deploy/playbook/group\_vars/all/vars.yml](https://github.com/FredericHeem/starhackit/tree/41c810447e4291f350fd78a50252973f37ce3bac/deploy/playbook/group_vars/all/vars.yml)

## Version branch

Create a new branch, commit and push to the repository.

```
    $ git checkout -b v10.2.1
    $ git commit -m"v10.2.1" .
    $ git push origin  v10.2.1
```

Create a pull request, ask for review and merge to the master branch

Check out the master branch and pull the latest

```
$ git checkout master
$ git pull
```

The npm version script:

```
$ npm version 10.2.1
```

will perform the following tasks:

* build the docker images for backend and frontend
* push the images to the docker repository
* Change and commit the version on the root package.json
* tag the git repository with new version
* push the new git tag

You are now ready to [deploy with Ansible](/starhackit/deployment/playbook.md)