# hive_ce 2.22.0

Hive Community Edition - A spiritual continuation of Hive v2




## Installing
```
export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir
flutter pub add hive_ce
```
Published: 2026-10-14T20:29:29.461834Z
Expected archive SHA-256: 8b6eea82b06a7e2bb298a6a279139c45838b82491a66f3972bf609d48681392a

Available in cache; verification: upstream_checksum
## Direct dependencies
- crypto: ^3.0.0
- isolate_channel: ^0.6.0
- json_annotation: ^4.9.0
- meta: ^1.14.0
- web: >=0.5.0 <2.0.0

## Package README (untrusted upstream documentation)
<p align="center">
  <img src="https://raw.githubusercontent.com/IO-Design-Team/hive_ce/master/.github/logo_transparent.svg?sanitize=true" width="350px">
</p>
<h2 align="center">Fast, Enjoyable & Secure NoSQL Database</h2>

<p align="center">
  <a href="https://github.com/IO-Design-Team/hive_ce/actions/workflows/test.yml"><img src="https://github.com/IO-Design-Team/hive_ce/actions/workflows/test.yml/badge.svg" alt="Dart CI"></a>
  <a href="https://codecov.io/gh/IO-Design-Team/hive_ce"><img src="https://codecov.io/gh/IO-Design-Team/hive_ce/graph/badge.svg?token=ODO2JA4286" alt="codecov"></a>
  <a href="https://pub.dev/packages/hive_ce"><img src="https://img.shields.io/pub/v/hive_ce?label=pub.dev&labelColor=333940&logo=dart" alt="Pub Version"></a>
  <a href="https://github.com/IO-Design-Team/hive_ce/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-BSD_3--Clause-007A88.svg?logo=bsd" alt="License"></a>
</p>

<p align="center">
  <a href="https://pubstats.dev/packages/hive_ce"><img src="https://pubstats.dev/badges/packages/hive_ce/popularity.svg" alt="PubStats Popularity"></a>
  <a href="https://pubstats.dev/packages/hive_ce"><img src="https://pubstats.dev/badges/packages/hive_ce/rank.svg" alt="PubStats Rank"></a>
  <a href="https://pubstats.dev/packages/hive_ce"><img src="https://pubstats.dev/badges/packages/hive_ce/dependents.svg" alt="PubStats Dependents"></a>
</p>

Hive is a lightweight and blazing fast key-value database written in pure Dart. Inspired by [Bitcask](https://en.wikipedia.org/wiki/Bitcask).

### [Documentation & Samples](https://docs.hive.isar.community) 📖

## Features

- 🚀 Cross platform: mobile, desktop, browser
- ⚡ Great performance (see [benchmark](#benchmark))
- ❤️ Simple, powerful, & intuitive API
- 🔒 Strong encryption built in
- 🎈 **NO** native dependencies
- 🔋 Batteries included

## New features in Hive CE

Hive CE is a spiritual continuation of Hive v2 with the following new features:

- Hive CE Inspector DevTools extension
  - Quickly and easily inspect the content of Hive boxes
- Isolate support through `IsolatedHive`
- Flutter web WASM support
- Automatic type adapter generation using the `GenerateAdapters` annotation
  - No more manually adding annotations to every type and field
  - Generate adapters for classes outside the current package
- A `HiveRegistrar` extension that lets you register all your generated adapters in one call
- Extends the maximum type ID from `223` to `65439`
- Support for constructor parameter defaults
- Support for Sets
- A built in Duration adapter
- Freezed support
- Support for generating adapters with classes that use named imports

## Benchmark

This is a comparison of the time to complete a given number of write operations and the resulting database file size:

| Operations | Hive CE Time | IsolatedHive Time | Hive CE Size | Hive v4 Time | Hive v4 Size |
| ---------- | ------------ | ----------------- | ------------ | ------------ | ------------ |
| 10         | 0.00 s       | 0.00 s            | 0.00 MB      | 0.00 s       | 1.00 MB      |
| 100        | 0.00 s       | 0.01 s            | 0.01 MB      | 0.01 s       | 1.00 MB      |
| 1000       | 0.02 s       | 0.03 s            | 0.11 MB      | 0.06 s       | 1.00 MB      |
| 10000      | 0.13 s       | 0.25 s            | 1.10 MB      | 0.64 s       | 5.00 MB      |
| 100000     | 1.40 s       | 2.64 s            | 10.97 MB     | 7.26 s       | 30.00 MB     |
| 1000000    | 19.94 s      | 41.50 s           | 109.67 MB    | 84.87 s      | 290.00 MB    |

Database size in Hive v4 is directly affected by the length of field names in model classes which is not ideal. Also Hive v4 is much slower than Hive CE for large numbers of operations.

IsolatedHive is slower than Hive, but it is much faster than Hive v4 and you still get the benefit of multiple isolate support.

The benchmark was performed on an M3 Max MacBook Pro. You can [see the benchmark code here](https://github.com/IO-Design-Team/hive_ce/blob/main/benchmarks/storage/bin/bench.dart).

## Getting Started

Hive CE requires Dart 3. Ensure that you have the following in your `pubspec.yaml` file:

```yaml
environment:
  sdk: ^3.0.0
```

## Usage

You can use Hive just like a map. Writes are readable immediately, but a write can be lost if the process is killed before its future completes. On the VM, `flush()` waits for pending writes and flushes them to disk.

<!-- embedme readme/usage.dart -->

```dart
import 'package:hive_ce/hive_ce.dart';

void example() {
  final box = Hive.box('myBox');
  box.put('name', 'David');
  final name = box.get('name');
  print('Name: $name');
}

```

## Changelog
## 2.22.0

- Adds `Hive.flush()` and `IsolatedHive.flush()` to flush every open box

## 2.21.0

- `DateTime` and `Duration` now preserve microseconds (by [@LahaLuhem](https://github.com/LahaLuhem) in [#340](https://github.com/IO-Design-Team/hive_ce/issues/340))
- Fixes `List<double>`, `List<bool>`, and `List<String>` reading back as `List<Object?>` on web (by [@LahaLuhem](https://github.com/LahaLuhem) in [#342](https://github.com/IO-Design-Team/hive_ce/issues/342))
- Fixes encoded values not being decoded when reading web boxes in browsers without `IDBObjectStore.getAll`

## 2.20.2

- Fixes `deleteBoxFromDisk` throwing `PathNotFoundException` after a failed `openBox` (by [@lucasiturbide](https://github.com/lucasiturbide) in [#338](https://github.com/IO-Design-Team/hive_ce/issues/338))

## 2.20.1

- Fixes a race where retrying a failed `openBox` could drop the in-flight open (by [@LahaLuhem](https://github.com/LahaLuhem) in [#320](https://github.com/IO-Design-Team/hive_ce/pull/320))
- Opening a box with the wrong cipher now throws instead of wiping the box during crash recovery (by [@LahaLuhem](https://github.com/LahaLuhem) in [#330](https://github.com/IO-Design-Team/hive_ce/pull/330))

## 2.20.0

- IsolatedHive compaction now uses `IsolatedCompactionStrategy`

## 2.19.3

- IsolatedHive: Handles stale send ports on hot restart

## 2.19.2

- Updates `isolate_channel` to `0.6.0`

## 2.19.1

- Updates `isolate_channel` to `0.4.0`

## 2.19.0

- Adds box search to the inspector (by [@ElNgatia](https://github.com/ElNgatia) in [#280](https://github.com/IO-Design-Team/hive_ce/pull/280))

## 2.18.0

- Fixes an issue with IsolatedHive encryption
- Automatically disables the unsafe isolate warning when running in a test

## 2.17.0

- Fixes WASM int decoding (by [@flrnsbt](https://github.com/flrnsbt) in [#262](https://github.com/IO-Design-Team/hive_ce/pull/262))
- Adds nested primitive support to `CollectionBox`
- Adds more options to the logger to ignore specific warnings

## 2.16.0

- Implements a proper logging system
- Adds `hive_ce.dart` to make the publish action happy

## 2.15.1

- Moves most of the documentation to the new [documentation site](https://docs.hive.isar.community)

## 2.15.0

- Adds `ignoredFields` parameter to `AdapterSpec` for excluding specific fields from type adapter generation (by [@rezam92](https://github.com/rezam92) in [#229](https://github.com/IO-Design-Team/hive_ce/pull/229))

## 2.14.0

- Adds the ability to override type adapters by type (by [@sportismygame](https://github.com/sportismygame) in [#217](https://github.com/IO-Design-Team/hive_ce/pull/217))
- Fixes some `Future` handling issues

## 2.13.3

- Adds copy to clipboard functionality to the inspector

## 2.13.2

- Removes the print statement from the inspector

## 2.13.1

- Fixes the first column header not showing in the inspector

## 2.13.0

- Adds the Hive CE Inspector DevTools extension

## 2.12.0

- Notify with the value of a deleted frame instead of `null`
- Improves adapter of same type warning

## 2.11.4

- Handles exception thrown during compaction on some platforms
- Updates documentation for `IsolatedHive`

## 2.11.3

- Prints warning when writing integers greater than 2^53

## 2.11.2

- Fixes web compatibility check
- Fixes `deleteFromDisk` not completing on web

## 2.11.1

- Allows boxes of primitive iterables

## 2.11.0

- Isolate support through `IsolatedHive`
- Warning messages for potentially unsafe isolate usage
- Updates suggested placement of `GenerateAdapters` annotation
- Fixes custom objects in `BoxCollection`. Custom objects must now be json serializable.
- Adds much more information to the unknown typeId error message
- Supports `freezed` default values
- Enforces that boxes of type `Map` _must_ be `Map<dynamic, dynamic>`
- Enforces that boxes of type `Iterable` _must_ be `Iterable<dynamic>`
- Adds `reservedTypeIds` to `GenerateAdapters` annotation

## 2.10.1

- Fixes `HiveObject` disposal in lazy boxes

## 2.10.0

- Raises the maximum type ID from 223 to 65439

## 2.9.0

- Prints a warning when writing `int` or `List<int>` types in a WASM environment
- Only emits print statements when assertions are enabled (aka debug mode)

## 2.8.0+3

- Updates the commit hash for the transitive Hive dependencies workaround

## 2.8.0+2

- Adds workaround for transitive Hive dependencies to README

## 2.8.0+1

- Adds tutorial link to README

## 2.8.0

- Adds `GenerateAdapters` annotation and relevant documentation

## 2.7.0+1

- Adds a storage benchmark to compare Hive CE with Hive v4

## 2.7.0

- No longer reinitializes `Hive` when opening a `BoxCollection`

## 2.6.0

- Adds `TargetKind.parameter` to `HiveField` to support `freezed`

## 2.5.0+2

- Adds documentation for adding new fields (@vizakenjack)
- Updates README badges

## 2.5.0+1

- Documentation updates for `HiveField` in support of `hive_ce_generator` changes

## 2.5.0

- Adds `Target` annotations to `HiveField` and `HiveType` to prevent invalid usage
- Bumps `analyzer` to `^6.5.0` to deal with deprecations
- Bumps `meta` to `^1.14.0` for `TargetKind.enumValue`

## 2.4.4

- Loosens constraint on `web`

## 2.4.3

- Loosens constraint on `meta`

## 2.4.2

- Only shows the adapter with same type warning if the adapters have different type ids

## 2.4.1

- Upgrades `package:web` to `1.0.0`

## 2.4.0+1

- Adds a guide to migrate from `hive`
- Adds documentation for the new `HiveRegistrar` extension created by `hive_ce_generator`

## 2.4.0

- Adds support for Sets
- Adds a built in `DurationAdapter`
- Adds a warning if attempting to register multiple adapters for the same type

## 2.3.0

- The first release of Hive Community Edition
- Supports Flutter web WASM compilation
- Fixes analysis issues