Skip to content
Back to the catalog
Project key-value-dbDatabasesAdvancedComing soon

Build your own key-value database

Build a key-value database from scratch. Implement a storage engine with a write-ahead log, indexes and compaction to understand data persistence.

Build it in your language

The tester treats your program as a black box: any language works. These are just the most convenient ones for this project.

Guide language

The stage guides read in this language. Only languages this project is fully translated into show up here; the interface language does not change.

What this project is about

Project in preparation: we are completing and verifying the implementation path and its tests. The capabilities below describe the project goal; starting the project is not enabled yet.

“The database saves it” is one of those phrases we take for granted. This challenge takes it apart: you'll see exactly the moment a piece of data stops living only in memory and survives a power cut.

You'll build an LSM-style storage engine: writes to the log, an in-memory memtable, flushes to sorted files, indexes to read quickly, and compaction so the disk doesn't grow forever. And you'll subject it to brutal crashes to confirm it recovers.

Roadmap

14 stages across 4 phases. Every stage comes with its guide and its tests: you move on when they pass.

  1. Phase 14 stages

    Store and retrieve

    In-memory API, write-ahead log, and recovery by replaying the log at startup.

  2. Phase 24 stages

    Down to disk

    Memtable, flushes to immutable sorted files, and merged reads.

  3. Phase 33 stages

    Reading fast

    Sparse index, Bloom filters and range scans.

  4. Phase 43 stages

    Not growing forever

    Levelled compaction, deletes with tombstones, and measuring the cost.

Before you start

An embedded key-value storage engine with a get/put/delete/scan API: a write-ahead log for durability, a sorted memtable, immutable on-disk files with a sparse index, Bloom filters to skip reads, and background compaction.

  • vector-search-engine
    Coming soon

    Build your own vector search engine

    Build a vector search engine from scratch. Create a vector index with exact search, filters and a simplified HNSW graph for approximate search.

    Advanced5 stages~18 hDatabases
    vectorsapproximate searchHNSW+1

    TypeScript · Python · Go

  • redis
    Coming soon

    Build your own Redis

    Build a Redis-compatible server from scratch. Implement RESP, an event loop and key expiry, then connect with the official redis-cli.

    Intermediate10 stages~14 hDatabases
    RESPTCPevents+1

    Go · Rust · Python

  • sqlite-reader
    Coming soon

    Build your own SQLite reader

    Build a SQLite reader from scratch. Open a real database file, walk its B-trees and run SELECT queries by decoding the documented binary format.

    Advanced10 stages~15 hDatabases
    binary formatB-treeSQL

    Go · Python · Java