Working on the dashboard layout

If you just want to edit the styling of the dashboard files, it can be too complicated and time consuming to provision the box from scratch and set up the required symbolic links. Clone the repository into your www directory instead and edit from there. The paths are hardcoded into the dashboard index.php so everything works.

Cloning

• Setup the joomlatools-vagrant box if you haven't already
• Go to the www directory on your host computer (from inside the directory where you ran vagrant up): cd www
• Clone the entire repository: git clone [email protected]:joomlatools/joomlatools-vagrant.git
• Browse to the cloned dashboard file at joomla.box/joomlatools-vagrant/puppet/modules/custom/profiles/files/box/scripts/
• You can find all the dashboard related files in this directory: cd joomlatools-vagrant/puppet/modules/custom/profiles/files/box/scripts/

Symlink (optional)

To replace the box's dashboard with the clone you are working on, you need to replace the original directory with a symlink to the directory we created above:

• vagrant ssh
• mv ~/scripts/ ~/scripts-backup
• ln -s /var/www/joomlatools-vagrant/puppet/modules/custom/profiles/files/box/scripts ~/scripts

When done, simply commit and push again. The changes will be included automatically on the next build.

Grunt

Grunt is being used to compile source files and BrowserSync. Assuming you have Grunt installed:

• npm install
• grunt (grunt --canary if your prefer Chrome Canary)