New Motoko Base Library

Work in progress! Please consider providing feedback on the GitHub discussions page.

✨ Documentation preview

---

This repository contains the source code for a revamped Motoko base library.

If you are new to Motoko, the original base library is available here.

Quick Start

A preview of the new base library is available via the new-base Mops package.

You can quickly try out the new base library by making the following change to your mops.toml config file:

base = "https://github.com/dfinity/new-motoko-base"

It's also possible to start using both versions in parallel:

base = "0.14.2"
new-base = "0.2.1"

Since this is a preview release for community feedback, expect breaking changes. Please report any bugs or inconsistencies by opening a GitHub issue.

Local Environment

Run the following commands to configure your local development branch:

# First-time setup
git clone https://github.com/dfinity/new-motoko-base
cd new-motoko-base
npm ci

# Run code formatter
npm run format

Documentation

It's possible to generate a documentation preview by running the following command:

npm run docs

We automatically generate previews for each pull request.

Contributing

PRs are welcome! Please check out the contributor guidelines for more information.

Big thanks to the following community contributors:

• Timo Hanke: vector, prng
• Byron Becker: StableHeapBTreeMap
• Zen Voich: test