$ show realworld-apps/realworld
This repository is the central specification and test suite hub for the RealWorld project (a Medium.com clone demo app). It does not contain any runnable application code. Instead, it defines the API contract via an OpenAPI spec (specs/api/openapi.yml), provides comprehensive test suites in Hurl and Bruno formats for backend validation, and a shared Playwright E2E test suite for frontend validation. It also includes a shared CSS theme (assets/theme/styles.css), documentation built with Astro/Starlight (docs/), and SVG logo generation scripts. The repository serves as the single source of truth that all RealWorld implementations (over 100 backends and frontends) must conform to. Its architecture is that of a specification and validation toolkit, not a deployable service. Key entry points are the Makefile for running tests and generating Bruno collections, and the test runner scripts in specs/api/. External dependencies include Hurl, Bruno, Playwright, Bun, and Astro.
The LLM identified 1 files worth highlighting for reuse:
A standalone Bun script that converts Hurl test files (the source-of-truth API tests) into a Bruno collection. It parses Hurl syntax including HTTP requests, headers, JSON bodies, captures, and assertions, then generates the corresponding .bru files with equivalent JavaScript post-response scripts. The script demonstrates non-obvious parsing and transformation skill, handling template variables, JSON path to JS dot-path conversion, and complex assertion logic. It is fully self-contained and can be extracted to convert any Hurl test suite to Bruno format with minimal modification.