Home

FileHub

A .NET storage abstraction. One API across local disk, in-memory, and cloud object storage — swap the driver, keep the code.

var hub = new LocalFileHub(@"C:\data");
hub.Root.CreateFile("hello.txt").SetText("hi");

Start here

• Quick Start — install and basic usage in 5 minutes.
• API reference — every type and method in one page.
• Migrating to 2.0 — breaking changes from 1.x and how to update.

Drivers

• Local (disk) — System.IO.File, sandboxed to a root.
• Memory (in-process) — zero-disk, zero-setup. Great for tests.
• Amazon S3 — AWS S3 General Purpose buckets with lazy stubs and single-PUT writes.
• Oracle Object Storage — cost-optimised OCI driver.
• FTP — plain FTP server via FluentFTP.

Topics

• Usage patterns — sync/async pairing, streams, pagination.
• Security — sandbox guarantees and read-only mode.
• Dependency injection — AddFileHub, named hubs, tenant scoping.
• Custom drivers — plug in a new backend.
• Testing — swap in MemoryFileHub for zero-disk tests.