mgthunderbolt / realworld

A Collection & Specification for Exemplary Frontend and Backend Codebases 🏅

A Collection & Specification for Exemplary Frontend and Backend Codebases 🏅

Read the full blog post announcing RealWorld on Medium.

TL;DR — See how the exact same real world blogging platform is built using React/Angular on top of Node/Rails/Django (and even more stacks coming soon). Yes, you can mix and match them, because they all adhere to the same API spec 😮😎

Why?

While most demos/tutorials 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.

How does it work?

You can choose any frontend (React, Angular 2, etc) and any backend (Node, Django, etc) and see how they power a real world, beautifully designed fullstack app called "Conduit" (demo).

Wait, I can use any frontend with any backend?

Yup! The frontends & backends adhere to the same API spec, so you can mix & match any desired frontend/backend combo.

What frontends and backends do you currently support?

All of our stacks are built & reviewed by the OSS community. We're always working to add more stacks to this list.

Frontends

Angular 2+	React / Redux	Angular 1.5+

Backends

Node / Express	Django	Rails

View upcoming stacks (WIPs)

Note: All stacks that are a WIP are experimental and incomplete.

Don't expect everything to work perfectly out of the box!

Create a new stack

Know any of these frameworks (or one that isn't listed)? Create a new framework implementation >>>

How do I get up & running?

Simply 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 >>>

Community created resources

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

• React+Redux / Node testing workshop by Kent C. Dodds
  • Example repo showing the React+Redux and Node stacks working together w/ TDD
  • Live recording of his workshop is available on YouTube

Learn more

• "Introducing RealWorld 🙌" by Eric Simons
• Every tutorial is built against the same API spec to ensure modularity of every frontend & backend
• Every frontend utilizes the same hand crafted Bootstrap 4 theme 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

Who made this?

RealWorld would not be possible without the open source community continuously helping push the project forward. In addition, we have a core project team composed of:

Eric Simons - Founder/Lead

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 - Founder/Lead

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 - Funding/Support

Thinkster 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 to help support us!

James Brewer - Advisor, Creator of RealWorld Django

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.

Val Karpov - Creator of RealWorld React & Redux

Val Karpov is a Software Engineer at Booster Fuels and is a core contributor to Mongoose. He created & maintains the RealWorld React/Redux codebase.

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, getting the Redux community involved, 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 and his amazing work with TodoMVC
• TodoMVC (team & contributors) 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.