How skearya/wordplay works
Project type and purpose
• This is a full-stack multiplayer word-games platform (“wordplay”) with a SolidJS/TypeScript single-page frontend and a Rust/axum backend. It supports real-time game interactions (via WebSocket), REST endpoints (e.g. auth, info), persistent storage (SQL), and offline prompt generation.
File structure
• Top-level:
• compose.yml, Caddyfile, Dockerfiles – indicates Docker Compose deployment with a reverse proxy (Caddy).
• client/ – SolidJS app built with Vite and Tailwind.
• server/ – Rust service using axum, SQLx (migrations, query files), organizes code into routes, state, utils.
• prompt-gen/ – Rust binary to generate “word bomb” prompts offline.
• stresser/ – TS script to load-test the server via its APIs/WebSockets.
• Key patterns:
• client/src/lib/components – reusable UI, pages, routing.
• server/src/routes + server/src/state – MVC-like separation (handlers vs. in-memory/game state).
• migrations/ + .sqlx – schema & compile-time SQL validation.
README for additional insights
• Features: chat, rate limiting, spectating, game rejoining.
• Tech stack summary: SolidJS, Vite, Rust, axum, Docker Compose.
• prompt-gen is a supporting tool, not in hot path.