Disclaimer: the Node version of Kit is currently not actively maintained and, as a result, highly unstable. Works best on Macs, has some major issues on Linux and Windows.
This Node version of the previous Developer Toolkit aims to be functionally identical, but more approachable to modern front-end developers. Powered by kit-core, the developer toolkit library.
At least Node 4.x and NPM 2.14.x.
$ npm install -g voog-kit
This makes the voog-kit main script globally available. The script is named "voog", but also aliased to "kit".
Voog-kit works with configuration files, either in the current folder, in the home folder, or in an explicitly defined location. Without the file, there is no way to tell what site you're working on.
The global file's structure should minimally be as follows:
{
"sites": [
{
"host": "< your site's primary hostname >",
"token": "< your API token >",
"path": "< full path to the project's working directory >"
}
]
}
The main commands to use voog-kit are pull
, push
and watch
.
Pull
downloads layouts and assets from your Voog site, saving them in their corresponding folders:
- layouts/ and components/ for markup files (saved with .tpl extension)
- images/ for image files (.jpg, .png etc.)
- javascripts/ for .js files
- stylesheets/ for .css files
- assets/ for everything else
Push
uploads the files to your site, overwriting the previous version. You can provide relative paths as specific files to push, e.g kit push layouts/blog.tpl
, which pushes only the blog layout.
Add
creates a new file and uploads it to the site. For example, kit add javascripts/main.js
creates an empty "main.js" file and pushes it to the site.
Remove
deletes the file, locally and from the site as well. For example, kit remove javascripts/main.js
deletes the "main.js" file and removes it from the site.
Watch
starts a file monitor that watches the six folders for any changes: creating, modifying and deleting files also uploads or removes the changed files.
Sites
lists all sites that are defined in the currently active configuration file.
Explicit options are always preferred over the configuration file and the configuration file will be updated every time an action is performed with new options. For example, when using voog push --overwrite
the first time, "overwrite": true
is added to the current site's configuration block and used for later actions automatically without having to provide it every time.
List of possible command-line options:
host
— your site's primary hostnametoken
— your API tokenoverwrite
— override the write-protection for assets and images. Old files will be deleted and replaced with new files.protocol
— specify the protocol that's used for the API requests (e.g--protocol=https
)configPath
— full path to a specific configuration fileglobal
— use global configuration file (/Users/<username>/.voog
for Unix systems,C:\Users\<username>\.voog
for Windows etc.)