Mango-cli NPM | npm.io

mango-cli

Scaffold and build your projects way more faster than before. Preconfigured frontend devstack to the absolute perfection. Fully automated to save your precious time. Ready for any type of web project.

A little example project is here: manGoweb/mango-cli-example.

Under the hood

Installation

Install mango-cli once from npm and use it everywhere:

npm install -g mango-cli

Requirements

Before installation check that your system has these requirements:

Node.js LTS (10.x)
Git executable in PATH

Mac OS X

python (v2.7 recommended, v3.x.x is not supported) (already installed on Mac)
Xcode
- You also need to install the Command Line Tools via Xcode. You can find this under the menu Xcode -> Preferences -> Downloads
libvips via Homebrew brew install vips

Windows

windows-build-tools via npm install -g --production windows-build-tools (from an elevated PowerShell)
- will install and configure Python v2.7 and Visual C++ Build Tools 2015 for you

Linux

python (v2.7 recommended, v3.x.x is not supported)
make
A proper C/C++ compiler toolchain, like GCC

Alternative methods

Docker

We also provide a Docker image mangoweb/mango-cli which is available on the Docker HUB

Pre-packed archives

If you're still having problems with the installation, check out prepared release packages.

Extract them locally and run npm link in the mango-cli folder (on Mac OS X you still need the libvips dependency though).

Usage

mango init - scaffolding and initialization
mango install - dependency installation
mango build - production build
mango dev - development mode

Feel free to use mango [command] -h for detailed instructions

Project scaffolding and initialization

mango init [options] [directory]

Forks a template into folder.

Options:

-s, --source [git_repository] - git repository with a template to fork. Default is currently the mango-cli-example

Managing project dependencies

mango install [packages...]

Installs packages from NPM and stores them in node_modules folder, from where you can require them (thanks to browserify). Maintain current list in the mango.yaml config file under the dependencies section.

Project build

Assuming the config file mango.yaml is present in a current directory and contains:

styles:
  - styles/screen.styl
scripts:
  - scripts/index.js
images:
  - images/**/*.{jpg,png,svg}
templates:
  - templates/**/*.pug
static:
  - fonts/**
dependencies:
  - jquery
watch:
  - app/**
dist_folder: dist

Config file can be in JSON or JS formats. mango.json gets parsed as a JSON file, mango.config.js gets required as-is.