CloudStorageORM Documentation
An Entity Framework-style ORM provider for .NET that persists entities into cloud object storage.
🚀 Get started in 5 minutes
Spin up a working example with Azure Blob Storage or AWS S3 in just a few lines of C#.
📚 Documentation sections
For developers
- Getting started — Setup, first entity, basic operations
- Configuration — Connect to Azure or AWS, tune options
- Query patterns — LINQ queries, filtering, range queries
- Transactions — Durable transactions with recovery
- Concurrency — Optimistic locking with ETags
- Provider guides — Azure Blob Storage and AWS S3 details
For contributors & operators
- Library documentation — Architecture, public APIs, project structure
- Sample application — End-to-end CRUD example
- Testing with Azurite — Local Azure testing
- Testing with LocalStack — Local AWS testing
- CI workflow — Build, test, and deployment pipeline
- API reference — Auto-generated API docs
✅ Current status
| Aspect | Status | Details |
|---|---|---|
| Azure Blob Storage | ✅ Production-ready | Full CRUD, transactions, concurrency |
| AWS S3 | ✅ Production-ready | Full CRUD, transactions, concurrency |
| Google Cloud Storage | 🚧 Planned (v1.3.0) | Coming soon |
| .NET version | ✅ .NET 10 | net10.0 target |
| Package | ✅ NuGet | CloudStorageORM |
🔗 Quick links
🤝 Contributing
See CONTRIBUTING.md for contribution guidelines and development setup.
📜 License
GNU General Public License v3.0 (GPL-3.0-or-later). See LICENSE for details.