Cab

The user interface of LocomotiveCMS, written in Ember.js with Ember CLI.

Cab will eventually become the new UI for the LocomotiveCMS backoffice, written in Ember.js. Eventually in big letter, due to currently lack of time and the Locomotive team still has to decide if Ember.js is the right framework, you can find the discussion here.

Personally we think Ember.js is a great framework, now we have to prove it and convince the team.

Prerequisites

Node.js / npm

Install Node Version Manager
Add the local binaries folder (./node_modules/.bin) to your $PATH environment variable

export PATH="./node_modules/.bin:$PATH"

For more information see Using npm like Bundler.

Ruby / Bundler

Watchman

Installing from source:

$ git clone https://github.com/facebook/watchman.git
$ cd watchman
$ ./autogen.sh
$ ./configure
$ make
$ sudo make install

On OS X:

$ brew install watchman

or

$ port install watchman

For more information see Watchman Installation.

Installation

Clone repository

$ git clone git@github.com:bitaculous/cab.git

Change into the new directory

$ cd cab

Install dependencies

$ npm install && bower install && bundle install

Running / Development

Run ember server

Proxy all AJAX requests to a given address, ideally a running LocomotiveCMS engine:

$ ember server --proxy http://<ADDRESS>:<PORT>

$ ember server --proxy http://webby.locoroco.com:8080

Open your browser at http://localhost:4200 or http://localhost:4200/tests.

Code Generators

Make use of the many generators for code, try ember help generate for more details.

$ ember generate <NAME> <OPTIONS>

Running Tests

$ ember test
$ ember test --server

Building

$ ember build (development)
$ ember build --environment production (production)

Credits

Cap uses the following libraries:

Ember CLI

Bug Reports

Github Issues are used for managing bug reports and feature requests. If you run into issues, please search the issues and submit new problems here.

Versioning

This project aims to adhere to [Semantic Versioning 2.0.0]. Violations of this scheme should be reported as bugs. Specifically, if a minor or patch version is released that breaks backward compatibility, that version should be immediately yanked and / or a new version should be immediately released that restores compatibility.

License

Cab is released under the MIT License (MIT), see LICENSE.

bitaculous/cab

Cab