3a9f1aed04 | ||
---|---|---|
_build | ||
code | ||
design/Assets | ||
docs | ||
samples/activation | ||
templates | ||
.editorconfig | ||
.gitattributes | ||
.gitignore | ||
CONTRIBUTING.md | ||
LICENSE.md | ||
README.md |
README.md
Windows Template Studio
Windows Template Studio is a Visual Studio 2017 Extension that accelerates the creation of new Universal Windows Platform (UWP) apps using a wizard-based experience. The resulting UWP project is well-formed, readable code that incorporates the latest Windows 10 features while implementing proven patterns and best practices. Sprinkled throughout the generated code we have links Docs, Stack Overflow and blogs to provide useful insights.
Example scenario: I need an app that uses MVVM Light, uses master detail, can suspend and resume, settings, maps on one of the pages and will need Azure hub notifications. It will need a background service that does a query every 5 minutes.
Build Status
Env | CI | Templates Publishing | Extension Publishing | Full Templates Tests |
---|---|---|---|---|
dev | ||||
pre-release |
Features
Windows Template Studio approaches UWP app creation using the following four attribute sets:
- Project type: First, how do you want your app's UI navigation to behave? We currently support three project types: basic, navigation pane, and pivot and tabs
- App framework: Next, what coding pattern do you want to use in your project, we currently support three common patterns: code behind, basic MVVM, and MVVM Light
- App pages: To accelerate app creation, we provide a number of app page templates that you can use to add common UI pages into your new app. We currently include page templates from the blank page to the common layouts (e.g., master/detail, tabbed, web view) to pages that implement common patterns (e.g., app settings, map control). Using the wizard, add as many of the pages as you need, providing a name for each one, and we'll generate them for you.
- Windows 10 features: Lastly, you specify which UWP capabilities you want to use in your app, and we'll build out the framework for the features into your app, tagging 'TODO' items. Currently supported features cover application lifecycle (settings storage, suspend and resume), background tasks, and user interaction (app notifications, Live tiles, and Azure Notification Hub).
Once you select the attributes you want your new UWP app to have, you can quickly extend the generated code.
Known Issues
The following are known issues and may affect your use of Windows Template Studio. These will be addressed in the next few days.
- You must be online the first time you use the wizard to generate an app or no templates will be loaded. #311
- Only compatible with Windows 10. You cannot use this if running VS 2107 on an older Operating System. #357
Documentation
- Installing / Using the extension
- Using and extending your generated project
- Concepts of Windows Template Studio
- Getting started with the generator codebase
- Authoring Templates
Feedback, Requests and Roadmap
Please use GitHub issues for feedback, questions or comments.
If you have specific feature requests or would like to vote on what others are recommending, please go to the GitHub issues section as well. We would love to see what you are thinking.
Here is what we're currently thinking in our roadmap
Contributing
Do you want to contribute? Here are our contribution guidelines.
Principles
- Generated templates will be kept simple.
- Generated templates are a starting point, not a completed application.
- Generated templates once generated, must be able to be compiled and run.
- Generated templates should work on all device families.
- Templates should have comments to aid developers. This includes links to signup pages for keys, MSDN, blogs and how-to's. All guidance provide should be validated from either the framework/SDK/library’s creator.
- All features will be supported for two current Windows SDK for Windows 10 release cycles or until another principle supersedes it.
- Templates released in production will try to adhere to the design language used in the current release of Windows 10.
- Code should follow .NET Core coding style
License
This code is distributed under the terms and conditions of the MIT license.
Code of Conduct
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
Privacy Statement
The extension does log basic telemetry for what is being selected. Please read the Microsoft privacy statement for more information.