Learning

Documentation Overview

This website is organized into sections by tabs at the top of each page.

Please read the Getting Started page to install prerequisites for developers and for suggestions for background reading.
The BIS tab explains the Base Infrastructure Schemas. Understanding BIS is essential to making sense of the iModel.js apis. Depending on your familiarity with database design, this is often the best starting point for understanding iModels and iModel.js.
The Learning tab (this page) introduces the building blocks of iModel.js and provides step-by-step instructions for creating applications.
The API Reference tab explains the API in more detail with package/class/function level documentation.

Using iModel.js

The iModel.js library has a comprehensive set of APIs that can be used anywhere an iModel may be relevant. It is designed to be modular and extensible, with the expectation that iModel.js will be used in environments with many other JavaScript frameworks. iModel.js strives to be as consistent as possible with established JavaScript conventions, though sometimes judgement calls are required where no established convention is clear.

With the iModel.js Software architecture, from the same JavaScript codebase, it is possible to create:

Agents and Services that process iModels and respond to events from iModelHub
Web Apps that run in web browsers and communicate with backends
Desktop Apps that run on personal computers
Mobile Apps that run on tablets and phones

iModel.js vs. iModelHub

It is important to understand that iModel.js applications do not run on iModelHub. Instead, they can run anywhere else. iModel.js applications always work on a copy of an iModel in a briefcase, obtained from iModelHub, and process it locally, making them infinitely scalable.

iModel.js applications can be:

hosted on any cloud service
deployed using any cloud deployment model
packaged with any container tool (e.g. Docker)
managed with any orchestration system (e.g. Kubernetes)
installed on desktops and mobile devices

JavaScript vs. TypeScript

iModel.js is written in TypeScript. Even though it can be consumed in a JavaScript application, it is highly recommended that iModel.js application developers use TypeScript too when possible. Throughout the iModel.js library, the arguments and return values of functions are decorated with their expected types in TypeScript. The TypeScript compiler will verify the types of callers. Runtime checks to enforce correct types are not encouraged inside iModel.js, given they add overhead and are not necessary for TypeScript callers. Therefore, pure JavaScript consumers of iModel.js must be careful to not pass incorrect types.

JavaScript Version Requirements

The iModel.js library requires a JavaScript engine with es2017 support.

Helpful articles

Step by step instructions to:

Tutorials:

ECSQL Tutorial