Tutorials
Tutorials are hands-on, scenario-based walkthroughs that take you from an empty project to a working feature, one numbered step at a time. Each one is self-contained: you copy the code as you go, run it, and see the result. They favor a complete, runnable path over exhaustive reference detail, so when you want to understand every option behind a step, follow the links into the developer guide and core concepts at the end of each page.
Most tutorials below run against an in-process store, so you need only the .NET SDK and a text editor to complete them. The same code runs unchanged against a distributed cluster once you switch the store to remote mode. The one exception is the secured-client tutorial, which connects to a running TLS + token-secured cluster.
| Tutorial | What you'll build |
|---|---|
| Your first store and CRUD | A console app that runs an in-process store and performs Put, Get, and Delete with full result handling. |
| Use Zaris as a distributed cache in ASP.NET Core | A web API whose controller caches and reads values through IDistributedCache, backed by Zaris. |
| Coordinate a singleton job with a distributed lock | A background job that runs on only one instance at a time by holding a lease-backed lock. |
| Build a leaderboard with atomic counters | A shared score table that stays correct under concurrent updates using atomic counters. |
| React to changes with watch | A watcher that receives push notifications the moment a key or a group of keys changes. |
| Cache values with a time to live | A self-expiring cache that sets a TTL on write, reads the remaining time, and watches entries vanish when it elapses. |
| Build a rate limiter with a fixed window | A fixed-window rate limiter that caps requests per window using an atomic counter, a per-window key, and a TTL. |
| Transfer between keys with a transaction | An atomic transfer whose two writes commit together or not at all, with conflict detection and retry. |
| Scan keys and query labeled entities | A product catalog you list by key prefix and query by label with filters, ordering, and limits. |
| Secure a .NET client with TLS and a token | A client that connects to a TLS + token-secured store, trusting the cluster CA and presenting a bearer token. |