Revision as of 11:57, 10 March 2014 by David.bauer (talk | contribs) (appserver)
Getting started with grunt



Install the default nodejs of your distribution via your favourite package/ports manager and you are good to go.


Head to the node.js site and download and install the latest version. It is recommended to restart after the installation, as paths may not be up-to-date.

Mac OS X

We strongly encourage you to use homebrew. Make sure you have checked your homebrew installation with brew doctor and resolved any issues remaining.

Install node via brew install node or run brew upgrade if you already have node installed.

Make sure you don't sudo anything related to node. If you think you have to, you are doing something wrong and are probably dealing with a broken homebrew/macports installation! If this is the case, the easiest way of resolving this is completely deleting the homebrew (and if present macports) directories and (re)installing homebrew.

The default system's max opened file limit in mac os x is very low (256), in order to use grunt watch, it needs to be increased.

You can either set this in your shell via ulimit -n 8192 to a sensible value or you can set it permanently by adding

limit maxfiles 8192 20480

to /etc/launchd.conf.

Grunt & Bower

With npm install -g bower grunt-cli you can install the global npm dependencies needed for grunt and bower.

Cleaning development environment

Sometimes it is needed to completely wipe all old and ignored (by git) files. You can also do this using git by running git clean -ndx this will print a lot of files, but _not_ delete any. Check the list if you really want to remove these files. Then run git clean -fdx to really do the cleanup.

Installing node dependencies for OX Appsuite Frontend development

Change to the ui directory of your git workdirectory and run npm install. Make sure, you have got the git binary in your path. (This is sometimes a problem on windows, make sure to activate the option to put git into your path during msys-git installation. TODO: more detail)

Building the UI

Just run the default grunt task grunt

Local configuration

You can override some options on your local build environment by creating the file grunt/local.conf.json. See grunt/local.conf.default.json as a template.

Hint: copy the default file to grunt/local.conf.json to get started.


If you want to use the proxy function of the appserver, at least the server-variable needs to be configured.


   appserver: {
       server: "",
       verbose: ["local:error"]


You can run the appserver with the connect grunt task: grunt connect:server:keepalive or in combination with the watch task: grunt connect watch