6. App Templates

Updating the app template catalog

The App Template Catalog is alphabetized collection of production-ready apps for Microsoft Teams that are community driven, open-source, and available on GitHub. Each entry contains the template name (including a star if it is new), a brief description, a link to the code in the GitHub repo, and a supporting image.

Prerequisites

1. Sign up for a GitHub account if you do not have one.

2. Provide your GitHub ID to Doc PM (surbhigupta@microsoft.com) to be added as a contributor to the msteams-docs repository.

   You will receive an invite on your registered email ID.

Adding images for App Catalog change

1. Go to the msteams-docs repository.

2. Navigate to msteams-docs/msteams-platform/assets/images/.

3. Select the Add file drop-down.

4. Add your image files.

   Note

   Ensure that the naming convention is followed and the images are of high resolution.

5. Scroll to the bottom of the page to the Commit changes section and enter the following:

   1. The file name is added by default.

   2. Add a description in the description box. For example, adding the Ask Away template.

6. Select Create a new branch for this commit and start a pull request.

7. Select Propose changes.

   Open a pull request page appears.

8. Enter the details under the **Write **tab.

9. Add **surbhigupta12 **as a reviewer.

10. Select **Create pull request.

    The doc team will receive a notification and review your PR.

Updating the App Catalog file

1. Go to Microsoft Teams app templates - Teams | Microsoft Docs.

2. Select Edit. The app-templates.md file opens in GitHub.

3. Select Edit.

4. Update the catalog information under the Edit file tab.

   Note Ensure that you:

   • Follow Markdown conventions. For more information, see [Markdown reference for docs.microsoft.com - Contributor Guide | Microsoft Docs] (https://docs.microsoft.com/en-us/contribute/markdown-reference)
   • Add a star (Markdown tag: &#9734) adjacent to the name if it is a new template.

5. After you make the changes, ensure that you verify the updates under the Preview Changes tab.

6. Scroll to the bottom of the page to the **Commit changes **section and enter the following:

   1. File name is added by default.
   2. Add a description in the description box, for example, added the Ask Away template.

7. Select Create a new branch for this commit and start a pull request.

8. Select Propose changes.

   Open a pull request page appears.

9. Enter the details under the **Write **tab.

10. Add **surbhigupta12 **as a reviewer.

11. Select Create pull request.

    The doc team will receive a notification and review your PR.