Scissors.XafTemplates

This project contains dotnet new templates for DevExpress expressAppFramework and Scissors.

Installation

All templates

dotnet new -i Scissors.XafTemplates

Individual templates

dotnet new -i Scissors.XafTemplates.Module.CSharp
dotnet new -i Scissors.XafTemplates.Module.Win.CSharp
dotnet new -i Scissors.XafTemplates.Win.CSharp

Available templates

• dotnet new xaf-module: Creates an empty base module
• dotnet new xaf-win-module: Creates an empty windows-forms module
• dotnet new xaf-win: Creates an empty windows-forms application

Samples & Demos

Currently the templates are rather basic, so usage is a little bit limited, but they work for us right now. Feel free to file an issue or send an pull-request.

See demos for more details.

Empty Modules

BaseModule

dotnet new xaf-module -o Base -n Acme.Modules.TokenEditor

WindowsFormsModule

dotnet new xaf-win-module -o Win -n Acme.Modules.TokenEditor

Empty Applications

WinApplication

dotnet new xaf-win -o src -n Acme.DemoCenter

Building & Development

Prerequisites

• Node >= 10.15.3 (LTS)
• NPM >= 6.9.0
  • npm i npm@6.9.0 or npm i npm@latest
• .NET Core >= SDK 2.2

Building

For local development, make sure to uninstall all templates using build Uninstall:Debug after that, you can use build Install:Debug and work on the templates.

Task                          Description
================================================================================
Clean                         Cleans build artifacts
Pack                          Builds the templates into nuget packages using SemVer

Uninstall                     Uninstalls the templates via nuget
Install                       Installs the locally created templates via nuget

Uninstall:Debug               Uninstalls the debug version (folder) of the templates
Install:Debug                 Installs the debug version (folder) of the templates

u                             Shorthand for Uninstall
i                             Shorthand for Install

u:d                           Shorthand for Uninstall:Debug
i:d                           Shorthand for Install:Debug

Default                       Runs the default target Pack

Use tools\Cake\Cake.exe --showdescription for the actual build tasks

Contributing

This project uses branch protection and is Commitizen friendly.

First run npm i to install the dependencies for committing.

To perform a change switch to a new branch (from master):

git checkout -b topic/featurename-issueid

Start you work. Commit often and in small chunks by running through the wizard.

• git add . or stage your changes by hand.
• npm run cz
• git push

Push your work and perform a pull-request.

If you find interesting what I'm doing, consider becoming a patreon or contact me for training, development or consultancy.