Yomu Documentation

Comprehensive docs for the Yomu polyglot learning platform

Yomu is a full-stack learning platform built with a Java auth and user service, a Rust gamification engine, and a Next.js frontend. Explore the docs to learn about the architecture, development workflow, and deployment pipeline.

Browse Documentation
Spring Boot 4Rust 2024Next.js 16PostgreSQLRedisDockerGitHub Actions

Architecture & System Design

Overview of the Yomu monorepo, service boundaries, and communication patterns between Java, Rust, and Next.js.

Java Backend Service

Auth, users, articles, quizzes, and the outbox pattern. Built with Spring Boot 4 and Java 21.

Rust Gamification Engine

Achievements, missions, daily rewards, clans, and Redis-backed leaderboards. Clean Architecture with Axum 0.8.

Next.js Frontend

BFF proxy pattern, shadcn/ui components, React Server Components, and Zod v4 validation on a Tailwind v4 canvas.

CI/CD Pipeline

Multi-stage Docker builds, PMD linting, JaCoCo coverage, nextest parallel testing, and OWASP dependency checks.

Development Guide

Setup instructions, conventions, API response format, anti-patterns, and how to run the full stack locally.