cegli

Dashboard Pattern Library

Live demo

Please visit our Pattern Library Site for a live demo.

Running it locally

You can see everything on the live demo. Setup a local environment only for development purposes.

Dependencies

• Ruby 2.1.5+
• RubyGems
• NodeJS

Installing Jekyll

bundle install

If you don't have bundler installed, run gem install bundler.

Installing node packages

npm install

Running the platform

Compile

We're using gulp to compile CoffeScripts and less files and to arrange assets so they can be picked up by Jekyll.

gulp

Once gulp starts it will watch for any changes made to your files and recompile automatically if needed.

Start the server

Open a second terminal window and startup Jekyll.

bundle exec jekyll s

Jekyll generates a static web page based on the source files. Use --no-watch to not re-generate whenever the source files change.

Open the library in browser

By default the server is running on 0.0.0.0 at port 4000.

Start up your browser and head to http://localhost:4000. If you're running jekyll on a VM open http://{ip_of_your_VM}:4000.

Updating the library

The gh-pages branch is specially configured to run on github pages and will not run on your local enviroment. Make sure you never directly commit to gh-pages. You should instead first update the master and then merge to gh-pages branch. This way we keep all changes in master and it's harder to break the live demo. Run gulp build before committing to gh-pages branch.

Developer notes

• All folders with the _ prefix are ignored by jakyll and not copied to _site.
• Run gulp clean if you get an error similar to the one bellow when trying to switch the branch.

Untracked working tree file 'build/fonts/avenirnextltpro-light-webfont.ttf' would be overwritten by merge.

Building and publishing new version

First update version in package.json and then

gulp npm
npm publish # npm login if not logged in

Problems with publishing

You need to have correct registry URL Setup

npm config get registry
# if http://npm.celtra.com/ then:
npm config set registry http://registry.npmjs.org/