Skip to main content

Getting Started


This documentation site makes a lot of use of CodeSandbox TypeScript examples, where you can use the Rimbu library live in a browser environment. Try it out to quickly browse through many examples:

Open file below in new window with full type-check



To install the library in your own project:

npm install @rimbu/core


yarn add @rimbu/core

Import into and use immutable goodness in your code:

import { List, Stream } from '@rimbu/core';

const list = List.from(Stream.range({ start: 2, amount: 64 }));


For Deno, the following approach is recommended:

In the root folder of your project, create or edit a file called import_map.json with the following contents (where you should replace x.y.z with the desired version of Rimbu):

"imports": {
"@rimbu/": ""

Note: The trailing slashes are important!

In this way you can use relative imports from Rimbu in your code, like so:

import { List } from '@rimbu/core/mod.ts';
import { HashMap } from '@rimbu/hashed/mod.ts';

Note that for sub-packages, due to conversion limitations it is needed to import the index.ts instead of mod.ts, like so:

import { HashMap } from '@rimbu/hashed/map/index.ts';

To run your script (let's assume the entry point is in src/main.ts):

deno run --import-map import_map.json src/main.ts