> For the complete documentation index, see [llms.txt](https://bryan-guner.gitbook.io/my-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bryan-guner.gitbook.io/my-docs/redux/repos/examples/real-world/realworld-backend.md).

# realworld-backend

## ![RealWorld Example Applications](https://3511183755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGXZwPKOynNNtZSitAWtV%2Fuploads%2Fgit-blob-2d60354896dbab333efba6cc276bf38cbe047d61%2Frealworld-dual-mode.png?alt=media)

#### Stay on the bleeding edge — [join our GitHub Discussions!](https://github.com/gothinkster/realworld/discussions) 🎉

![](https://3511183755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGXZwPKOynNNtZSitAWtV%2Fuploads%2Fgit-blob-b2ee04190f8d12616c1777fe643e1c07fa9c59ef%2Fstacks_hr.gif?alt=media)

[![](https://3511183755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGXZwPKOynNNtZSitAWtV%2Fuploads%2Fgit-blob-4471a6184535846c116d9e062d959ae6c09ce055%2Fconduit_l.png?alt=media)](https://demo.realworld.io/)

#### See how *the exact same* Medium.com clone (called [Conduit](https://demo.realworld.io)) is built using different [frontends](https://codebase.show/projects/realworld?category=frontend) and [backends](https://codebase.show/projects/realworld?category=backend). Yes, you can mix and match them, because **they all adhere to the same** [**API spec**](/my-docs/redux/repos/examples/real-world/realworld-backend/spec.md) 😮😎

While most "todo" demos provide an excellent cursory glance at a framework's capabilities, they typically don't convey the knowledge & perspective required to actually build *real* applications with it.

RealWorld solves this by allowing you to choose any frontend (React, Angular 2, & more) and any backend (Node, Django, & more) and see how they power a real world, beautifully designed fullstack app called "[Conduit](https://demo.realworld.io)".

*Read the* [*full blog post announcing RealWorld on Medium.*](https://medium.com/@ericsimons/introducing-realworld-6016654d36b5)

## Implementations

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

[**See the list of implementations on the CodebaseShow website >>>**](https://codebase.show/projects/realworld)

## Create a new implementation

[**Create a new implementation >>>**](https://github.com/bgoonz/Learning-Redux/blob/master/spec/README.md)

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

## How do I get up & running?

Follow the instructions in the README of whatever frontend and/or backend repo's you want to get up and running.

#### Can you teach me how to build each stack from scratch?

Yup! We've built step-by-step tutorials for all of our stacks that teach you how to go from `git init` all the way to the production ready application. [**Start learning now >>>**](https://thinkster.io/tutorials/fullstack)

## Community created resources

Forks, tutorials, workshops, and other resources based on the RealWorld project:

* [**React+Redux / Node testing workshop**](https://github.com/kentcdodds/testing-workshop) by [**Kent C. Dodds**](https://github.com/kentcdodds)
  * Example repo showing the React+Redux and Node stacks working together w/ TDD
  * Live recording of his workshop is [**available on YouTube**](https://www.youtube.com/watch?v=DdqiXcYDv-8)
* [**RealWorld React/NodeJS E2E Tests**](https://github.com/anishkny/realworld-e2e-test) by [**Anish Karandikar**](https://github.com/anishkny)
  * A repo showing how to wire [React](https://github.com/gothinkster/react-redux-realworld-example-app) frontend with [NodeJS](https://github.com/gothinkster/node-express-realworld-example-app) backend for a RealWorld fullstack
  * Includes E2E integration tests that use [Chrome Puppeteer](https://github.com/GoogleChrome/puppeteer) and [Mocha](https://mochajs.org) and work with CI systems like [Travis CI](https://travis-ci.org/anishkny/realworld-e2e-test) and [CircleCI](https://circleci.com/gh/anishkny/realworld-e2e-test)
  * Also demonstrates usage of [Greenkeeper](https://greenkeeper.io) for automatic dependency updates and [Snyk](https://snyk.io/) for vulnerability monitoring
* Performance comparisons:
  * [A Real-World Comparison of Front-End Frameworks with Benchmarks 2020](https://medium.com/dailyjs/a-realworld-comparison-of-front-end-frameworks-2020-4e50655fe4c1)
  * [A Real-World Comparison of Front-End Frameworks with Benchmarks 2019](https://medium.freecodecamp.org/a-realworld-comparison-of-front-end-frameworks-with-benchmarks-2019-update-4be0d3c78075)
  * [A Real-World Comparison of Front-End Frameworks with Benchmarks 2018](https://medium.freecodecamp.org/a-real-world-comparison-of-front-end-frameworks-with-benchmarks-2018-update-e5760fb4a962)
  * [A Real-World Comparison of Front-End Frameworks with Benchmarks 2017](https://medium.freecodecamp.org/a-real-world-comparison-of-front-end-frameworks-with-benchmarks-e1cb62fd526c)

## Learn more

* ["Introducing RealWorld 🙌"](https://medium.com/@ericsimons/introducing-realworld-6016654d36b5) by Eric Simons
* Every tutorial is built against the same [API spec](/my-docs/redux/repos/examples/real-world/realworld-backend/api.md) to ensure modularity of every frontend & backend
* Every frontend utilizes the same hand crafted [Bootstrap 4 theme](https://github.com/gothinkster/conduit-bootstrap-template) for identical UI/UX
* There is a hosted version of the backend API available for public usage, no API keys required
* Interested in creating a new RealWorld stack? View our [starter guide & spec](https://github.com/bgoonz/Learning-Redux/blob/master/spec/README.md)

## Active Maintainers

[**Gérôme Grignon**](https://github.com/geromegrignon) **- Maintainer**

![](https://avatars.githubusercontent.com/u/32737308?v=4)

Gérôme is a Software Engineer at Sfeir. He's an open source enthusiast.\ <br>

[**Manuel Vila**](https://github.com/mvila) **- Maintainer**

![](https://avatars.githubusercontent.com/u/381671?v=40)

Manuel is an independent Software Engineer, creator of the [Layr framework](https://layrjs.com) and the [CodebaseShow website](https://codebase.show/).\ <br>

## Who made this?

RealWorld would not be possible without the [open source community](#special-thanks-to) continuously helping push the project forward. In addition, the former team was composed of:

[**Anish Karandikar**](https://github.com/anishkny) **- Core Maintainer**

![](https://avatars1.githubusercontent.com/u/357499?v=3\&s=100)

MathWorker, ex-Google, ex-Computational Fluid Dynamicist, forever lover of tech & humanities ❤️\ <br>

[**Cameron Chapman**](https://github.com/Cameron-C-Chapman) **- Core Maintainer**

![](https://avatars1.githubusercontent.com/u/1323581?v=3\&s=100)

Cameron Chapman is a Software Engineer at FanThreeSixty. He's an open source enthusiast and is helping to teach a local web development boot camp at Kansas University.

[**Eric Simons**](https://twitter.com/ericsimons40) **- Founder/Maintainer**

![](https://avatars1.githubusercontent.com/u/556934?v=3\&s=100)

Eric is a Software Engineer, UI Designer, and author of many technical books & tutorials. He oversees the project direction, maintenance and organizes the planning and development efforts of the team.

[**Albert Pai**](https://twitter.com/iamalbertpai) **- Founder/Maintainer**

![](https://avatars0.githubusercontent.com/u/1776432?v=3\&s=100)

Albert is a Software Engineer, DevOps ninja, and author of many technical books & tutorials. He oversees the project direction, maintenance and organizes the planning and development efforts of the team.

[**Thinkster**](https://twitter.com/gothinkster) **- Funding/Support**

![](https://avatars0.githubusercontent.com/u/8601733?v=3\&s=100)

[Thinkster](https://thinkster.io) creates high quality resources that help Javascript developers succeed. The RealWorld project wouldn't exist without their funding, so please consider investing in [a Pro subscription](https://thinkster.io/pro) to help support us!

[**James Brewer**](https://twitter.com/brwr_) **- Admin**

![](https://avatars1.githubusercontent.com/u/4095660?v=3\&s=100)

James is a Software Engineer at Square and a contributor to the Django project. He created & maintains the RW Django codebase and continually provides guidance for the RealWorld project itself.

[**Sandeesh S.**](https://github.com/sandeesh) **- Admin**

![](https://avatars1.githubusercontent.com/u/16877877?v=3\&s=100)

Full stack developer, Laravel enthusiast, Digital marketing specialist and an avid gamer.\ <br>

## Special thanks to...

RealWorld wouldn't be possible without the help of the open source community reviewing codebases, creating new app implementations, and many other tasks that help push this project forward. We especially appreciate the OSS leaders who have helped contribute to RealWorld:

* **Dan Abramov** (creator of Redux) for helping [spark the initial idea](https://twitter.com/dan_abramov/status/692009757775896577), [getting the Redux community involved](https://github.com/reactjs/redux/issues/1353), as well as graciously taking the time to provide feedback on the Redux codebase
* **Max Lynch** (creator of Ionic) for taking the time to provide guidance in the early days of this project
* **Addy Osmani** (creator of TodoMVC) for helping [spark the initial idea](https://twitter.com/addyosmani/status/762828483433144320) and his amazing work with TodoMVC
* **TodoMVC** ([team & contributors](https://github.com/tastejs/todomvc#team)) for their exemplary & successful work; their project & org has been an invaluable analogy for us as we've built out RealWorld
* **James Brewer** (docs contributor to Django) for countless brainstorming sessions, helping name this project, and creating the Django codebase + tutorial

## License

All of the codebases are **MIT licensed** unless otherwise specified.

<br>

[![Brought to you by Thinkster](https://3511183755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGXZwPKOynNNtZSitAWtV%2Fuploads%2Fgit-blob-390e8335e985b02591487556d0c4fc4f250577f5%2Fend.png?alt=media)](https://thinkster.io)
