// Provides tech stack, package layout, conventions, and build commands for the iTwin/presentation monorepo. Use when: working on any package or app in this repo, planning changes, implementing features, reviewing code.
| name | repo-context |
| description | Provides tech stack, package layout, conventions, and build commands for the iTwin/presentation monorepo. Use when: working on any package or app in this repo, planning changes, implementing features, reviewing code. |
This is a pnpm monorepo orchestrated with Lage and versioned with Changesets.
| Area | Technology |
|---|---|
| Language | TypeScript (strict, ES2022, dual CJS/ESM builds) |
| UI | React 18, iTwinUI components, SCSS |
| Testing | Vitest |
| Linting | ESLint 9 (flat config), oxfmt for formatting |
| Platform | iTwin.js (iModels, ECSQL, Presentation APIs) |
| Reactive | RxJS |
| API docs | @itwin/build-tools (extract-api, docs) |
| Node | ^24, pnpm 10 |
| Package | Path | Purpose |
|---|---|---|
@itwin/presentation-shared | packages/shared | Shared utilities and types |
@itwin/presentation-core-interop | packages/core-interop | Interop layer with iTwin.js Core |
@itwin/presentation-hierarchies | packages/hierarchies | Hierarchy building from iModels and other sources |
@itwin/presentation-hierarchies-react | packages/hierarchies-react | React bindings for hierarchies |
@itwin/presentation-components | packages/components | React components (lists, property grids, tables) |
@itwin/unified-selection | packages/unified-selection | Unified selection storage |
@itwin/unified-selection-react | packages/unified-selection-react | React bindings for unified selection |
@itwin/presentation-opentelemetry | packages/opentelemetry | OpenTelemetry diagnostics integration |
@itwin/presentation-models-tree | packages/models-tree | Models tree widget for internal testing |
@itwin/presentation-test-utilities | packages/test-utilities | Internal test utilities |
| App | Path | Purpose |
|---|---|---|
full-stack-tests | apps/full-stack-tests | Integration tests |
test-app | apps/test-app | Sample app (frontend + backend) |
performance-tests | apps/performance-tests | Benchmarks for hierarchies and unified selection |
load-tests | apps/load-tests | Load testing |
tsconfig.cjs.json / tsconfig.esm.jsonextract-api and .api.md report files in api/ folderscopyrightLinter.js):
/*---------------------------------------------------------------------------------------------
* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
* See LICENSE.md in the project root for license terms and full copyright notice.
*--------------------------------------------------------------------------------------------*/
pnpm change)lage build, dependencies via ^build)| Scope | Build | Test | Lint | Format |
|---|---|---|---|---|
| All (repo root) | pnpm build:all | pnpm cover:all | pnpm lint:all | pnpm format |
| Single package | pnpm build | pnpm test | pnpm lint | pnpm -w exec oxfmt --check . |
| Scoped build | pnpm lage build --to <package> | โ | โ | โ |
| Format fix | pnpm format:fix | โ | โ | โ |