Slothful CRUD helps you generate CRUD API endpoints for your entities with minimal setup.
Implement ISlothfulEntity, register the library, and expose REST endpoints backed by your DbContext.

Full documentation is available at slothful.dev.

1. Install package:

dotnet add package slothful-crud

2. Register services and endpoint generation:

using SlothfulCrud.Extensions;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDbContext<SlothfulDbContext>(options =>
    options.UseInMemoryDatabase("AppDb"));
builder.Services.AddSlothfulCrud<SlothfulDbContext, Program>();

var app = builder.Build();
app.UseSlothfulCrud<SlothfulDbContext, Program>();

app.Run();

The Program type parameter serves as an assembly marker for entity discovery. You can use any type from the assembly containing your entities.

3. Implement ISlothfulEntity on your domain type:

using SlothfulCrud.Domain;

public class Sloth : ISlothfulEntity
{
    public Guid Id { get; private set; }
    public string Name { get; private set; }
    public int Age { get; private set; }
    public string DisplayName => Name;

    public Sloth(Guid id, string name, int age)
    {
        Id = id;
        Name = name;
        Age = age;
    }

    public void Update(string name, int age)
    {
        Name = name;
        Age = age;
    }
}

By default, the following endpoints are generated per entity:

• GET /{segment}/{id} - details
• GET /{segment}/list/{page} - browse
• GET /{segment}/selectable-list/{page} - browse selectable
• POST /{segment} - create
• PUT /{segment}/{id} - update
• DELETE /{segment}/{id} - delete

• POST create request body does not include id; the key is generated server-side.
• 201 Created includes Location: /{segment}/{id} and uses IApiSegmentProvider.
• Validation is enabled by default (HasValidation = true). Register validators, e.g.:

builder.Services.AddValidatorsFromAssemblyContaining<YourValidator>();

• Endpoint segment strategy (IApiSegmentProvider)
• Key generation strategy (IEntityPropertyKeyValueProvider<TEntity>)
• Create constructor selection (ICreateConstructorBehavior)
• Entity and endpoint configuration (ISlothEntityConfiguration<T>)
• Problem handling (UseSlothfulProblemHandling)
• Query customization (QueryCustomizer in SlothfulOptions)

BenchmarkDotNet benchmarks are included to track performance regressions and compare internal changes.

Run all benchmarks:

dotnet run -c Release --project library/SlothfulCrud/Tests/SlothfulCrud.Benchmarks -- --filter "*"

Results are exported to:

library/SlothfulCrud/Tests/SlothfulCrud.Benchmarks/BenchmarkDotNet.Artifacts/results/

See details in docs:

• Quick start
• Endpoints
• Entity configuration
• Validators
• Problem handling
• Advanced topics

• NuGet: slothful-crud
• License: MIT