klangbecken-ui

This vue.js web client is the user interface app for the Klangbecken project.

Project setup

npm install

Compiles and hot-reloads for development

npm run serve

Deployment

The deployment script deploy.sh automates deploying the code.

Preparation before deploying for the first time:

• Make sure, that the PROD_HOST variable in the deploy.sh script is pointing at your production server.
• Make sure, that you have access to the production server (e.g. SSH publik key authentication).
• Configure a remote repository upstream pointing at this upstream repository:

  git remote add upstream git@github.com:radiorabe/klangbecken-ui.git

• Configure git to automatically fetch tags from upstream:

  git config remote.upstream.tagOpt --tags

Preparation before deploying:

• Make sure your code builds correctly and passes continuous integration.
• Test your changes locally.
• Make sure that your working directory is clean, and that you are on the master branch:

  git stash
  git checkout master

• Bring your code in sync with the latest version from upstream:

  git fetch upstream
  git rebase upstream/master

• Verify that you are indeed in sync with upstream:

  git show --no-patch

Run the script:

./deploy.sh

It perfoms the following steps:

• Increment the version number.
• Perform a clean reinstall of all dependencies
• Build the project
• Copy the built files from dist/ to /var/www/html/ on the production server
• If everything was successful
  • Commit the new version number
  • Tag the new commit with the new version number
  • Push it to the upstream repository.

Licence

klangbecken-ui is released under the terms of the GNU General Public License. Copyright 2017-2021 Radio RaBe. See LICENSE for further information.