CouchWeave

Spring Data meets CouchDB

Familiar repositories. Native CouchDB behavior.

CouchWeave is building a current Spring Data store module for CouchDB—one that respects revisions, Mango queries, bookmarks, indexes, and partial bulk outcomes.

The intended fit

A Spring-shaped API with CouchDB-shaped behavior.

01

Repository-first

A Spring Data programming model for CRUD, derived queries, sorting, and datastore-aware continuation.

02

CouchDB-honest

Revisions, conflicts, bookmarks, index constraints, and per-document outcomes remain explicit.

03

Built for current Spring

Current Spring Data extension points, clean Boot integration, and a published compatibility matrix.

Design principles

Correctness lives in the boundaries.

CouchWeave should be familiar where Spring Data and CouchDB agree—and explicit where they do not.

Preserve semantics

Do not make CouchDB behave like a relational database when correctness depends on the difference.

Fail clearly

Reject Spring Data operations that cannot be represented faithfully instead of approximating them silently.

Test the real system

Verify repository behavior against supported CouchDB versions, not only mocks or protocol fixtures.

Planned modules

A small surface with clear responsibilities.

The exact module structure will be proven by the first implementation milestone.

couchweave-core

Mapping, operations, repositories, and query translation.

couchweave-spring-boot

Conditional auto-configuration and configuration properties.

couchweave-spring-boot-starter

The opinionated dependency entry point for Boot applications.

Follow the design as it becomes code

The contracts come before the convenience.

See what CouchWeave is defining now, or follow the repository as the first implementation takes shape.