Getting Started

improve this page | report issue

Overview

Launch the Digital App Builder from:

  • In MacOS, double click the IBM Digital App Builder icon to open the Digital App Builder.
  • In Windows, launch the Digital App Builder by selecting Start > Programs > IBM Digital App Builder.

Note: If the Digital App Builder is opened for the first time, Accept the License to use IBM Digital App Builder in the flash screen to proceed further. After accepting the license agreement, the Prerequisites Check runs automatically for the first time. Click OK to proceed, if no errors found otherwise fix the errors and then restart the Digital App Builder.

IBM Digital App Builder

Create new app or Open an app or use the available Templates to further build the app.

Note: Recently created apps will be displayed under Recent section. For new installation, Recent section will not be displayed.

Create new app

Note: Create new app in two modes: Design mode - helps to design the app by drag-and-drop method and Code mode - helps to disign the app in code editor mode.

Create a new app by clicking Create new app icon from the Builder dashboard.

  1. Click Create new app icon. This will display the Select Channel window.

    Select Channel

  2. Select the channel for which you want to develop the app, by clicking the respective icon. You can later add more channels to the same app.

    • Android: Select this option if you are creating an android app.
    • iOS: Select this option if you are creating an iOS app.

      Note: You can build and run the iOS apps only on MacOS.

    • Web: Select this option if you are creating the app for the Web.
    • PWA: Select this option if you are creating a Progressive Web App.
  3. The Select type of server to connect to window is displayed.

    Select type of server

  4. You can select a Shared Playground Server or a Custom Professional Server.

    • Shared Playground Server – a shared Mobile Foundation server hosted on IBM Cloud to get you started quickly.

      Warning: The Shared Playground Server is a common server that is shared between many developers. This server should not be used for production apps. The data in this server can be deleted without notice. The server uptime is not guaranteed.

      IBM Shared Server

    • Custom Professional Server – You can connect to your own Mobile Foundation server either created on IBM Cloud or local. In the Configure IBM Mobile Foundation instance window you can either select an existing server or create a new server.

      Note: To easily get an instance of Mobile Foundation Server, you can provision it on IBM Cloud. You can refer to the documentation on how to provision and use the Mobile Foundation Server on IBM Cloud here.

      Configure IBM Mobile Foundation instance

      The Configure IBM Mobile Foundation instance window displays the list of Mobile Foundation server instances you have defined previously. On selecting the server, the Server URL, Admin username, Admin password, is displayed. To define a new server, you can click Create new server link. This will display the new Configure IBM Mobile Foundation instance window.

      Create New Server

      • Enter the new IBM Mobile Foundation instance details, like Server name, Server URL, Admin username, Admin password.

        Note: You can get the server url and login credentials from the Mobile Foundation server dashboard for the selected server instance.

      • Optionally, provide a Username (Confidential client username) and Admin password, for previewing the data in the Data viewer.
      • Click Connect.
  5. On successful login/connect, the Create App window is displayed where you can select an existing app definition that you may have created or create a new one by entering the details.

    • For a new app:
      • Provide the Name of the application, Location where the project files will be stored, Project/Bundle Id, and Version of the application.

        Shared Playground Server

      • Click Create to create the application. This displays the Select Mode windows.

        Select Mode

      • Select the Design or Code mode and click Get started.
        • Design mode - enables you to create the app by dragging and dropping controls to a canvas.
        • Code mode - enables you to create the app by writing code or using the Code Snippets.
      • If you have seleced Design mode, clicking Get started displays Welcome to Workbench popup screen. Welcome to workbench
      • Click Let’s Start to display the Digital App Builder workspace for creating a new application in the Design mode.

        DAB workspace

      • If you have seleced Code mode, clicking Get started displays the Digital App Builder workspace for creating a new application in the Code mode.

        DAB workspace

Open an existing app

Note: You can open an existing app developed using the Digital App Builder only. By default, the application is opens in design mode.

You can open an existing app in one of the following ways:

  • Click Open an app from the home page opens the file explorer. Navigate to your app project folder and click OK to open the app for further edits.
  • Optionally you can open the app from the Recent app list, if listed, by double clicking the app name.

    Note: If you have selected an existing project developed using design mode, it will get opened in design mode. If you have the project developed in code mode, then the project will open in code mode.

  • Select an existing application and specify the Location where the project files will be stored, Project/Bundle Id, and Version of the application.
  • Click Open. This displays the Select Mode windows.

    Select Mode

  • Select the Design or Code mode and click Get Started.
    • Design mode - enables you to create the app by dragging and dropping controls to a canvas.
    • Code mode - enables you to create the app by writing code or using the Code Snippets.
  • If you have seleced Design mode, clicking Get started displays the Digital App Builder workspace for updating an existing application.

    DAB workspace

  • If you have seleced Code mode, clicking Get started displays the Digital App Builder workspace for updating an existing application.

    DAB workspace

Using templates

You can use templates to quickly build your application. These are specific feature enabled app templates that will help you to quickly modify and develop the app.

Mod Resorts: This templates provides a sample app with the usecase of resorts app. It contains the login module, chat module, in-app feedback module to start with. You will have to deploy the Login adapter and configure your own chatbot credentials.

Last modified on September 13, 2019