←Back to Aronnax

Documentation

User Guide

How to fill in a survey and collect observations in the field: answering questions, marking places on the map, adding photos and voice notes, and installing Aronnax on your phone.

About Aronnax

Aronnax is a Public Participation GIS (PPGIS) platform built by the Digital Reef Charitable Trust. It enables communities across Aotearoa New Zealand to collect and share location-based observations about their environment, in the field, on any device.

This site is where observations are collected. Surveys are built and submissions reviewed by researchers in the Digital Reef app (see For researchers). A contributor's part is short:

1Open→
2Answer→
3Locate→
4Attach→
5Submit
01

Getting started

Filling in a survey

You do not need an account to fill in a published survey. Open the link you were sent; it takes you straight to the form.

Logging in

Aronnax uses your Digital Reef account. There is no separate Aronnax account or invite code.

  1. 1Choose Log in at the top of the page. It opens the Digital Reef app.
  2. 2Log in there with your Digital Reef account.
  3. 3Come back to Aronnax. The surveys you have been asked to work on appear on the home page.

Researchers and administrators

Importing data, building surveys, reviewing submissions, ArcGIS sync and granting access all happen in the Digital Reef app. This guide covers collecting; see For researchers for what is where.

02

Collecting data in the field

Each published survey has its own link. Open the link you were sent, fill in the form, and submit. If you are logged in, the surveys you have been asked to work on are also listed on the home page, and your submissions are recorded under your name.

Aronnax validates each submission against the survey schema before accepting it. Required fields must be filled, numbers must be within range, and spatial fields must have valid geometry.

03

Question types

Each survey supports 13 question types:

Aa
TextShort answer
Aa
TextareaLong answer
#
IntegerWhole number with min/max
#.
DecimalNumber with decimal places
v
SelectSingle choice dropdown
vv
MultiselectMultiple choice checkboxes
D
DateDate picker
DT
Date & TimeDate and time picker
P
PhotoImage, video, or document upload
M
Voice NoteRecord audio in the browser
G
GeopointDrop a pin on the map
GT
GeotraceDraw a line or record a GPS track
GS
GeoshapeDraw a polygon or walk a boundary
04

Media uploads

The Photo and Voice Note question types support file uploads. When a contributor submits a survey response with media, the file is uploaded to secure cloud storage and linked to the submission.

P

Photos

Images (JPEG, PNG, WebP), videos (MP4, WebM), and documents (PDF, Word, Excel). Tap the upload area or click to select from your device. A preview appears before submission.

M

Voice Notes

Record audio directly in the browser using your device microphone. Useful for field observations where typing is impractical. Supported formats: WebM, MP4, OGG audio.

*Maximum file size is 100 MB. Uploaded files are stored in Azure Blob Storage and linked to the submission. Each file gets a unique identifier to prevent duplicates.

05

GPS track recording

The Geotrace and Geoshape question types support live GPS recording alongside tap-to-draw.

GT

Record Path

Tap the button, then walk. Aronnax records your position continuously and draws the line as you move. Useful for walking routes, river sections, or trail surveys.

GS

Walk Boundary

Same GPS tracking, but the shape auto-closes into a polygon when you stop. Walk the perimeter of a site to capture its boundary.

*The map follows your position and shows GPS accuracy in metres. Points closer than 5 metres are filtered out to keep the geometry clean.

06

Installing as an app

Aronnax is a Progressive Web App (PWA). Install it to your home screen for a full-screen app that launches instantly and keeps working through a patchy connection.

  1. 1Open Aronnax in your phone's browser and tap Install or Add to Home Screen.
  2. 2Open the installed app and navigate to a published survey.
  3. 3Fill out the form and submit it while you have signal.

You need signal to submit

Offline submission is not yet available. The installed app will open and show pages you have already visited without a connection, but submitting a survey needs signal at the moment you press submit. If the submission fails you will see an error, and the form is not saved for later.

Until offline capture ships, please stay within coverage when you submit, or note your observations another way and enter them once you are back in range.

07

For researchers

Running a survey happens in the Digital Reef app, not on this site. There you can:

  • import data tables from a file or an ArcGIS Online Feature Layer, and edit them
  • build, publish and unpublish surveys
  • add researchers and contributors to a survey
  • review submissions, approving or rejecting each one
  • push approved submissions to an ArcGIS Online Feature Layer

*Using these tools needs Aronnax access on your Digital Reef account. If the app shows you a promotional card instead of your surveys, ask a Digital Reef administrator.

08

Troubleshooting

Cannot log in

Aronnax uses your Digital Reef account, so log in at the Digital Reef app; there is no separate Aronnax password. If a survey you expect does not appear, ask its lead researcher to add you.

The survey link says the survey is not found or unavailable

The survey is not open for submissions: it may not be published yet, or it has been closed. Check with the person who sent you the link.

Submission failed with no signal

Offline submission is not yet available. A submission needs a live connection at the moment you press submit, and a failed one is not saved for later - re-enter it once you are back in coverage.

Part of The Digital Reef

Built by the Digital Reef Charitable Trust for environmental monitoring and community science initiatives across Aotearoa New Zealand.

info@digitalreef.nz