Axumlings
Open Source2024

AXUMLINGS

80+ exercises — routing, extractors, middleware, SQLx, Redis, JWT, Prometheus, testing.

80+
Hands-on exercises
19
Curriculum modules
1
Rust CLI runner
SCROLL
Client
Open Source
Domain
Open Source / Education
Platform
CLI
Duration
2024
Core Stack
Rust · Axum · Tokio
The Brief

THE
PROBLEM

Axumlings is a Rustlings-style curriculum for Axum — learners need progressive exercises covering routing, extractors, middleware, SQLx, Redis, JWT, Prometheus, and testing without reading an entire book before writing code.

Rust CLI using crossterm for TUI, notify for file watching, and per-exercise cargo test/clippy invocations with staged unlock order across 19 thematic modules and 80+ exercises.

Core Engineering Challenge

Automated verification must stay fast on laptops, exercises must not flake on OS differences, and the CLI should feel as polished as Rustlings (watch mode, hints, clear failures).

19
Modules
Extended stack
backend
Rust
backend
Axum
CLI
CLI
How we built it

THE ARCHITECTURE

01
Exercise template

Each exercise ships starter code, hidden tests, and metadata for the runner.

RustTesting
02
Watch mode

notify triggers rebuild/test loops on save for tight feedback.

notifyCLI
03
Progressive gates

Unlock order enforces dependencies (e.g., extractors before middleware stacks).

EducationRust
04
Tooling integration

clippy and rustfmt hooks teach idiomatic style alongside correctness.

ClippyCargo
05
Docs & hints

Inline comments link to Axum docs for self-serve depth.

AxumDocs
System Data Flow
Ingestion
CrawlerContent Hash10K+ pages
Processing
ChunkerDeduplicatorEmbedding API
Storage
pgvectorPostgreSQLRedis Cache
Auth
Identity ProviderJWT BridgeSessions
Query
HNSW SearchRe-rankerLLM Stream
Delivery
Web AppMobile AppUsers
What we delivered

THE RESULTS

19

Structured coverage from basic handlers through auth, observability, and integration tests — enough breadth that learners exit with a mental map of production Axum apps, not just hello-world routes.

19
Modules

Structured coverage from basic handlers through auth, observability, and integration tests — enough breadth that learners exit with a mental map of production Axum apps, not just hello-world routes.

Engineering decisions

TECH
DEEP DIVE

CLI
Rust-native runner

cargo test per exercise reuses learners’ existing toolchain — no custom interpreter.

crossterm kept TUI dependencies lighter than full GUI frameworks.

MOD
19 modules

Thematic grouping beats one flat directory when onboarding mid-level devs from other web stacks.

Watch mode mimicked Rustlings muscle memory, lowering adoption friction.

Next Case Study
Blockchain
TronNFTMarketplace

TRC-721 & auctions

TronNext.jsMongoDB
Start a project

LET'S
BUILD
SOMETHING.

We take on a small number of projects at a time. If the problem is hard, we're interested.

Email
hello@techmusketeers.com
Response time
Within 24 hours
Availability
Open for new projects · 2025