wq.app 1.1.2

Offline-capable HTML5 web and hybrid apps for citizen science field data collection.

wq.app is a suite of Javascript modules and related assets, created to facilitate the rapid deployment of offline-cabable HTML5 mobile and desktop data collection apps for crowdsourcing, citizen science, and volunteered geographic information, as well as professional field data collection. wq.app is the client component of the wq framework, and can be used with any REST service as a backend. In particular, when combined with a Mustache-capable REST service like wq.db, wq.app can be used to create responsive, progressively enhanced websites / apps, that can selectively render individual application screens on the server or on the client depending on project needs, network connectivity, and offline storage availability.

Getting Started

# Recommended: create virtual environment
# python3 -m venv venv
# . venv/bin/activate

# Install entire wq suite (recommended)
pip install wq

# Install only wq.app
pip install wq.app

See the documentation for more information.

Features

wq.app's JavaScript modules are built on a number of libraries including RequireJS, jQuery Mobile, Leaflet, d3, and Mustache.js. wq.app extends these libraries with:

• wq/app.js, a high-level application controller and configuration-driven CRUD client (optimized for use with wq.db.rest)
• wq/model.js, a lightweight implementation of models / collections
• wq/outbox.js, an offline queue of <form> submissions for later synchronization
• and a number of other useful utilities

wq/app.js can be extended with a number of plugins to integrate Leaflet-powered maps, d3.js-powered charts, and other enhanced functionality for project-specific use cases. wq.app comes bundled with all of the required third-party JavaScript libraries. To facilitate compact deployment, wq.app provides a Python-based build process for compiling wq apps: inlining templates, optimizing code (via r.js), and generating a native application package (via PhoneGap Build). wq.app also includes jquery-mobile.scss, a SASS/SCSS stylesheet for generating custom jQuery Mobile themes.

See the notes in Getting Started for more information about setting up a project layout that utilizes wq.app and/or its bundled third-party libraries.