Springboard
Springboard helps you setup web projects in seconds and easily manage concatenation, minification and compilation of scripts and styles.
The idea behind Springboard is to provide a universal build system for HTML/CSS/JS projects that works with your own project template library (whichever boilerplates you may use) and helps you get going with projects of any size quickly and easily.
Here's how it works...
Blocks
Blocks tell Springboard what to do with your scripts and styles when you build. Just tell it to concat, minify or compile and specify an output:
<!-- sb: minify css/styles.min.css -->
[any number of linked styles]
<!-- end -->
The output path serves as the block ID, so you can specify as many as you like and use the same blocks across multiple pages.
You can also use the show and hide commands to rewrite code during the build process:
// sb: hide
var DEBUG = true;
// sb end
Or conversely:
/* sb: show
var DEBUG = false;
sb: end */
Installation
$ git clone [email protected]:soulwire/Springboard.git Springboard
$ cd Springboard
$ python springboard install
Setup a new project
Once Springboard is installed, setting up a new project is easy
$ cd /YourWorkspace/NewProject/
$ springboard init
Templates
You can define any number of project templates by dropping them into Springboard's templates folder. To use them, simply specify their name when you init a project
$ springboard init custom-template
Build
From within a project directory, invoke a build like so
$ springboard build
To see all available commands and options, just type
$ springboard help
And you can always use the sb alias for faster typing
$ sb build
Configuration
The project template includes a small config file (.sbconfig), which allows you to specify default build settings for the project, such as the source and deploy directories and the Closure Compiler compilation level.
Sublime Text Build System
To use Springboard as a Sublime Text build system, create a file called Springboard.sublime-build containing the following
{ "cmd": ["python", "~/local/springboard/springboard", "build"], "working_dir": "${project_path:${folder}}" }
and save it in the directory
~/Library/Application Support/Sublime Text 2/Packages/User/