Neo4j Aspire Integration (Unofficial)

This repository provides unofficial Neo4j integrations for .NET Aspire.

Packages

Package	Version	Downloads
NorthernNerds.Aspire.Neo4j
NorthernNerds.Aspire.Hosting.Neo4j

Getting Started

Installation

# Install both packages
dotnet add package NorthernNerds.Aspire.Hosting.Neo4j
dotnet add package NorthernNerds.Aspire.Neo4j

Usage

In your AppHost project:

using NorthernNerds.Aspire.Hosting.Neo4j;

var builder = DistributedApplication.CreateBuilder(args);
var neo4jDb = builder.AddNeo4j("graph-db", neo4jUser, neo4jPass);

In your service projects:

using NorthernNerds.Aspire.Neo4j;

var builder = WebApplication.CreateBuilder(args);
builder.AddNeo4jClient("graph-db");

For more details, check the:

Documentation

Release Guide: Instructions on how to release a new version of the package.

Contributing

Contributions are welcome! Please see the CONTRIBUTING.md for details on how to contribute.

License

This project is licensed under the MIT License.

About Northern Nerds

Northern Nerds is a one-man freelance software company dedicated to creating high-quality software solutions and tools. Follow our work to stay updated on the latest projects and contributions.

Release notes

3.1.0 (since v3.0.0)

NorthernNerds.Aspire.Neo4j (Client)

Updated for the .NET Aspire 13.4 release
Removed the unused OpenTelemetry.Extensions.Hosting dependency

NorthernNerds.Aspire.Hosting.Neo4j (Hosting)

Updated to .NET Aspire 13.4
Added an HTTP health check on the Neo4j endpoint so WaitFor(...) waits for real readiness
Added WithDataVolume and WithDataBindMount for data persistence (mounts /data)
Added argument guard clauses to AddNeo4j
Bumped the Neo4j container image to the 5.26 LTS

Thanks to @joshmakestuff for this contribution! (#7)

Example app

Added an interactive Movies sample (/movies) demonstrating cast/director queries and a "six degrees of co-stars" shortest-path search, replacing the old trivial demo as the featured example

Thanks again to @joshmakestuff for this contribution! (#8)

3.0.0 (since v2.0.0)