neo4j.repository — Generic repository pattern for Neo4j

A repository pattern implementation for Neo4j graph databases in .NET, enabling easy CRUD operations, relationship management and search functionality — so your graph data access stays clean, reusable and testable.

Packages

Ambystech.Neo4j.Repository — main repository implementation
Ambystech.Neo4j.Repository.Contracts — base contracts and attributes

dotnet add package Ambystech.Neo4j.Repository
dotnet add package Ambystech.Neo4j.Repository.Contracts

Quick start

Configure your Neo4j connection in appsettings.json or user secrets:

{
  "Neo4j-Uri": "bolt://localhost:7687",
  "Neo4j-User": "neo4j",
  "Neo4j-Password": "password"
}

builder.Services.AddNeo4jRepository();
builder.Services.AddSingleton<INodeConverter<YourEntity>, YourEntityConverter>();
builder.Services.AddScoped<IBaseGraphRepository<YourEntity>, YourEntityRepository>();

Then use the repository:

var repository = serviceProvider.GetRequiredService<IBaseGraphRepository<YourEntity>>();
var entities = await repository.GetAllAsync();

Features

Generic CRUD operations
Relationship management
Search and filtering
Soft delete support
Automatic relationship loading

Example

The repository ships with a complete working example — a social network graph with Users, Posts, Likes and Dislikes — in the example/ directory.