# clstr.io

clstr.io is a platform for learning distributed systems and databases through incremental,
project-based challenges. Developers build real distributed systems (consensus-based
stores, leaderless caches, message queues, blockchains, CRDTs) in any language,
verified by behavioral tests that simulate network failures, crashes, and real-world
scenarios.

## Main Pages

- Home: https://clstr.io/
  Project-based learning approach and getting started

- How It Works: https://clstr.io/how-it-works/
  CLI tool, testing system, and workflow explanation

## Guides

- CLI: https://clstr.io/guides/cli/
  Command reference and usage examples

- CI/CD: https://clstr.io/guides/ci-cd/
  Integrating clstr tests into continuous integration pipelines

## Challenges

### Distributed Key-Value Store

https://clstr.io/kv-store/

A challenge building a distributed key-value store with Raft consensus.
Covers HTTP APIs, persistence, replication, leader election, crash recovery,
log compaction, membership changes, and fault tolerance.

## GitHub Repositories

- CLI Tool: https://github.com/clstr-io/clstr
- Documentation/Website: https://github.com/clstr-io/docs