Andamio is a set of frontend design patterns. It's intended for primarily two groups of users: # For interaction designers, it's easy to quickly create actual prototypes by copy/pasting some HTML. # For frontend developers, it's a minimal, flexible base framework to add your own visual designs to.
For compiling the CSS, we use the Grunt LESS module.
If you want to compile the CSS, you need to install the following:
- http://nodejs.org/
- from the command line, install grunt: npm install -g grunt
- in the andamio directory, run this: npm install grunt-contrib-less
Compile the CSS by running the following command in the andamio directory:
grunt less
Andamio is setup to make it easy to include in your project and adding your own CSS and Javascript to it.
I would suggest a directory structure like this:
/project-name/
|-- andamio/
|-- style/
|-- *main.less*
|-- js/
In the directory project-name/style/, add this file: main.less
Add the following lines to main.less:
@import "../andamio/style/main.less"; @import "mypattern.less"; // add your own patterns here
For developing, it's useful to use the grunt watch task. This will automatically compile the LESS files into main.dev.css and the Javascript files in main.dev.js, so you can include those in your templates.
Just run the following command in the andamio directory:
grunt watch
The default taks is to create development and production files:
grunt
To run the functional tests, you need CasperJS and PhantomJS. The tests are run from a script and check Andamio running at http://localhost/andamio/. The following command runs all current tests:
./run_tests.sh
Some tests generate a screenshot, you can inspect those in tests/screenshots.