A Bentley Systems internal React UI library.
Copyright © Bentley Systems, Incorporated. All rights reserved. See LICENSE.md for license terms and full copyright notice.
iTwin.js is an open source platform for creating, querying, modifying, and displaying Infrastructure Digital Twins. The goal of AppUI is to provide easy to use, flexible UI components for the iTwin.js platform.
This repository is a monorepo that holds the source code to multiple iTwin.js AppUI npm packages. It is built using Rush.
See rush.json for the complete list of packages.
Each package has its own node_modules directory that contains symbolic links to common dependencies managed by Rush.
- Git
- Node: an installation of the latest security patch of Node 18. The Node installation also includes the npm package manager.
- Rush: to install
npm install -g @microsoft/rush - TypeScript: this is listed as a devDependency, so if you're building it from source, you will get it with
rush install. - Visual Studio Code: an optional dependency, but the repository structure is optimized for its use
See supported platforms for further information.
- Clone repository (first time) with
git cloneor pull updates to the repository (subsequent times) withgit pull - Install dependencies:
rush install - Clean:
rush clean - Rebuild source:
rush rebuild - Run tests:
rush cover
The -v option for rush is short for --verbose which results in a more verbose command.
The above commands iterate and perform their action against each package in the monorepo.
For incremental builds, the rush build command can be used to only build packages that have changes versus rush rebuild which always rebuilds all packages.
Note: It is a good idea to
rush installafter eachgit pullas dependencies may have changed.
If you have questions, comments, or wish to contribute to iTwin.js, see our Contributing guide.