Wq

<p align="center"> <a href="https://wq.io"> <img src="https://wq.io/images/wq.svg" alt="wq"> </a> </p> <p align="center"> <a href="https://wq.io"><strong>wq</strong></a> is a modular framework for field data collection and surveys via offline-capable mobile web apps. </p>

Getting Started

wq can be installed via GitHub, Docker, PyPI, NPM, or a <script> tag via CDN. See the documentation for more information on getting started.

Dev Container (recommended)

1. Go to https://github.com/wq/wq-docker-template
2. Select "Use this template" -> "Create a new repository"
3. Open the dev container via GitHub Codespaces or Docker Desktop

Docker Base Image

docker run ghcr.io/wq/base:main

Python

python3 -m venv venv
. venv/bin/activate
python -m pip install wq
wq create myproject

Node

npm init @wq myproject

CDN

<script type="module">
    import wq from 'https://unpkg.com/wq';
    wq.init({});
</script>

Features

wq is made up of the following submodules, which are maintained as separate packages.

Module | Github | PyPI | npm | Description ---------------------------|---------------------|------------------|-----------|--------- | wq/wq | wq | wq | Top level package (specifies submodules as dependencies) | wq/wq.app | wq.app | @wq/app | A JavaScript+Python library for building robust offline-capable HTML5 data entry apps. | wq/wq.build | wq.build | | wq command line interface. | wq/wq.create | wq.create | @wq/create | Project template and scaffolding tools. | wq/wq.db | wq.db | | Django REST framework extension with design patterns for CRUD APIs.