iTwin.js 3.0 Release Announcement!

[calebmshafer]

We are excited to announce the release of iTwin.js 3.0! This release represents a significant milestone for iTwin.js, including improved visualization, editing capabilities (in Beta), flexibility to add 3rd party Identity Providers (IdPs), and much more... enabling you to build robust and capable digital twin solutions today.

This new release represents a major milestone for the iTwin ecosystem — independent software vendors, in-house developers, and digital twin integrators. It is a substantial release, and we have refactored and improved many aspects of the platform targeted in the v3.0 roadmap. See the Release Notes for more information on the changes in this release. Use the provided upgrade path to make the transition easier for your existing applications.

Goals of the release

We had some high-level objectives guiding the changes made during this release enabling us to provide a strong foundation for the exciting features to come in this 3.x generation.

1. Improve the stability of our core APIs around Web and Desktop visualization.
   • Clean up some of our current APIs and promote others to a public release tag.
2. Set the stage for Editing with an initial API that lays the groundwork for all the enhancements to come.
3. Enhance support for the iTwin platform and provide better flexibility for different client implementations, authorization providers, and workflows.
4. Refactor our iTwin App UI to work more seamlessly with iTwinUI, our open-source design system that helps you build a unified web experience for your users.

What's included?

This major release comprises different pieces including packages being moved to different repositories and renamed. The full guide to the changes and renames are available in release notes.

A few major changes are called out below, as they are not mentioned explicitly in the release notes.

• The previous imodeljs GitHub Organization is being deprecated in favor of the iTwin Organization. Moving forward all active development on iTwin.js will be in the iTwin Org.
• All packages in the iTwin.js 3.0 release, and moving forward, use the @iTwin npm scope instead of @bentley.
• The iTwin platform's iModel Access service, formerly Visualization service, has been updated to support the new version of iTwin Viewer
  • The updated service requires replacing the itwinjs scope with imodelaccess:read scope.
• New client packages for the iModels, Reality Data and Projects iTwin platform APIs are available in the linked repositories. In addition, all of the authorization clients are moved to a new auth-clients repository.
  • With the new iTwin platform APIs the clients are using be sure to add the appropriate new scopes; imodels:read, realitydata:read and projects:read.
• Update viewer components react packages; @itwin/tree-widget-react, @itwin/property-grid-react, and @itwin/measure-tools-react

How do I get started?

If you have an existing application built on iTwin.js 2.x, head over to our release notes and try out our new codemod tool to make migration easy!

If you're just starting with iTwin.js, follow our updated tutorial on developer.bentley.com.