Skip to content

jamesgober/dotnet-collection

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 

Repository files navigation

JG .NET Library Collection

A set of production-ready .NET 8 libraries and frameworks built for real-world services. Each package handles one concern, works independently, and integrates cleanly with the others through standard dependency injection.


Core Libraries

The foundation. Each library handles one infrastructure concern.

Package Description Version Downloads
JG.ConfigKit Configuration from JSON, env vars, CLI, secrets. Typed binding, validation, hot-reload. NuGet Downloads
JG.ErrorKit Structured errors, error codes, context chains, RFC 7807 Problem Details. NuGet Downloads
JG.LoggingKit Structured logging, correlation IDs, JSON/console formatters, file rotation. NuGet Downloads
JG.CacheKit In-memory and Redis caching. Stampede protection, tag-based invalidation. NuGet Downloads
JG.RateLimiter Token bucket, sliding window, fixed window. Per-client and per-endpoint. NuGet Downloads
JG.HealthKit Liveness and readiness probes. Database, HTTP, disk, memory checks. NuGet Downloads
JG.AuthKit JWT issuing, refresh rotation, role-based access control, claims policies. NuGet Downloads
JG.EventKit In-process event bus. Typed publish/subscribe, priority ordering, error isolation. NuGet Downloads
JG.WorkerKit Background jobs. Priority queues, cron scheduling, retry with backoff. NuGet Downloads
JG.AuditKit Immutable audit trails. SHA-256 hash chaining, tamper detection, non-blocking dispatch. NuGet Downloads
JG.TenantKit Multi-tenancy. Resolve from subdomains, headers, routes, query strings, JWT claims. NuGet Downloads

WebKit Framework

The web layer. Router + template engine. See the WebKit Collection for detailed documentation.

Package Description Version Downloads
JG.WebKit.Router Trie-based HTTP router. Compiled execution chains, hot-reload, parameter constraints. NuGet Downloads
JG.WebKit.Views Template engine. Compiled rendering, layouts, partials, loops, asset helpers. NuGet Downloads

Service Template

A ready-to-clone starter project with all core libraries pre-wired. Clone it, rename it, start building.

Project Description
dotnet-service-template Production-ready .NET 8 service template. Config, logging, caching, auth, health checks, rate limiting, events, workers, and audit — all wired and ready.

Products

Product Description
Essence Web application platform built on the full JG ecosystem. Multi-site hosting, plugin system, content management, API services, sub-200ms page loads.

Quick Start

dotnet add package JG.ConfigKit
dotnet add package JG.LoggingKit
dotnet add package JG.CacheKit
# add what you need

Each package registers via standard DI:

builder.Services.AddConfigKit();
builder.Services.AddLoggingKit();
builder.Services.AddCacheKit();

Design Principles

Every library follows the same standards:

  • .NET 8, C# latest, nullable enabled
  • Zero unnecessary external dependencies
  • Source-generated logging (no reflection in hot paths)
  • ConfigureAwait(false) on all internal async calls
  • Sealed internal classes, readonly structs where appropriate
  • Full XML documentation on all public types
  • Apache-2.0 license

Author

James Gober — github.com/jamesgobernuget.org/profiles/jamesgober

About

The JG .NET Library Collection. 11 production-ready NuGet packages for configuration logging caching auth error handling rate limiting health checks events workers audit trails and multi-tenancy.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors