blueprint-node

Blueprint

Create custom file templates for your project.

• File GitHub issues anytime you run into unexpected situations/bugs.
• Fork our project, send us PRs!

Usage

Setup where your Blueprint templates will be stored

• Create a folder anywhere in your project matching the templates path setting. By default, the path is set to blueprint-templates. (See Extension Settings if you would like to change this)

Add templates

• Create a template group by adding a new folder under the blueprint templates storage folder
• Add a template to the group by creating a new file

Create from a template

• Right click on the file or folder in the explorer
• Select "New file from template"
• Enter a name

Extension Settings

Templates Path

To change the default storage location for where Blueprint templates are stored, navigate to settings.json or ⌘, under Visual Studio Code preferences and change the blueprint.templatesPath setting

Example:

// Where your Blueprint templates are stored. Templates are loaded relative to your workspace root path. Defaults to ./blueprint-templates 
 
Examples:
"blueprint.templatesPath": [
  "./blueprint-templates",
  "../path-one-level-up-from-workspace",
  "~/path-from-home-folder",
  "/path-from-root
]

Available Transforms

Helper Name	Example Use In Templates	Example Use in File/Folder Names	Sample Result
upperCase	{{upperCase name}}	__upperCase_name__	THISISUPPERCASE
lowerCase	{{lowerCase name}}	__lowerCase_name__	thisislowercase
camelCase	{{camelCase name}}	__camelCase_name__	thisIsCamelCase
pascalCase	{{pascalCase name}}	__pascalCase_name__	ThisIsPascalCase
snakeCase	{{snakeCase name}}	__snakeCase_name__	this_is_snake_case
kebabCase	{{kebabCase name}}	__kebabCase_name__	this-is-kebab-case
lowerDotCase	{{lowerDotCase name}}	__lowerDotCase_name__	this.is.lower.dot.case

manifest.json

You can optionally include a "manifest.json" file in your template folders. This enables a few additionally points of customization.

key	Description of Use
suffixesToIgnoreInInput	If the value is "component" for instance, if user enters "My First Component" as the input -- "My First" will be used in the substitutions. This is to enable you to put "Component" in the template and not have to worry about the user entering it or not.
createFilesInFolderWithPattern (DEPRECATED)	Create your template files within a folder -- uses the same transfrom as you would use during naming your files and folders. This is possible now by just creating a top-level folder in your template. Previously we did not support folders within folders. You should use that technique instead of using this key.

Examples

Example templates can be found here: blueprint-examples

We will continue to add new templates that we think may be helpful to use!

Known Issues

Release Notes

2.2.0

• Skip content replacement on files that cannot read by handlebars. Useful for non-text files like images and video.

2.1.1

Bug Fix: Fixes detection of possible overwrites on file creation.

2.1.0

Cleanup of template selection user interface; the template name is now emphasized again.

Allow templates to include hidden folders and files. System created files (Thumbs.db, .DS_Store, etc. are still ignored).

Added two new transform helpers: lowerCase and upperCase.

2.0.0

Adds ability to provide multiple folders of templates. Useful for using both a project local and a shared (global) templates.

Template folder paths also now expand ~ to the home directory.

1.5.0

Added a new transform helper: lowerDotCase!

1.4.0

Now supports non-unix paths, AKA Windows support!

1.3.0

You can now create folders and nested folder/file structures inside a template folder. Folder names inside a template folder can be templated the same way that file names are.

1.1.0

Fixes missing dependency in initial release.