Skip to main content

Introducing FluentDynamoDB v0.8.0: Our First Public NuGet Release

· 2 min read
Dan Guisinger
Founder, Oproto Inc.

Today marks an important milestone: FluentDynamoDB is now available on NuGet.

This release represents the first public version of a fully source-generated, strongly-typed, AoT-compatible C# interface for Amazon DynamoDB, designed for production workloads and modern serverless architectures.

What's Included in v0.8.0

This release contains the core functionality of the FluentDynamoDB ecosystem:

  • Strongly-Typed Entities using c# classes decorated with attributes

    • partition & sort keys
    • local & global secondary indexes
    • multi-tenant patterns
    • S3-backed object fields
    • encryption metadata
  • Source-Generated Repositories

    • Fluent, expressive repository types, generated at compile time
    • zero reflection
    • fully AoT compatible
    • ergonomic, type-safe method signatures
  • Fluent Query API

    • EF Core–style fluent queries that translate to DynamoDB requests
  • Geospatial Support (Experimental)

    • GeoHash
    • Google S2
    • Uber H3
  • Stream Processing Framework

    • Typed stream records, Lambda-safe handlers, and event-driven helpers.
  • Thousands of Automated Tests

    • Including unit, integration, and property-based tests across all core packages.

Installing v0.8.0

dotnet add package Oproto.FluentDynamoDB

Why v0.8.0 Is Not "1.0" Yet

Although the API surface is large and stable, there are a few areas we want to refine before the 1.0 release:

  • expand FluentResults coverage across the full API surface
  • add additional configuration and mapping helpers
  • increase test coverage around advanced geospatial and S3-backed fields
  • complete the remaining pieces of field-level encryption
  • improve integration-level and end-to-end documentation
  • possibly consolidate entity attributes to make model definitions less verbose
  • add runtime schema validation against a live DynamoDB table
  • provide CDK integration so FluentDynamoDB entities can define infrastructure

The project is already usable for real workloads, but we want the 1.0 line to have a fully polished developer experience.

What's Next

After our Kiroween hackathon code freeze is lifted, we will be releasing:

  • more documentation
  • real-world sample applications
  • a guide for serverless multi-tenant architectures using FluentDynamoDB
  • bug fixes and new features

This is just the beginning, and we're glad to finally share the work publicly.