realworld

<br/><br/>

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="assets/media/realworld-dual-mode-white.svg">
  <source media="(prefers-color-scheme: light)" srcset="assets/media/realworld-dual-mode-black.svg">
  <img alt="RealWorld Example Applications" src="assets/media/realworld-dual-mode-grey.svg">
</picture>

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="assets/media/frameworks-white.svg">
    <source media="(prefers-color-scheme: light)" srcset="assets/media/frameworks-black.svg">
    <img src="assets/media/frameworks-grey.svg" alt="Frontend and Backend Frameworks" width="720"/>
  </picture>
</p>

<br/>

### See how [_the exact same_ Medium.com clone](https://demo.realworld.show) is built using different [frontends](https://codebase.show/projects/realworld?category=frontend) and [backends](https://codebase.show/projects/realworld?category=backend)

You can combine any frontend with any backend, because **they all adhere to the same [API spec](specs/api/)**

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!](https://github.com/realworld-apps/realworld/discussions) 🎉

# Implementations

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

Explore them on [**CodebaseShow**](https://codebase.show/projects/realworld).

## Spec-compliant backends

These backends pass the full [API spec test suite](https://docs.realworld.show/specifications/backend/introduction/):

- [**Nitro + Prisma + Zod**](https://github.com/realworld-apps/nitro-prisma-zod-realworld-example-app) — TypeScript
- [**Django Ninja**](https://github.com/c4ffein/realworld-django-ninja) — Python

# Create a new implementation

[**Create a new implementation >>>**](https://docs.realworld.show/implementation-creation/introduction/)

Or you can [view upcoming implementations (WIPs)](https://github.com/realworld-apps/realworld/discussions/categories/wip-implementations).

# Learn more

- [Documentation introduction](https://docs.realworld.show/introduction/)
- Every tutorial is built against the same [API spec](specs/api/) to ensure modularity of every frontend & backend
- A shared [CSS theme](assets/theme/styles.css) is provided to build frontend implementations with identical UI/UX
- A shared [E2E test suite](specs/e2e/) is available to validate frontend implementations
- There is a hosted version of the backend API available for public usage at [api.realworld.show](https://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 th