foso

A convention over configuration bundler.

How to install it?

$ npm install --save-dev foso

Why not Gulp/Grunt or friends?

Gulp is a great task runner and has many libraries for bundling JavaScript and styles. However, a lot of configuration has to be done, to write a good gulpfile. Foso's manifesto is simplicity: everything should be bundled with zero configuration.

Foso does a lot with little effort:

• Bundles the resources with the plugins you install.
• Watches for changes in the source files and rebundles them on change.
• Starts a LiveReload server that reloads the browser each time a bundle was updated.
• Optionally also hosts your resources with a static server.

Plugins

Foso uses plugins to fosify resources. Here are some plugins available for foso:

• fosify-js
• fosify-less
• fosify-sass
• fosify-html
• fosify-test

Why is it convention over configuration?

Lets see why foso is convention over configuration on the example of the fosify-js plugin.

When using vanilla Browserify, each JavaScript file that has to be bundled needs to be specified. Fosify will bundle 2 types of JavaScript files:

1. Files that are named bundle.js and are not in the source root directory. These files will be bundled, moved one folder up in the destination directory and renamed to the containing folder. For example, /src/foo/bundle.js would be bundled to /dest/foo.js.
2. Files named [something].bundle.js. These files will be moved to the same directory as in the source folder and will be renamed, so that the bundle suffix is gone. For example, /src/foo/bar.bundle.js would be bundled to /dest/foo/bar.js.

The same conventions are applied in the other fosify plugins.

Usage example in the code

var foso = require('foso');
var less = require('fosify-less');
 
foso
  .please({
    src: './',
    dest: './dist',
    watch: true,
    minify: true
  })
  .fosify(less)
  .now();

Using foso as a CLI tool

Everything that is foso you can use from the command line. To use foso as a CLI tool, install it globally:

npm install -g foso

However, foso is nothing without its plugins. When you install foso plugins globally, they will be used by foso every time you run it. Install some foso plugins globally:

npm install -g fosify-js fosify-less fosify-html

Now that you have foso and some plugins installed, you can use it to bundle/host your resources.

Commands

• serve
• watch
• build

Serve

Bundles the resources in the current working directory and sets up a static server to host them.

Example:

foso serve

You can also specify the list of plugins that will be used against the resources. By default all the plugins will be used.

foso serve js less

For minifying the resources you can use the -m option.

foso serve -m

Watch

Bundles the resources in the current working directory and re-bundles them when the source files are updated.

Example:

foso watch

You can also specify the list of plugins that will be used against the resources. By default all the plugins will be used.

foso watch js less

For minifying the resources you can use the -m option.

foso watch -m

Build

Bundles the resources in the current working directory.

Example:

foso build

You can also specify the list of plugins that will be used against the resources. By default all the plugins will be used.

foso build js less

For minifying the resources you can use the -m option.

foso build -m

License

The MIT License (MIT)