Skip to content
Go to file

RealWorld Example App

Moleculer codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

This repo is functionality complete — PRs and issues welcome!

Live demo on Glitch:

Glitch project:!/realworld-moleculer

React + Redux front-end UI is included. For more information on how to this works with other frontends/backends, head over to the RealWorld repo.

Getting started

To get the Node server running locally:

  • Clone this repo
  • npm install to install all required dependencies
  • npm run dev to start the local server
  • the API is available at http://localhost:3000/api

Alternately, to quickly try out this repo in the cloud, you can

Remix on Glitch

MongoDB persistent store

Basically the services stores data in an NeDB persistent file storage in the ./data folder. If you have to use MongoDB, set the MONGO_URI environment variable.


Multiple instances

You can run multiple instances of services. In this case you need to use a transporter i.e.: NATS. NATS is a lightweight & fast message broker. Download it and start with gnatsd command. After it started, set the TRANSPORTER env variable and start services.


To get the Node server running locally with Docker

  1. Checkout the repo git clone

  2. cd moleculer-realworld-example-app

  3. Start with docker-compose: docker-compose up -d

    It starts all services in separated containers, a NATS server for communication, a MongoDB server for database and a Traefik reverse proxy

  4. Open the http://docker-ip:3000

  5. Scale up services

    docker-compose scale api=3 articles=2 users=2 comments=2 follows=2 favorites=2

Code Overview


Application Structure

  • moleculer.config.js - Moleculer ServiceBroker configuration file.
  • services/ - This folder contains the services.
  • public/ - This folder contains the front-end static files.
  • data/ - This folder contains the NeDB database files.


Tested with realworld-server-tester.

Local tests is missing currently.

$ npm test

In development with watching

$ npm run ci


This project is available under the MIT license.


Copyright (c) 2016-2017 Ice-Services

@ice-services @MoleculerJS


Exemplary real world application built with Moleculer





No releases published


No packages published
You can’t perform that action at this time.