How to...

... create a new project

1. Install the extension following the steps from Installing the Extension

2. Open Visual Studio

3. Click on File-> New Project

4. Choose C# -> Windows Universal -> Windows Template Studio

5. Select a project type

   Details: By clicking the details link you can see a description of the project type, licenses and dependencies.

6. Select a design pattern:

   Details: By clicking the details link you can see a description of the design pattern, the author, licenses and dependencies.

7. Add the pages/features you want to add to your project.

   Pages and Features are separated in two categories, but their behaviour is the same:

   • You can add pages/features by clicking a template or by keyboard selection and pressing enter.
   • Rename: After adding a template you can change it's default name in the project details column on the right. Validations are applied (cannot be empty, contain whitespaces, …) In case validation is not successful, a warning message is shown. There are some features that do not allow renaming, in this case the textbox is disabled.
   • Multi Instance vs Single Instance: There are pages/features that can be added various times to the project and others that can be added only once (like the settings page). The number of pages added is indicated at the bottom of the template card by a counter. In case of Single Instance Templates it states added.
   • Dependencies: Some templates depend on others. When you add such a template, its dependencies are automatically added. You cannot remove a dependency whilst the dependent template is not removed (a warning message is shown)
   • Details: By clicking the details link you can see a description of the template, the author, licenses and dependencies.

8. Review your project configuration The project details configuration works like a shopping card. It provides an overview about everything you configured for your project and allows adjustments.

   • Dropdowns: The project type/design pattern dropdown allows you to change project type and design pattern. If you change it, your project will be reset, a warning is shown if you already added pages/features
   • Delete:: You can delete pages/features using the Del key or the delete button. If there is a dependency on the template it cannot be deleted and warning is shown. The last page cannot be deleted, there must always be at least one page
   • Reorder: You can reorder the pages (except settings page) by drag and drop or with Ctrl + Arrow Keys
   • Change names: You can rename pages/features as described above

9. Create: By clicking on create your project is created.