Modular task runner for reusable build systems
Install Skivvy globally:
npm install -g skivvy
This will make the
skivvy command globally available. See the list of available commands.
What is Skivvy?
Skivvy is a task runner. It comes with a simple command-line tool that lets you instantly launch your project's tasks without ever needing to write any plumbing code. Skivvy's task packages make it a piece of cake to add to your project's repertoire of available tasks, and allow you to create truly modular, reusable build systems.
Skivvy will only go as far as launching your tasks though: what you choose to do within the tasks themselves is completely up to you. You can write tasks that scaffold components, switch branches, file issues, deploy builds, send emails… the sky's the limit. Under the hood, Skivvy tasks are just plain functions, so you're free to implement them however you like.
The Skivvy workflow
There are 4 steps in the Skivvy workflow:
- Initialize a project:
- Install task packages:
skivvy install <package>
- Configure task packages:
skivvy config [options]
- Run tasks from the installed packages:
skivvy run <task>
...this gives you a robust and highly configurable task system, all without having to write a single line of code. Take a look at Skivvy in action:
How does it work?
- Off-the-shelf task packages can be installed alongside your project-specific tasks
- All tasks are automagically accessible from the command-line as soon as they are installed
- Tasks can be configured with the command-line tool, or by hand-editing JSON if preferred
- Custom tasks can easily be packaged into modules and shared across multiple projects
The killer feature: task packages
Skivvy tasks can be organized into modules, or packages. This allows all the heavy lifting to be handled by configurable helper packages whose internals are completely isolated from the main application – kind of like Docker, but for build systems. Packages are intended to be reused across many different projects, and range from generic utilities (e.g. skivvy-package-copy), to heavily opinionated build packs (e.g. a package to scaffold/test/build/deploy an HTML boilerplate app in your company's house style).
Within a Skivvy project, as soon as you install an off-the-shelf task package, all of its tasks are instantly accessible from the command-line, without you having to write any code whatsoever. Tasks can be configured either via the command-line tool or by hand-editing a simple JSON configuration file. This task configuration is loaded automatically on a per-task basis, so even a very intricate task system should only need a small amount of simple code to link packages together.
Packages can easily be combined into other packages, allowing you to compose elaborate task systems with as little code as possible. Using a modular task system ensures that your build setup won't sprawl out of control as a project grows over time, and allows you to mix and match task modules across different projects without any fuss.
How does Skivvy relate to gulp/Grunt/etc?
Check out the Skivvy for gulp/Grunt users guide to see what sets Skivvy apart from the other tools on offer.
Usage instructions: Hello World app
Initialize a Skivvy project in a new folder:
mkdir example-app && cd example-app skivvy init
Seeing as this directory has not yet been initialized as an npm module, Skivvy will automatically run the
npm initcommand and guide you through the process.
hello-worldpackage to the current project:
skivvy install hello-world
List the tasks installed by the
This will output something like the following:
email@example.com └─┬ firstname.lastname@example.org ├── greet - Greet the user └── welcome - Welcome the user
This means that within our project we're now able to use the
hello-world::welcometasks, seeing as they were both included in the
skivvy config set --package=hello-world --config.user=Skivvy
This sets the
userconfiguration variable within the
skivvy run greet # Outputs: "Hello, Skivvy!" skivvy run welcome # Outputs: "Welcome to Skivvy!"
Take a look at the Getting started with Skivvy guide and the list of available commands to get a thorough understand of how it all works. Once you've had a skim through that, you should be all set to dive in.
Good luck Skivvying!