Introduction

VuePlay is your personal Vue testing ground. Just a few seconds after running vueplay from the command line you will have

  • a simple Vue app backed by Vue CLI,
  • located in a temporary and unique directory,
  • being served on localhost:8080,
  • open in Visual Studio Code ready for you to play around.

Getting Started

Installation

npm i -g @vue/cli-service-global
npm i -g @ckienle/vueplay

VuePlay requires @vue/cli-service-global to be installed globally. Otherwise it will not work.

Create a Playground

It could not be any easier. Just run vueplay:

vueplay

Configuration

VuePlay has a handful of options that you can adjust. Options are specified through the CLI.

CLI Options

This is VuePlay's usage description:

Usage: vueplay [options]

Options:

  --print-config  print resolved configuration, then exit
  --editor        specify editor used to open the playground (default: code)
  --no-open       do not open the playground (default: false)
  --dest          playgrounds output directory (default: temporary directory)
  --template-dir  specify a custom template for playgrounds (default: template
                  directory that is shipped as part of vueplay)
  --name          name format of the playground to be created in "dest"
                  (default: ${randomId}). You can use the following placeholder:
                  ${randomId}  will be replaced by a short random id
  --help          output usage information

  Options can also be specified by having a file called .vueplayrc.js in your
  home directory. Options specified via the CLI override the optiones that are
  also specified in the .vueplayrc.js config file.

                      🦄  made by the Unicorn Syndicate 🦄

Configuration File

You can configure everything also via a config file. VuePlay expects a config file to be at $HOME/.vueplayrc.js. The config file must export a single object:

$HOME/.vueplayrc.js:

module.exports = {
  dest: "/tmp"
}

This config has the same effect as the --dest-option: It specifies the destination directory of playgrounds that are created by VuePlay.

All keys are optional. If not specified the default value is used. A full configuration file looks like this:

$HOME/.vueplayrc.js:

module.exports = {
  dest: "/tmp",
  printConfig: false,
  help: false,
  editor: "code",
  open: true,
  templateDir: "/my/template",
  name: "${randomId}"
}

Configuration Merging

You can configure VuePlay by using command line options or a configuration file. Command line options always override options specified in the configuration file.

Examples

Default Playground

vueplay

Playground in the cwd

vueplay --dest .

Custom (static) Playground Name

vueplay --dest . --name helloworld

Custom Playground Name Format

vueplay --dest ~ --name 'prefix-${randomId}'

Open in different Editor

vueplay --editor atom

Disable Editor Integration

vueplay --no-open

Current State

vueplay is currently tailored to my personal needs. This means that there is not way to configure vueplay in any way. Running vueplay gives you:

  • A very simple Vue project in a temporary & unique directory with the following files:
    • App.vue: Entry point of the whole playground.
    • HelloWorld.vue: A simple component which is used by App.vue.
    • package.json: Simply contains a start-script which runs vue serve App.vue
    • .vscode/: A Visual Studio Code configuration with a simple Run-action.
  • After the playground has been created vueplay automatically
    • launches vue serve App.vue and
    • opens the playground in Visual Studio Code