Create and debug a personal tab across Microsoft 365 - OfficeDev/TeamsFx GitHub Wiki
Important
Content in this document has been moved to Teams platform documentation. Please do not refer to or update this document.
Personal tabs provide a great way to enhance the Microsoft Teams experience. Using personal tabs, you can provide a user access to their application right within Teams, without the user having to leave the experience or sign in again. Now, personal tabs can light up within other Microsoft 365 applications. You can build and run your personal tabs in Teams, both Outlook desktop and web experiences, and also Office on the web (office.com).
- NodeJS
- An M365 account. If you do not have M365 account, apply one from M365 developer program
- Set up your dev environment for extending Teams apps across Microsoft 365
Please note that after you enrolled your developer tenant in Office 365 Target Release, it may take couple days for the enrollment to take effect.
- From Visual Studio Code, open the command palette (
Ctrl+Shift+P
), typeTeams: Create a new Teams app
- Select SSO-enabled personal tab
Follow below instructions to get started with this application template for local debugging.
- Press
F5
or use theRun and Debug Activity Panel
in Visual Studio Code. - Select a target Microsoft 365 application where the personal tabs can run:
Debug in Teams
,Debug in Outlook
orDebug in Office
and click theRun and Debug
green arrow button. - If you select
Debug in Outlook
orDebug in Office
, follow the instructions in a Visual Studio Code pop-up dialog. - Click Install in Teams first and install the app in a Teams web client.
- After installing the app in Teams, come back and click Continue to continue to debug the app in Outlook web client or office.com.
- Start debugging the project by executing the command
teamsfx preview --local --m365-host <m365-host>
in your project directory, where options form365-host
areteams
,outlook
oroffice
. - If you select
Debug in Outlook
orDebug in Office
, follow the instructions in the command dialog. - Select Install in Teams first and install the app in a Teams web client.
- After installing the app in Teams, come back and select Continue to continue to debug the app in Outlook web client or office.com.