Baboon singlepage frontend, based on AngularJS, backend independent.
npm install baboon-frontend
> 
$ npm install baboon-frontend
The module includes the lib with the directives and services.
See the docs folder
javascript
var fs = require('fs');
var express = require('express');
var path = require('path');var app = express();
// app files in public
var pub = path.join(__dirname, 'public');
app.use(express.static(pub));
// Just send the app-name.html or index.html to support HTML5Mode
app.all('/:app*', function (req, res) {
var app = req.params.app;
var appFile = app + '.html';
if (appFile === 'main.html' || !fs.existsSync(path.join(pub, appFile ))) {
res.sendfile('index.html', {root: pub});
}
else {
res.sendfile(appFile, {root: pub});
}
});
module.exports = app;
`$3
bash
server {
listen *:80
server_name my-app; root /path/to/app;
location ~ ^/(main)|(/$) {
try_files $uri /index.html;
}
location ~ ^/([a-z]+) {
set $var $1;
try_files $uri /$var.html /index.html;
}
}
`
$3
xml
ServerName my-app DocumentRoot /path/to/app
RewriteEngine on
# Don't rewrite files or directories
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]
# Rewrite everything else to index.html or toplevel.html to allow html5 state links
RewriteRule ^(main)|^($) index.html [L]
RewriteRule ^([a-z]+) $1.html [L]
`Contributing
Instead of us handing out a formal style guide, simply stick to the existing programming style. Please create descriptive commit messages.
We use a git hook to validate the commit messages against these rules.
Easily expand Baboon with your own extensions or changes in the functionality of baboon-frontend itself. Use this workflow:1. Write your functionality
2. Write unit tests for your functionality
3. Create an example of your functionality in the sample application (optional)
4. Document your functionality in the documentation section of example app
5. Write unit tests for the example
6. Add end to end tests for the example
7. All tests should be successful
8. Check your test coverage (90 - 100%)
9. Make a pull request
We will check the tests, the example and test coverage. In case your changes are useful and well tested, we will merge your requests.
$3
This section describes how to set up your development environment to build and test baboon-frontend with the example app.#### System requirements
* Node.js 6.0 or newer
Global node modules
Linux / Mac:
$ sudo npm install -g grunt-cli
Windows:
$ npm install -g grunt-cli
#### Install baboon-frontend and run the example app
The example application is also the reference implementation of Baboon.
Fork Baboon repository and install the dependent modules with npm and bower.
$ git clone https://github.com/litixsoft/baboon-frontend.git
$ cd baboon-frontend
$ npm install
$ grunt serve
The
command builds the example application in development mode, starts the server and opens the application in a browser.
It then watches for changes inside the directories. When a change is detected, grunt rebuilds the app and reloads the site in the browser.#### Running test and code coverage
Every test run includes the code style check with eslint.
Unit tests
$ grunt test
Unit tests code coverage
$ grunt cover
End 2 end test with protractor
$ grunt e2e
Unit and e2e tests in production mode (minified files)
$ grunt test:dist
Continuous integration test (generates test results as xml files)
$ grunt ci
Release a new version
We use grunt-bump and grunt-conventional-changelog internally to manage our releases.
To handle the workflow, we created a grunt task release. This happens:* Regenerate the docs for the lib folder
* Create minified version of the modules in the lib
* Bump version in package.json
* Update the CHANGELOG.md file
* Commit in git with message "Release v[
the new version number]"
* Create a git tag v[the new version number`]$ grunt release
Release a new minor version
$ grunt release:minor
Release a new major version
$ grunt release:major