Getting Started
The following is recommended to get up and running quickly:


Important tips for starters

Represent your data in Documents

MOBBL Documents are fast, flexible and provide a range of services out of the box. They include validation, sorting, difference calculation and deep copy.

POJO's are not portable

Every Plain Old Java Object (POJO) class you write to represent data will have to be re-written on other platforms. Furthermore you will have to implement all supporting services yourself. Stay away from handwritten data objects. They are a path towards the dark side. Check our the sample apps for examples of using MOBBL Documents.

Use the Android xml editor for Views

...can easily be incorporated into a MOBBL based app which is in fact a recommended practice. There is no substitute for XML view files representation for efficient development of Android views. The sample apps have examples of how to use a XML view files in a MOBBL based app.


To use MOBBL and its dependency libraries for your Android development you will need

  • Android Studio
  • Android SDK
  • Gradle
  • Mobbl is using Android Compile SDK Version 21 internally, but can be set in Gradle
  • Mobbl is using Android Build Tools Version 21.1.2 internally, but can be set in Gradle
  • Android support v7 appcompat, version 21.0.3

Creating a new Mobbl project

Installing the project generator

If you haven't installed the Mobbl project generator yet, here's how to do this:

  1. Download and install NodeJS, if you do not have it installed yet. It is available for Windows, Mac OS X and Linux
  2. Install the project generator tool by executing the following command in your terminal (you probably need to use sudo, with the standard install):
    $ npm install -g mobbl-generator

Using the project generator

These are the steps you need to take, if you want to create a new Android project with Mobbl:

  1. Open a terminal and execute the following command:
    $ mobbl-generator
  2. The project generator will ask you a few questions about the project(s) you're about to create. Let's create a project with the following details:
    • Platform: Option 2, Android
    • Project name: my-new-android-app (we type "*" for where we want "ios" or "android' to appear)
    • App title: My New App
    • Packagename:
    • Project location: current directory
    $ mobbl-generator
    prompt: Which platform do you want to generate a project for?
    1. iOS
    2. Android
    3. iOS & Android
    :  (1) 2
    prompt: Project name (* will be substituted with ios or android):  my-new-*-app
    prompt: The display name of the app:  My New App
    prompt: Bundle Identifier / Package name:
    prompt: At what location should the project directories be created? (Current directory is /Users/mobbl/Developer):  (.)
  3. Import the project into Android Studio
  4. Customize the project to your liking
  5. Build and run the app

Using our template app

We have an app template on GitHub for you to customize and use as a base to start working with Mobbl. Here's how you use it:

  1. Get the source code of our template app from GitHub.
  2. Import the project into Android Studio
  3. Customize the project to your liking
  4. Build and run the app in the emulator or on your Android device

Sample apps

To get inspired, sample apps are available here:

Using Mobbl for your existing project

These are the steps you need to take, if you want to use the Mobbl products for your own project:

  1. Include the LICENSE file in your project
  2. Change/add build settings in your project

    • Gradle:
      dependencies {
        compile ('') {
    • or with Maven

Sample apps

Sample applications that you can check out and change are here:

Additional documentation

Further documentation available are: