wq.app 1.2.0

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.

Latest Build

Getting Started

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

# Install entire wq suite (recommended)
python3 -m pip install wq

# Install only wq.app
python3 -m pip install wq.app

See the documentation for more information.

Features

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

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

@wq/app can be extended with a number of plugins such as the Leaflet-powered @wq/map. 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).

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