Core Template Studio

Core Template Studio is a .NET Standard 2.0 project that handles all of the template synchronization and code generation (composition, generation + postaction execution) for WindowsTemplateStudio and WebTemplateStudio. The main project has two parts: a .NET Standard core and its corresponding Cli that exposes the core. There's also a tools folder containing helper tools as the WtsPackagingTool.

Build Status

Branch	Build Status
dev
release

Branches

Our default branch is dev and all PR's should go to the dev branch. While there are no releases of CoreTS, we still have a release branch on CoreTS as this is where the submodules on Web Template Studio and Windows Template Studio point to. When adding new functionality or changing existing code make sure the changes are compatible with both Windows Template Studio and Web Template Studio. All changes have to be tested in both Windows Template Studio and Web Template Studio before being merged into the release branch.

Documentation

• Getting started with the codebase.

Features

• Synchronizes Templates: The core has the ability to synchronize with templates, either in debug as a templates folder or in release as a .mstx file. It also builds and refreshes the template cache.
• Provides information about available templates: Upon synchronization, the core will provide information on the available project type, framework, page and feature templates.
• Generate using Templates: Using the available templates, the core does the composition, generation and postaction execution to create a C# or VB Project.
• Telemetry: Performs the majority of telemetry for Windows Template Studio including user selections and generation time.

Limitations

• Currently .NET Standard does not support Package verification using PackageDigitalSignatureManager. This functionality was moved to the Utilities project (.NET framework) to be consumed from Windows Template Studio. The CLI (.NET Core 3.1) does not allow to download template packages from the CDN due to this limitation. Tracking issue for adding this in once it is supported is issue #131.

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.

This project is a shared project and will change based on the needs of WindowsTemplateStudio and WebTemplateStudio. You can check out WindowsTemplateStudio's roadmap for more information. We're still working on a roadmap for WebTemplateStudio.

Reporting Security Issues

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) at secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.

Contributing

Do you want to contribute? We would love to have you help out. Here are our contribution guidelines.

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

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.