| CI/CD |     |
|
|---|---|---|
| Tech Stack |      |
|
| Code Style |     |
|
| Quality |   |
|
| Community |   |
|
| Other Info |      |
Building on the success of HOT's Tasking Manager, a tool for coordinating remote digitization of map features, the Field-TM was conceived with the purpose of tagging the features with field-verified information.
While there are many excellent applications for tagging map features already, the Field-TM aims to solve the problem of coordinating field mapping campaigns.
Field-TM is a lightweight coordination layer on top of other mapping apps.
- Split a project area into tasks, using the in-browser Task Planner. Split by grid, by roads, or by number of buildings, then edit the tasks.
- Assign tasks to teams or people, with a label, name and comment.
- Send the tasks to a mapping app:
- ODK and QField: Field-TM creates the project and syncs tasks to ODK Central or QFieldCloud.
- Every Door, StreetComplete, CoMapeo, CoMaps, Panoramax, SketchMap, ChatMap or any other app: download each task as GeoJSON or GPX, or share it with a link or QR code.
Field-TM recommends a mapping app during project creation, based on what you are mapping and how well mapped the area already is.
This project relies heavily on the ODK ecosystem underneath:
- XLSForms are used for the underlying data collection survey. The fields in this survey can be mapped to OpenStreetMap tags.
- ODK Central is used to store the XLSForm and receive data submissions from users.
- ODK Collect is a mobile app that the user submits data from.
In the wake of the 2010 Haiti earthquake, volunteer developers created the Tasking Manager after seeing a similar coordination challenge for mapping areas without existing data.
Now with over 500,000 volunteer mappers, the Tasking Manager is a go-to resource for volunteers to map collaboratively.
To aid future disaster response, we would really welcome contributions for:
- Backend Python development (Litestar + HTMX)
- Documentation writers
- UI / UX designers
- Testers!
- XLSForm creators
Please take a look at our documentation and contributor guidance for more details!
Reach out to us if any questions!
Use one of these supported paths:
# Local development
just config generate-dotenv
just start dev
# Production install
just prep machine
just config setup
just start prodjust start prod presents an interactive version selector and checks
out the chosen release tag automatically.
See INSTALL.md for requirements, or the full Production Deployment guide for details.
| Status | Feature | Release |
|---|---|---|
| β | π₯οΈ project area splitting avoiding roads, rivers, railways | Since v2024.4.0 |
| β | π₯οΈ XLSForm survey generation in ODK Central | Since v2024.4.0 |
| β | π± mapping of project via survey in ODK Collect mobile app | Since v2024.4.0 |
| β | π± |
Since v2024.4.0, removed in the 2025 overhaul |
| β | π± download base imagery & geolocation for in the field | Since v2024.4.0 |
| β | π₯οΈ |
Since v2024.4.0, removed in the 2025 overhaul |
| β | π’ Beta Release | Since v2024.4.0 |
| β | π₯οΈ & π± basic user tutorials and usage guides | Since v2024.4.0 |
| β | π± |
Since v2024.4.0, removed in the 2025 overhaul |
| β | π± |
Since v2024.5.0, removed in the 2025 overhaul |
| β | π± |
Since v2024.5.0, removed in the 2025 overhaul |
| β | π± |
Since v2024.5.0, removed in the 2025 overhaul |
| β | π₯οΈ |
Since v2024.5.0, removed in the 2025 overhaul |
| β | π± better support for mapping new points, lines, polygons | Since v2025.1.0 |
| β | π± |
Since v2025.2.0, removed in the 2025 overhaul |
| β | π₯οΈ user role management per project | Since v2025.2.0 |
| β | π₯οΈ |
Since v2025.2.0, removed in the 2025 overhaul |
| β | π₯οΈ optional private projects to restrict access | Since v2025.2.0 |
| β | π± |
Since v2025.2.0, removed in the 2025 overhaul |
| β | π± custom Field-TM deployments with updated branding | Since v2025.2.0 |
| β | π± |
v2025.3.0, removed |
| β | π₯οΈ integration with QField | v2026.1.0 |
| β | π₯οΈ multiple approaches to task splitting algorithm | v2026.1.0 |
| β | π₯οΈ & π± interface available in more languages (incl. Nepali, Hausa, Arabic) | v2026.1.1 |
| β | π₯οΈ simpler, step-by-step project creation | v2026.2.0 |
| β | π± simplified mapping in QField via a Field-TM plugin | v2026.3.0 |
| β | π₯οΈ export mapped data from QField projects | v2026.4.0 |
| β | π₯οΈ reuse a Tasking Manager project area | v2026.4.1 |
| β | π₯οΈ task planner: split, edit and assign tasks | Unreleased |
| π | π± map points, lines and polygons in the same project | β |
| π | π₯οΈ optional restriction of mapping to the assigned task area | β |
| π | π₯οΈ pre-defined OpenStreetMap forms for easy OSM mapping | β |
| β | π₯οΈ tasks for Every Door, StreetComplete, etc. | Unreleased |
| π | π₯οΈ integration with ChatMap | β |
| π | π₯οΈ integration with HeiGIT Sketch Map Tool | β |
| π | π₯οΈ integration with other ODK server types: Ona.io, Kobo | β |
| π | π₯οΈ export (+merge) the final data to OpenStreetMap | β |
| π | π₯οΈ instructions for how to best visualize ODK data within QField | β |
Note
π± for mobile / mappers
π₯οΈ for desktop / managers / validators
Here's how you can contribute:
- Open an issue if you believe you've encountered a bug.
- Make a pull request to add new features or fix bugs.
Thanks goes to these wonderful people:
