Build Your First App in 15 Minutes

Open

Step 1: Sign Up & Log In to CommCareHQ

To create your first app in CommCare, you need to create a CCHQ (CommCare HQ) account. If you already have a CCHQ account, log in using your credentials. The steps to log in to your CommCare account are:

1. Visit www.commcarehq.org

   1. Use your credentials to log in to CommCare HQ.

   2. If you don't have an account, click "Sign Up" and follow the prompts as shown in the GIF below.

Open

Step 2: Create your First Application

After creating a CCHQ account, open your CommCare dashboard to create an application.

1. Click the 'Applications' tab, and then click the 'New Application' button. You’ll be directed to the Application Builder page.

2. Click the pen icon to name your application 'My First Application,' and then hit the checkmark button to save, as shown in the GIF below

Step 3: Choose the right Menu Type

After creating the CommCare application, let's choose the right menu type to set the basic structure of your app. The steps to do that are:

1. Select Menu Type: Click the '+Add' button on the left side of the screen to choose your Menu Type.

2. Survey vs. Case List: Choose "Survey" for simple data collection. For this app, select "Survey” as show in the GIF below. (Case List is used where you need to structure forms that register and follow up on items or people of interest over time).

Step 4: Design your first form 

After selecting the Survey menu type, let's create your first survey form.

1. Name Your Form: Click the gear or pencil icon next to the form name, enter ‘My First Form,' and click 'Save’, as shown in the GIF.

2. Add Questions: Click the '+Add Question' button to open a drop-down menu with various question types. Let’s add a text question asking, 'What is your name?' Start by selecting the 'Text' question type, as shown in the GIF below. The question will appear on the left, and its properties will be displayed on the right, as shown in the GIF.

3. Question ID and Display Text: The Question ID is a unique tag for the data, while Display Text is what appears in the application. In the Display Text field, enter ‘What is your name?' CommCare will automatically generate a Question ID based on your Display Text, but you can change it. For now, change it to 'name’, as shown in the GIF.

You can read more details about the form builder at https://dimagi.atlassian.net/wiki/x/PDHKfw. Feel free to add more questions to your form, or move to the next step!

Step 5: Create a Test User

After adding a question to the form, let's create a ‘Test User’ to try it out. The steps are:

1. Go to 'Users' and select 'Mobile Workers.'

2. Click ‘Create New Mobile Worker,' enter the basic information, and click 'Create’, as shown in the GIF below. For more details, visit - Create and Manage CommCare Mobile Workers

Step 6: Preview & Install the App on a Mobile Device

After creating a Test User, let's preview and test your app to see how it works. There are two ways to do this:

1. Preview Method: Click the teal bar on the left side of the screen to access 'Application Preview' and test your app, as shown in the GIF below.

2. Install on Android:

3. Download the CommCare app from the Google Play Store. For more information on the installation process follow this YouTube video: Installing CommCare on Android

4. In CommCare HQ, go to 'Applications' and select your newly created app.

5. Click 'Make New Version' to access the installation page, where you can manage deployments and release different versions of your app, as shown in the GIF.

6. Click the 'Publish' button next to the new version.

7. Follow the instructions for downloading your app to an Android device at this link. For now, use the barcode installation method by selecting 'Scan Application Barcode. For more details, visit - https://dimagi.atlassian.net/wiki/x/BQrKfw.

"Wohooo! Your first application is ready in less than 15 minutes!