Generator-desk-themes NPM

Desk.com Theme Generator

Yeoman generator that scaffolds out themes for Desk.com for local development. Using gulp for the build process and based on gulp-webapp

npm.io

Features

Supports nearly all pages including email and chat widgets!
Compiles Desk's liquid variables with support for custom functions with gulp-liquify
CSS Autoprefixing
Built-in preview server with BrowserSync
Automagically compile Sass with libsass
Map compiled CSS to source stylesheets with source maps
Awesome image optimization
Automagically wire-up dependencies installed with Bower

Theme Options

Barebones - Foundation v5
Barebones - Foundation v6
Responsive Template (new Default) - Bootstrap
More options coming soon!

libsass

Keep in mind that libsass is feature-wise not fully compatible with Ruby Sass. Check out this curated list of incompatibilities to find out which features are missing.

If your favorite feature is missing and you really need Ruby Sass, you can always switch to gulp-ruby-sass and update the styles task in gulpfile accordingly.

Getting Started

Install dependencies: npm install --global yo gulp-cli bower
Install the generator: npm install --global generator-webapp
Run yo desk-themes to scaffold your webapp
Run gulp serve to preview and watch for changes
Run bower install --save <package> to install frontend dependencies
Run gulp serve:test to run the tests in the browser
Run gulp to build to compile sass

Docs

getting started with this generator
recipes for integrating other popular technologies like CoffeeScript
details about our Bower setup
contribution docs and FAQ, good to check before posting an issue

Options

--skip-welcome-message Skips Yeoman's greeting before displaying options.
--skip-install-message Skips the the message displayed after scaffolding has finished and before the dependencies are being installed.
--skip-install Skips the automatic execution of bower and npm after scaffolding has finished.
--test-framework=<framework> Either mocha or jasmine. Defaults to mocha.
--no-babel Scaffolds without Babel support (this only applies to app/scripts, you can still write ES2015 in the gulpfile)