Facio is a project scaffolding tool originally developed for Django and expanded to be framework agnostic. You can use Facio to bootstrap any sort of project.

Using a custom Template

You can specify a custom template either via the command line or in a configuration file.

Via the command line

Simply provide Facio with the -t or --template argument followed by the path to the template. For example:

$ facio my_new_project -t /path/to/my/template

You can also provide a Git repository by adding git+ to the start of the template, for example:

$ facio my_new_project -t git+git@github.com/user/template.git

Via configuration file

Create a .facio.cfg file in your home directory, and enter the following:

[template]
default=/path/to/my/template

By default Facio will now use this template path, you can also add git repositories like in the command line example:

[template]
default=git+git@github.com/user/template.git

Multiple Templates

You can add more than one template to the config file:

[template]
default=git+git@github.com/user/template.git
experimental=/path/to/other/template

To use this template provide the -s or --select flag to facio and it will ask you to choose a template:

$ facio new_project -c
Please choose a template:

1) default: git+git@github.com/user/template.git
2) experimental: /path/to/other/template

Please choose a number between 1 and 2: