Document storage and indexed queries for Java.

Use the Java library from Maven Central or the TypeScript package with Node.js and Cloudflare Workers.

R2D1 combines one DocumentStore with one IndexStore. Select one backend from each column, follow its setup guide, and then use the shared collection API.

Once the two backends are configured, every pairing uses the same annotations, collection lifecycle, mutation methods, and indexed query builder.

@Document("users")
record User(@Id String id, @Index String country, @Index long score) {}

R2D1 database = R2D1.builder()
    .collectionFactory(new PersistenceCollectionFactory(
        documentStore, indexStore, documentCodec, indexStore::initialize))
    .build();

R2D1Collection<User> users = database.collection(User.class);
users.put(new User("user-123", "NZ", 42));

Page<User> page = users.query()
    .where("country").eq("NZ")
    .sortBy("score", SortDirection.DESC)
    .limit(20)
    .fetch();

The complete setup, adapter choices, and lifecycle rules are covered in Getting Started.

R2D1 1.8.0 includes the Quarkus extension alongside the core API, storage adapters, Micronaut, and Spring Boot integrations.