Today, we’re excited to announce the first release of a series of previews for the Microsoft Graph Toolkit towards our v3.0 release.  With this preview release, you will now be able to leverage new scenarios like selecting an item from a collection of entities, toggle between light and dark mode, switch between multiple logged in account and send chat messages in the context of your apps! Your apps will now look more familiar with other Microsoft 365 apps and will look great when used in all our different canvas (Teams, Outlook, Office.com, SharePoint, etc.).

We introduced Microsoft Graph Toolkit in September 2019, and since then, we’ve seen incredible adoption and an amazing response from the developer community and our partners. Our team has been hard at work taking the feedback and requests we’ve received and turning them into the exciting new features we’re starting to share with you today.

If you are new to the Microsoft Graph Toolkit, it is a collection of reusable, framework-agnostic components and authentication providers for accessing and working with Microsoft Graph. The components are fully functional, customizable, and work with any web framework and on all modern browsers. You can learn more by reading our documentation or by trying one of our getting started guides.

Updating your applications

To update your application to use the newest version of Microsoft Graph Toolkit, navigate to your project directory and run:

https://gist.github.com/sebastienlevert/402c3c6b5a4262d9969c3cce08e48514

If you’re using the toolkit via mgt-loader, update your script tag to:

https://gist.github.com/sebastienlevert/e4c0554104c56ab2feb82e7e60d5a219

This update includes breaking changes that may impact your application, such as deprecation of properties, use of the embedded Microsoft Graph client and naming updates to CSS custom properties. Please go to our release notes to see a detailed list of the changes.

What’s new in 3.0?

Infrastructure updates

We updated the Microsoft Graph JavaSscript SDK to the version 3 to benefit from all the latest capabilities including support for large files uploads and better error handling. While making this change, we also enabled leveraging the Toolkit in sovereign clouds.

Major styling updates

To leverage the main design language from Microsoft called Fluent UI, we are now fully embracing its implementation in web components. Your applications will feel a lot more connected when embedded in one of the different M365 canvas! We are updating all our components to leverage these theming capabilities.

Improved SharePoint Framework development experience

In the past, if you wanted to build SharePoint Framework (SPFx) apps, you had to deploy a common library component providing a single instance of the Toolkit for all web parts in the tenant. This was cumbersome, easily missed and was not providing a great experience for applications acquired through the store. Thanks to our disambiguation features, we now allow developers to define prefixes to their components to avoid any naming collisions in shared environments like SharePoint pages. Disambiguation is intended to provide developers with a mechanism to use a specific version of the Toolkit in their solution without encountering collisions with other solutions that may be using the Toolkit.

New scenarios

Select an item from a collection of entities

As part of v3.0, we are adding a new mgt-picker component, allowing generic selection of Microsoft Graph entities from collections. It’s intended to be used to select an item from a list of items, for example a task list from the user’s task lists, a user from its direct reports, a list from a site, etc.

Easily switch between light and dark mode

To simplify switching from one theme to the next, we are introducing a mgt-theme-toggle component. This component can be used to change the theme experience from light to dark mode (and vice versa). You can also use our internal utilities to invoke the same using your custom code.

Improved scenarios

Seamlessly switch between accounts

We’ve heard from many of our partners and customers that offering a mechanism to allow multiple users connected at the same with the opportunity to switch from on to the other was key to a great experience. We’re now bringing multi-account support to our mgt-login component in this version!

Send messages while staying in-context

We had a basic messaging feature in our mgt-person-card and wanted to bring a fully featured message box that allows users to send quick messages to others while staying in the flow of their work. We are introducing this new quick chat message in this preview version.

Bug Fixes and Improvements

This update also includes a plethora of bug fixes and improvements that aren’t specifically highlighted in this post. To see the full list, check out our release notes.

Known Issues

In this version, we have list of known issues that we think you should be aware of. You can see them directly in our repo and it will get updated while we find other issues based on customer feedback

Try it now

We’re excited about this new version and can’t wait for you to try it out. We’re looking forward to hearing from you about these improvements and how we can continue to make the Microsoft Graph Toolkit even better.

Visit the Microsoft Graph Dev Center | APIs and app development for more resources. Follow us @Microsoft365Dev)/Twitter to stay up to date on news and announcements.