generator-helix

yeoman generator for Helix style Sitecore projects

Usage no npm install needed!

<script type="module">
  import generatorHelix from 'https://cdn.skypack.dev/generator-helix';
</script>

README

Helix Generator

npm version npm downloads Build Status Dependency Status License

This generator will create a Helix compliant solution and provide the ability to create & add new projects to any layer (i.e. Feature, Foundation & Project). Unicorn is used for serialization, if you don't use serialization and or TDS you have the option not to add serialization to the project.

Prerequisites:

  • VS 2015 or earlier
    If you want to run the generator with only Visual Studio 2017 installed, you need the Microsoft Build Tools 2015 as well. For more information see issue #109 and #107
  • NPM 3.x or newer (see installed version by running npm -v in PowerShell)
  • NODE 6.x or newer (see installed version by running node -v in PowerShell)

Getting started

You need Yeoman (See here) . Yo and the generators used are installed using npm.

First thing is to install Yo using npm.

npm install -g yo

Then you have to install the helix generator.

npm install generator-helix -g

How to create a solution

To create a Helix solution run the following command in an empty root folder where you want the solution to be created, and answer the questions.

yo helix

How to create a new project and add it to a given layer

To add a new project to an existing run the following command in the root directory, that contains the VS solution file. You can call with the Project Name, if you do not you will be prompted to enter it.

yo helix:add [ProjectName] [VendorPrefix]

Modifying the add project generator

Global Template folder

The Template folder contains all the files and folders that are copied to the project folder that is created.

By default, the Template folder for the add generator is at the following path:

C:\Users\[username]\AppData\Roaming\npm\node_modules\generator-helix\generators\add\Templates

You can modify any file in this folder to meet your specific requirements, but it will affect ALL projects.

Solution Specific Temaplte

What if you don't want to change the template for ALL sitecore solutions, but only for a specifc sitecore solution for example you want to do the following

  • Add/Remove files
  • Add/Remove folders
  • Modify file contents

It is possible to define a solution specific Solution Template folder.

To override the default Template folder - add a folder called helix-template to the solution root.

Then all files will be copied from the solution specific helix-template folder instead of the default folder using the copyTpl function in yeoman.

You can inject all the variables that the generator defines into your files using the syntax below for example.

<%= layerprefixedprojectname %>

List of Variables

  • layerprefixedprojectname
  • projectname
  • projectguid
  • layer
  • target
  • vendorprefix

Note

The one special case is that if you have a file called _project.csproj in the folder, it will be copied and then renamed to the correct Project name. This way you can create your own project file that matches your specific needs.

Contributing

We love it if you would contribute! Please read our contributing guide if you're looking to help us out.

Help us! Keep the quality of feature requests and bug reports high

We strive to make it possible for everyone and anybody to contribute to this project. Please help us by making issues easier to resolve by providing sufficient information. Understanding the reasons behind issues can take a lot of time if information is left out. Time that we could rather spend on fixing bugs and adding features. Please adhere to our issues template when creating issues. Creating a new issues will automatically prompt a template that will let you know what the minimum requirements are.

Thank you, and happy contributing!

Versioning

For transparency and insight into our release cycle, and for striving to maintain backward compatibility, the generator-helix project will be maintained under the Semantic Versioning guidelines as much as possible.

Releases will be numbered with the following format:

<major>.<minor>.<patch>

And constructed with the following guidelines:

  • Breaking backward compatibility bumps the major (and resets the minor and patch)
  • New additions without breaking backward compatibility bumps the minor (and resets the patch)
  • Bug fixes and misc changes bumps the patch

For more information on SemVer, please visit http://semver.org/

To create a new version please follow the Release Process.

Troubleshooting

When I execute the yo commands as described I'm met with Execution Policy errors

To get around this issues execute the following command in a command line prompt, such as PowerShell with administrator rights:

Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force