hovding / generator-teams

A Yeoman Generator for Microsoft Teams

generator-teams

A Yeoman Generator for Microsoft Teams Apps created by Wictor Wilén.

Generates a Microsoft Teams App that can be used to add Tabs, Bots, and more to Microsoft Teams based on Node.js and TypeScript. Optionally it adds support for hosting using Express.

For more information on how Tabs and Bots can be used with Teams see the Teams Developer Documentation

Note: The generator has been renamed from generator-teams-tab to generator-teams. Old package will be marked as deprecated.

How to

Install generator

All Yeoman generators should be installed as global modules. The generator is published to the npm registry and can be installed and downloaded using this command.

npm install generator-teams --global

If you don't have Yeoman installed it has to be installed as well:

npm install yo --global

Install the preview generator

To install the preview version of the Teams generator, use the preview tag:

npm install generator-teams@preview --global

Use the generator

To create a new project using the generator, execute the following command in the command prompt and answer the questions asked.

yo teams

Note: Files are created in the directory that you run the command from hence make sure you are happy with the location before you hit enter.

Build the generator

In order to build the generator you need to install the Webpack as a global node module:

npm install webpack --global

You need to clone the repository or download a local copy and in the source folder install the node modules:

npm install

The generator is built and packaged using Webpack.

webpack

The bundled generator and the template files will end up in the ./generators/ folder.

Use it in dev mode

In the generator-teams directory use the following command, this will link the local copy of the folder as a global node module.

npm link

To revert the link operation:

npm unlink

Credits

• Bill Bliss - Teams support and awesome pull requests and commits
• Richard DiZerega - Themes management idea
• Elaine van Bergen - pull requests
• Daniel Laskewitz - pull requests

Contributing

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.