Skip to content

radiorabe/klangbecken-ui

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.