To proceed, make sure that you:

In this page we'll get to know the major features of the CommCare Application Builder.

  • Understand the different parts of CommCareHQ and what they are used for
  • Recognize the different pieces of the application builder
  • Create a blank application
  • Save changes
  • Change application, menu, and form names

Welcome to CommCareHQ!

When you log in to CommCareHQ you will notice a number of different options. We are going to focus on Application Building, but let's at least get to know what everything does!

Along the top of the screen there are several big categories or pages in your project space.

Here is what each of them does:

Application Builder

Once you are logged into your CommCare account and project, the first thing you will see is a blank application in the "application builder".



Take a look at the menu of your application. A number of different functions are available, described below. Feel free to click through to see what each is comprised of.

Setting Up an Application

Now that we have a blank application, we can start building. But first, let's review what we're going to build.

Imagine that you work for an organization that coordinates a maternal and child health program in which community health workers (CHW) monitor and counsel pregnant women in their communities. When a CHW learns that a women is pregnant, she registers the woman into the program. Throughout the pregnancy, the worker visits the pregnant woman to collect data and provide counseling messages. At the end of the pregnancy, the CHW monitors the health of the newborn child as well. Currently, the program uses paper forms to support each interaction.

Using this information as a guide, let's build an app to replace the paper forms and support these workers. We will build this app step-by-step. 

Let's start by giving our application a name.

1. Set the application name


In the application builder, there is always a green save button. When you make a change it becomes bright green and you will need to push it to save your changes. While building applications, it is important to keep saving, though you will always get a warning message when you try to navigate away from a page without saving changes.

2. Create a set of forms

Next, use the "+ Add..." button to select the kind of form structure you would like to use.  The options are the following:

By selecting one of these, you will begin the application building process.  For this app, because the CHW will monitor pregnant women over time, select "Case List," which will create a "Register" form and a "Followup" form.

By clicking on "Case List," you can update the name as well as configure a number of settings. Most of these settings have to do with case management which we will cover in subsequent tutorials. For now, you can leave all of the settings as they are by default.

3. Begin editing your forms

After selecting, "Case List", you are now automatically entered into the "Register" form and can begin to add questions to your form. But don't add anything yet! We'll do this in the next module. 

Remember, a form is one specific set of information within a case list. For example, our "Register" form will be used to collect registration information for a pregnant woman. We can edit our second form called "Followup" to capture information about the pregnancy during a follow-up visit. 

You can edit any form in the Case List by clicking on it.  

4. Add more forms

For our application, we'll need a third form to enter data about the health of the newborn child. To add another form, click on the green "+" next to the words, "Case List". 

You're ready to start building your first form! Go on to Part 3!