Warhorse NPM | npm.io

Warhorse

Warhorse logo

NOTE: THIS PROJECT IS NOW AT A 'FEATURE-COMPLETE' ALPHA RELEASE.
PLEASE FILE AN ISSUE FOR ANY BUGS OR PROBLEMS YOU FIND ON YOUR LINUX/MACOS/WIN32 SETUP. THANK YOU.

What can Warhorse do?

Warhorse is designed to be a zero-configuration task runner for JavaScript projects.

Think of it like, Grunt or Gulp - but, without the weeks of configuration. ;)

Warhorse is built to:-

Bundle, transpile, minimise your JS files,
Preprocess and post-process your templates, SASS and CSS stylesheets,
Compress your project assets,
Test everything together with coverage.
Document almost everything... (API, test, coverage and linting)
Package and publish your end-product (e.g. to NPM)
And will keep watch and everything updated - until you switch it off!

So you can focus entirely on developing the actual code - which is your real app.

How does it do this?

Warhorse is based almost entirely on a set of carefully thought-out and standardised project layouts, templates, boilerplate code, naming and configuration schemes - it calls its "Conventions".

These Conventions don't try to 'reinvent the wheel' - but rather summerize - the most useful practises and structures that are in common-usage amongst developers and testers today.

An overall design and selection strongly lead by: 'Convention over Configuration', the Principle of Least Astonishment and most of all KISS!

You can find more information the specific Conventions that Warhorse offers in Wiki:Warhorse Conventions.

What tools does Warhorse use?

Warhorse maintains a curated and opinionated tool-set of core JS tooling to provide its functionality. These are, in no particular order:-

Babel,
Browserify,
GIT,
JSDoc,
JSHint, JSCS and ESLint,
LESS, SASS, CSSO and PostCSS,
Gifsicle, JpegTran and PngQuant,
SVGO,
plus a variety of bespoke tools.

With everything preconfigured - so you don't have to!

What deployments can Warhorse support?

Currently Warhorse supports building modules, libraries, clients and servers for targets:-

Node (Linux, MacOS, Windows)
Browser
Cordova (and PhoneGap)
TO BE SOON IMPLMENTED Electron

Installation

Warhorse is built and tested with all versions of Node v6+ on: Linux, MacOS and Windows.

npm -g install warhorse

MacOS USERS: Warhorse will install with 'sudo' - but it is not advised. Instead, it is recommended that you follow NPM's advice and relocate your global package directory. See, npmjs.org - 'Fixing npm permissions' for guidance.