481web

This github repo contains everything you need to host our app either locally or on Heroku. Please refer to our Wiki for realease notes.

Files to Grade

• neonatal/neonatal.xlsx - Our ODK spreadsheet. To grade the comments of the spreadsheet please look at Apendix 2, where we describe the layout of the sheet.
• neonatal/customPromptsTypes.js - This file contains our custom prompt types which are menu, image slider, and ballard exam. We have documented these prompts with "class comments" which describe how to use them as well as with inline comments, so that future developers can debug and modify the code.
• templates/ - This directory contains our HTML templates.
• default/ - This directory contains the ODK code, although we have made some modifications. We have maintained a list of modifications and provided inline comments for them. You can find the list as an appendix to our paper.
• neonatal/customStyles.css - This file contain custom css style to button, background etc.

Host Locally

1. Clone this project.
2. Open a terminal and cd to the project root
3. If using Mac OSX, proceed to step 4. Otherwise download the appropriate version of node.js.
4. Run the following command: ./node app.js.
5. Open browser and navigate to localhost:8888. Note: you must clear your browser's cache and saved app data everytime the app changes.

Host on Heroku

1. Clone this project.
2. Open a terminal and cd to the project root.
3. Run the following command: git push

Files to Note

• /app.js - This is a node.js app which serves our app.
• /default - This directory contains the code for ODK. You can learn more about ODK here
• /neonatal - This directory contains the code specific to our app. You can learn more about the architecture of our app from our paper.
• /presentation - Contains the final version and supporting files for our presentation.
• /paper - Contains the final version and supporting files for our paper.
• /report - Contains our final report and appendices with helpful information on aspects of our app specifically and ODK in general.
• convertPhantom - command line conversion from xlsx to json.

Convert Spreadsheet to JSON

• cd into project root
• run ./phantomjs convertPhantom neonatal/neonatal.xlsx > neonatal/formDef.json
• Remember to clear browser chache and saved app data.