Vert.x Blueprint Project - A reactive todo-backend implementation using Vert.x and various persistence
Clone or download
sczyh30 Fix the issue about service init
- The issue is due to wrong operator usage of `Completable`

Signed-off-by: sczyh30 <>
Latest commit c77de1b Mar 20, 2018

Vert.x Blueprint - Todo Backend

Travis Build Status

Vert.x blueprint application - A reactive todo-backend implementation using Vert.x and various persistence (e.g. Redis or MySQL).

This repository is an introduction to basic Vert.x web RESTful service development and reactive programming. Detailed tutorials (both in Chinese and English) are provided below.

Note: We've redesigned the code with reactive and functional style with RxJava 2 and Vert.x 3.5.x.


  • What is Vert.x and its principles
  • What is and how to use Verticle
  • How to develop a REST API using Vert.x Web
  • How to make use of asynchronous development model
  • Reactive programming with RxJava 2
  • How to use persistence such as Redis and MySQL with the help of Vert.x async data components

Detailed Document

Want to improve this blueprint ?

Forks and PRs are definitely welcome !


To build the code:

gradle build -x test

Run service locally:

  • with Redis: java -jar build/libs/vertx-blueprint-todo-backend-fat.jar -conf config/config.json
  • with MySQL: java -jar build/libs/vertx-blueprint-todo-backend-fat.jar -conf config/config_jdbc.json

Run with Docker Compose:

docker-compose up --build


API Test

Test result of the RESTful API (using todo-backend-js-spec):

RESTful API Test Result

You can also run it with the todo backend frontend client:

Todo Frontend