README

See how _the exact same_ Medium.com clone is built using different frontends and backends

You can combine any frontend with any backend, because they all adhere to the same API spec

While most "todo" demos provide an excellent cursory glance at a framework's capabilities, they typically don't convey the knowledge required to actually build _real_ applications with it — nor the real-world constraints a minimal demo never has to face.

RealWorld solves this problem by providing the same demo app for each framework, at a sweet spot between simplicity and breadth.

Join us on GitHub Discussions! 🎉

 Implementations

Over 100 implementations have been created using various languages, libraries, and frameworks.

Explore them on CodebaseShow.

 Spec-compliant backends

These backends pass the full API spec test suite:

- Nitro + Prisma + Zod — TypeScript
- Django Ninja — Python

 Create a new implementation

Create a new implementation 

Or you can view upcoming implementations (WIPs).

 Learn more

- Documentation introduction
- Every tutorial is built against the same API spec to ensure modularity of every frontend & backend
- A shared CSS theme is provided to build frontend implementations with identical UI/UX
- A shared E2E test suite is available to validate frontend implementations
- There is a hosted version of the backend API available for public usage at api.realworld.show, no API keys required — demo accounts are provided, and real accounts can't see each other
- There is an angular frontend plugged to this backend available at demo.realworld.show
- Interested in creating a new RealWorld stack? View our starter guide & spec

 Logo Attribution

See LICENSES_LOGOS.md for framework logo licensing and attribution details.

 Active Maintainers

- c4ffein - Maintainer - maintains the spec, the test suites and the demo website
- Manuel Vila - Maintainer - creator of the Layr framework and the CodebaseShow website

Top issues

Discussions