Source code management utilities for atvise
npm install atscm> Source code management utilities for atvise



_atscm_ is a node.js based utility that stores the contents of atvise projects on the file system. This has several benefits to advanced atvise developers:
- atvise project can be put under source control (e.g. using _git_)
- source code can be edited in external editors
- easier unit testing
- easier source code linting / static analysis
- source files can be preprocessed by using custom transformers:
- using alternate programming languages such as ES2015 JavaScript or TypeScript
- using alternate markup languages such as pug
- using templating engines such as handlebars
Prerequisite: Install node.js (version 10 or later)
How to check which version is installed
- Make sure node.js (version 10 or later) is installed by running node --version.
- Make sure npm is installed by running npm --version.
_atscm_ can be installed via atscm-cli.
> Run npm install --global atscm-cli to install _atscm-cli_ globally. _You may have to run this command as an administrator._
With atscm-cli installed run atscm init to create a new _atscm_ project.
Simply run npm init atscm to create a new atscm project.
Pulling nodes from atvise server
Running atscm pull will download all nodes from atvise server into the ./src folder inside your project.
By default only displays, serverside scripts and quickdynamics will be split into their JavaScript and SVG sources. You can specify additional transformers to use in your Project configuration file.
Pushing source files to atvise server
Running atscm push will update all nodes from the contents of your ./src folder.
Automatically watching for changes
After running atscm watch files and atvise server nodes are watched for changes. If a file changes, the file is pushed, if a node changes this node is pulled.
atscm watch is very useful if you want edit source files in an external editor but still have the ability to use _atvise builder_'s drag and drop functionality.
An atscm project's configuration is stored inside the _Atviseproject_ file inside your project root. See the Atviseproject class reference for available options.