Swath is a mobile app for planning, running, and record-keeping agricultural drone spray operations in Canada. It is built for Canadian operators and farmers: metric units and Celsius throughout, Transport Canada RPAS flight recordkeeping (CARs 901.27 / 901.48), and Health Canada PMRA pesticide data.
This manual documents every screen in the app — what it shows, what each field and button does, and how the main flows work. It is written for a new operator who is not a software developer. It is also the knowledge base for Swath Support, the in-app AI help assistant, so it aims to be accurate and complete, and is derived directly from the app's screen code rather than from memory.
A few conventions used throughout:
- "Tap" means touch once on your phone screen.
- Areas are stored in hectares (ha); most screens let you toggle between hectares and acres, and the app remembers your preference.
- Temperatures are in Celsius (°C), wind in km/h.
- "Org" is short for organization — your company or farm account that holds all your data and team members.
- Your account is one of two organization types — Operator (a spray business that serves clients) or Farmer (spraying your own land). The org type changes some labels and hides features that don't apply (for example, farmers don't see clients or billing). Where a screen behaves differently by org type or by your role, this manual says so.
Getting Started & App Navigation
This section walks you through everything you see before you start using Swath day-to-day: signing in, creating an account, resetting a forgotten password, joining an organization, and the first-time setup wizard. It also explains how the app is organized once you're in, and what the app does automatically to decide which screen to show you.
Swath's tagline on the sign-in screen is "Aerial application records for Canadian operators." The app is built to work fully offline once you've signed in once.
How the app decides where to send you (auth gating)
Swath watches whether you are signed in and whether your account belongs to an organization ("org"). You never choose these screens from a menu; the app moves you automatically based on your situation.
- When you open the app, you'll first see a branded loading screen that says "Starting Swath…" while the app loads its fonts and checks whether you're already signed in. This works offline because your sign-in is remembered on the device.
- If you are not signed in, the app sends you to the Sign in screen. You cannot reach the main app without signing in. (The only screens you can be on while signed out are the sign-in, create-account, password-reset, join, and onboarding screens.)
- If you are signed in but your account does not yet belong to an organization, the app sends you to the Onboarding wizard so you can create or join one.
- If you are signed in and belong to an organization, the app takes you into the main app (the tab bar).
- The very first time you sign in on a device, you may briefly see a loading screen that says "Setting up your data…" while your organization's data is downloaded for offline use. Returning users skip this and go straight in.
- "Sign in once and stay signed in" — once signed in, the app keeps you signed in and works fully offline.
The bottom tab bar (main navigation)
Once you're in the main app, you navigate using a tab bar along the bottom of the screen. The tabs you see depend on whether your organization is a Farmer operation or an Operator (service business) — see the Onboarding section for the difference.
Tabs always shown, in order:
- Home — house icon.
- Jobs (Operator) or Tasks (Farmer) — this tab is labelled "Jobs" with a briefcase icon for operators, and "Tasks" with a checkmark-circle icon for farmers.
- Fields — map icon.
Then one role-specific tab:
- Equipment — chip icon. Shown only for Farmer organizations.
- Clients — people icon. Shown only for Operator organizations.
And finally:
- More — menu icon. This is where additional options live.
So a farmer sees: Home, Tasks, Fields, Equipment, More. An operator sees: Home, Jobs, Fields, Clients, More.
Sign in screen
This is the screen you land on when you're not signed in. It's for existing users to sign in with the email and password they already set up.
Fields:
- Email — type the email address for your account. It's not case-sensitive (the app lowercases it for you) and leading/trailing spaces are trimmed.
- Password — type your password. Tap the eye icon on the right to show or hide what you've typed.
Buttons and actions:
- Sign in — signs you in. Both email and password are required; if either is empty you'll see a "Required" message asking you to enter your email and password. If sign-in fails, you'll see a "Sign in failed" message (for example if the email or password is wrong). On success, the app remembers your role and organization on the device for offline use and takes you into the main app. If your account exists but hasn't joined an organization yet, it sends you to the Join screen instead.
- Forgot password? — opens the Reset Password screen. Whatever you've typed in the Email field is carried over to save you retyping it.
- New to Swath? Create an account — opens the Create account (sign-up) screen.
At the bottom is a reminder note: once signed in, the app works fully offline, so you only need to sign in once.
Create account (sign-up) screen
This screen is for brand-new users. From here you can create an account and either join an existing organization (with an invite code) or set up your own new organization afterward.
Fields:
- Full name — your name (required). Auto-capitalized as words.
- Email — your email address (required). Not case-sensitive; trimmed for you.
- Password — must be at least 6 characters. Tap the eye icon to show or hide it.
- Invite code (optional) — a code from your organization's admin, formatted like SWATH-XXXX-XXXX. It's automatically uppercased as you type. If you have one, entering it joins that organization. If you leave it blank, you'll be taken to the setup wizard afterward to create your own new organization. A hint beneath the field explains this.
Buttons and actions:
- The main button reads "Create account & join org" if you've typed an invite code, or "Create account" if you haven't.
- Required-field rules, in order: full name must not be empty ("Enter your full name."), email must not be empty ("Enter your email."), and the password must be at least 6 characters ("Password must be at least 6 characters.").
- What happens after you tap it:
- If your app requires email confirmation, you'll see a "Check your email" message telling you to click the confirmation link in your email and then sign in. (The message also notes an admin can turn off email confirmation for instant access.)
- If no email confirmation is required and you left the invite code blank, you go straight to the Onboarding wizard to create a new organization.
- If you entered an invite code, the app tries to redeem it and join that organization. If the code doesn't work, you'll see an "Invite code issue" message; your account was still created, so you can sign in and enter a valid code when prompted. If it works, you're taken into the main app.
- Already have an account? Sign in — takes you back to the Sign in screen.
Reset Password screen
This screen lets you reset a forgotten password using a 6-digit code emailed to you. It has three steps, shown by a progress bar of three segments at the top. There's a back arrow in the top-left to leave the screen. If you arrived here from the Sign in screen, your email is pre-filled.
Step 1 — Request a code:
- Email field (required) — the email for your account.
- Send reset code — emails you a 6-digit reset code and advances to step 2. If the email is blank you'll be asked to enter it.
Step 2 — Enter the code:
- 6-digit code field — enter the code from your email. The field only accepts numbers and is limited to 6 digits.
- Verify code — checks the code. It must be exactly 6 digits or you'll be asked to enter the 6-digit code. If the code is wrong or expired, you'll see an "Invalid code" message. On success you advance to step 3.
- Resend code — clears the field and emails you a new code; you'll see a "Sent" confirmation. The screen reminds you to check your inbox and spam folder.
Step 3 — Set a new password:
- New password field — must be at least 8 characters. Tap the eye icon to show or hide it (this also reveals the confirm field).
- Confirm password field — must match the new password.
- Set new password — saves your new password. Rules: at least 8 characters ("Too short") and the two entries must match ("Mismatch"). On success you're taken into the main app.
Note the password length difference: creating an account requires at least 6 characters, but resetting a password requires at least 8.
Join screen
This screen is for people who are signed in but whose account doesn't belong to an organization yet (or no longer does). You can also land here if the invite-code step failed during sign-up. It shows a people icon and the heading "Join your organization."
The app first checks that you're signed in; if you're not, it sends you to the Sign in screen. While checking, you'll see a brief spinner.
Fields:
- Your full name — required. If your name was saved when you created your account, it's pre-filled here.
- Invite code — required, formatted like SWATH-XXXX-XXXX. Automatically uppercased as you type.
Buttons and actions:
- Join org — redeems your invite code to join the organization. Both your name and a code are required ("Enter your full name." / "Enter your invite code."). If the code is invalid you'll see an "Invalid code" message. On success, your role and organization are saved on the device and you're taken into the main app.
- Sign out — signs you out and returns you to the Sign in screen.
Onboarding wizard (first-time setup)
This is the guided setup you reach right after signing up (or any time you're signed in without an organization). It has two paths: create a brand-new organization, or join an existing one with an invite code. Progress dots at the top show where you are in the current path. Each step has a back arrow to return to the previous step. If you're not signed in, the app sends you to the Sign in screen; a brief spinner shows while it checks.
Step 0 — Choose your path. The welcome screen ("Welcome to Swath") offers two choices:
- Create an organization — "Set up a new org — you'll be the admin." Choosing this makes you the admin of the new organization.
- Join with invite code — "Someone sent you a code — enter it here."
Path A: Create an organization
Step 1 — What kind of operation? Choose one (you're told you can change it later in settings):
- Farmer — "Personal or farm operation. No client billing — just tasks, fields, and equipment."
- Operator / Service Business — "You spray for clients. Includes client management, invoicing, and billing rates."
This choice controls the rest of the wizard and which tabs you'll see later. Operator organizations have one extra billing step; farmer organizations finish sooner. (Total steps: 4 for operators, 3 for farmers.) Tap Continue.
Step 2 — Organization details:
- Organization name — required. (Example placeholders: "Smith Family Farm" for a farmer, "Aerial Insights Ltd." for an operator.)
- Address (optional) — a multi-line address field.
- Continue moves on; if the name is blank you'll be asked to enter one.
Step 3 — Invite your crew (optional). You can generate an invite code to share with your team now, or skip and do it later:
- Role picker — choose Pilot or Manager. This sets the role the invited person will have when they join. Changing the role clears any code you already generated.
- Generate invite code — creates a code. Once generated it's shown in large text, with a note that it expires in 7 days.
- Share code — opens your device's share sheet with a ready-made message: "Join my organization on Swath! Use invite code: [code]".
- For a farmer organization this is the last step, so the button reads "Finish — Create Organization" and tapping it creates the org and takes you into the app.
- For an operator organization the button reads "Continue" and there's also a "Skip for now" link; both take you to the billing step.
Step 4 — Payment & billing (Operator organizations only). "Tell clients how to pay you. Appears on invoices — you can update this later."
- Payment / billing details — a multi-line field (placeholder example: "E-transfer to payments@example.com · Net 30").
- Tax rate (%) — a number field that defaults to 15. A note explains it's applied as HST/GST on invoices, and you can set it to 0 to disable tax. If you leave it blank or type something that isn't a number, it falls back to 15.
- Finish — Create Organization — creates your organization and takes you into the app. There's also a "Skip for now" link, which also finishes and creates the organization (billing can be updated later).
When you create an organization, you become its admin, and (for operator orgs) your billing details and tax rate are saved.
Path B: Join with invite code
A short two-step path:
- Your full name — required. Pre-filled from your account if available.
- Invite code — required. Automatically uppercased as you type (placeholder shown as XXXX-XXXX).
- Join Organization — redeems the code and adds you to the organization with the role your admin assigned. If your name or the code is missing you'll be prompted; an invalid code shows an "Invalid code" message. On success you're taken into the main app.
Roles and organization types (quick reference)
- Organization types: Farmer or Operator. This is chosen when the organization is created and shapes the app (including which tabs appear). It can be changed later in settings.
- Roles: when you create an organization you're the admin. When you invite crew, you assign them a role of Pilot or Manager. People who join via a code get whatever role their admin's invite specified.
- Invite codes look like SWATH-XXXX-XXXX, are always entered in uppercase, and are single-use. (Note: the onboarding wizard's on-screen text says a generated code "expires in 7 days," while the Team screen — the main place codes are created — says codes expire in 14 days. If someone's code has stopped working, have the admin generate a fresh one from the Team screen.)
- Units: the tax rate is entered as a percentage and applied as HST/GST on invoices; set it to 0 to turn tax off. (No other units appear on these screens.)
Home (Dashboard)
The Home screen is the first thing you see when you open Swath. Its whole job is to answer one question fast: can I spray right now, and what's on today? It pulls together a live spray‑conditions verdict, the weather, your upcoming jobs, and quick shortcuts to create new work.
Choosing how Home looks (four layouts)
Home can be shown in one of four different layouts. They all show the same underlying information (spray verdict, weather, your jobs) but arrange it differently. The layout you see is a saved preference — you pick it elsewhere in the app (it is not switched from the Home screen itself), and Swath remembers your choice. The four layouts are:
- Verdict (the default) — a big coloured spray‑status card on top, then your upcoming jobs.
- Today — a vertical timeline of your day.
- Sky — a dark, weather‑forward screen with a wind ring and a 12‑hour spray‑window ribbon.
- Plan — a map of your day's route with numbered stops.
If you have never changed the setting, you get the Verdict layout. Everything below is described layout by layout. The spray verdict, the job list, the "+" button, and the account avatar work the same way in all of them.
Header and greeting
The top of the screen changes slightly depending on your layout:
- Verdict layout: A small line of grey text shows the name of the weather station Swath is reading from (or "LOADING…" until the weather arrives). Below it is a greeting: "Good morning", "Good afternoon", or "Good evening", followed by your first name if Swath knows it. The greeting is chosen by the clock on your phone — morning before 12:00, afternoon before 17:00, evening after that.
- Today layout: Shows today's date (for example "WEDNESDAY · JUL 23") with the title "Today".
- Plan layout: Shows today's date with the title "Your run".
- Sky layout: No station line; the big word on screen is the spray verdict itself.
Your name comes from your saved profile on the device (or a cached copy of it). If Swath doesn't know your name yet, the greeting simply drops the name.
Account avatar
Every layout has a round avatar button in the top‑right corner. It shows your initials (up to two letters, taken from your name). If Swath doesn't have your name, it shows a person icon instead. Tap the avatar to open your Account.
Weather / alert button (Verdict layout only)
Next to the avatar in the Verdict layout is a round cloud button. Tap it to open the full Weather screen. If spray conditions are currently anything other than "clear" (i.e. caution or do‑not‑spray), a small red dot appears on this button to warn you at a glance. That red‑dot warning can be turned off in your weather settings; if you've turned the weather badge off, the dot won't appear even when conditions are poor.
Sync status badge
Just under the header, every layout shows a Sync badge. This tells you whether your data (jobs, clients, fields) is up to date with the cloud or still waiting to sync. It's a small status strip, not a button you need to act on.
Update notice banner
At the very top of every Home layout, Swath may show an update notice banner when a new version or important notice is available. When present, it points you toward the "What's new" information (see the Updates section at the end).
The spray verdict card (Verdict layout)
This is the heart of the Verdict layout — a large card, coloured to match the current spray verdict:
- Green — "CLEAR TO SPRAY"
- Amber/yellow — "CAUTION"
- Red — "DO NOT SPRAY"
The verdict is calculated live from the weather for your chosen location and time. Swath weighs several factors together: wind speed, wind gusts, temperature‑inversion risk, and rain in the coming hours (including thunderstorms and how long a product needs to stay dry, called "rainfast"). If any factor is a problem, the verdict drops from clear to caution or to do‑not‑spray.
The card contains, from top to bottom:
- Location pill (left): shows the place the weather is for. Tap it to change the location (opens the location picker). Your location is either your live GPS position or a spot you set manually.
- Time pill (right): shows "Now" by default. Tap it to look ahead — a dropdown lets you pick a number of hours into the day so you can check whether conditions improve later. The choices run from now up to the remaining useful hours of the day (at least 4, at most 8 hours ahead).
- Verdict word (large): CLEAR TO SPRAY / CAUTION / DO NOT SPRAY. Shows "…" while the weather is still loading.
- Wind reading (right of the verdict): the current wind speed in km/h, the wind direction, and the gust speed (shown after "G"). If the gusts are over the safe limit, the gust number turns red.
- Spray window strip: a thin coloured bar showing the next 12 hours split into green (good), amber (marginal), and red (too windy) segments, so you can see how much of the window is usable. Beside it, Swath shows either "Closes ~[time]" (the first hour the wind is forecast to reach the caution range, 15 km/h or more) or "Window open" if no closing time is expected.
- Details toggle: tap "Details" to expand a panel with the full breakdown (see next). Swath remembers whether you left this open or closed.
Spray details panel (expanded)
When you tap Details, the card opens a white panel with hour‑by‑hour forecasts. Each row is colour‑coded (green good, amber marginal, red stop) and, if a factor is causing a caution/stop, a short reason is shown next to its heading:
- Wind (km/h) · next 7 h: wind for each of the next seven hours, with the gust ("G…") underneath. Values 20+ show red, 15–19 amber, below 15 green.
- Rain · next 7 h: rainfall amount per hour with the chance of rain (%) underneath. 4 mm or more is red, a trace over 0.2 mm is amber, dry is green.
- Inversion risk · next 7 h: a "Yes/No" dot for each hour showing whether a temperature inversion is likely. Tap the small info (i) icon for a plain‑English explanation. Swath flags an inversion when the modelled air higher up (80 m) is warmer than the air near the ground (2 m) and the wind is light (7 km/h or less). This is a modelled estimate, not a measurement — always confirm on site (calm air, lingering dew or fog, dust or smoke hanging low).
- Airspace line: Swath checks how close you are to an aerodrome (airport or heliport). If one is nearby, it shows the distance and name, warns you to verify airspace authorization, and notes the limit (1 nautical mile for a heliport, otherwise 3). Tap this line to open the NRC Drone Site Selection Tool in your browser. If nothing is nearby, it confirms "No aerodrome within [X] km". If your location isn't known, it reminds you that airspace was not checked — verify before flight.
Ask Swath Assist bar (Verdict and Sky layouts)
A dark bar labelled "Ask Swath Assist" (marked beta) with a sparkle icon. It's your in‑app helper for product rates, spray intervals, and restrictions drawn from label data. Tap it to open Swath Assist.
Upcoming Jobs (Verdict layout)
Below the assist bar is a tinted panel titled "UPCOMING JOBS". If you have jobs, the title also shows how many are displayed out of the total (for example "3 OF 3"). It lists up to five of your next jobs, soonest first.
Where the jobs come from: Swath reads your scheduled and draft jobs from the device that are not deleted, ordered by date. Each job's type is worked out automatically — it's a Scout job if it's a scouting mission, a Spread job if the payload is seed, fertilizer or granular, and otherwise a Spray job.
Each job card shows:
- A coloured type badge (SPRAY, SCOUT, or SPREAD) and the client name, plus a status chip (SCHEDULED, DRAFT, or COMPLETED).
- WHEN: the job date (and time, if set).
- WHERE: the field name (tappable) and crop. Tap the field name to open that field's page.
- Drive time: if Swath knows both your location and the field's location, it shows an estimated drive time (a rough estimate assuming about 65 km/h).
Tap anywhere else on a job card to open the full job. Tap "See all" to open the Jobs list. If you have no upcoming jobs, you'll see a card reading "No upcoming jobs · tap to schedule one" — tapping it starts scheduling a new job.
The "+" button and quick‑action menu (Verdict, Sky and Plan layouts)
A round green "+" button floats in the bottom‑right corner. Tap it to open a quick‑action menu with four shortcuts:
- New farm — add a field/farm.
- New client — add a client.
- New job — schedule a new job.
- Start a job (highlighted) — jumps straight into scheduling with "start now" turned on, for spraying right away.
Tap any option to go there, or tap the close/dark area to dismiss the menu.
Today layout (timeline view)
If your saved preference is Today, Home shows your day as a vertical timeline instead of the big verdict card.
- Condition bar: a coloured strip (green/amber/red) with an icon and the verdict word (CLEAR TO SPRAY / CAUTION / DO NOT SPRAY), plus a one‑line summary of the current temperature, wind speed and direction, and the spray‑window close time if there is one.
- SCHEDULE timeline: a rail with time markers:
- A pulsing "Now" dot coloured to match the verdict, showing the current time and status.
- Your next job as a timeline card (client, status chip, field names, and product names). Tap it to open the job.
- If the wind is forecast to rise into the caution range, a "Window closing" amber band appears at the closing time.
- A dashed "+ Schedule a job" card at the bottom — tap to schedule.
Note: this layout has an avatar button (to Account) but no separate weather button and no floating "+" button; you schedule from the timeline card instead.
Sky layout (dark weather‑forward view)
If your saved preference is Sky, Home shows a dark navy hero focused on the weather.
- Location and time chips at the top (same behaviour as the verdict card — tap the location chip to change location, tap the time chip to look ahead), plus the account avatar.
- Big verdict word ("Clear to spray", "Caution", or "Do not spray") with a short reason underneath, next to a circular wind ring showing the wind speed, direction, and gust (the gust turns red if it's over the limit).
- Spray window · next 12 h ribbon: a coloured bar of the next 12 hours with a "NOW" marker, tick labels every 3 hours, and a note showing either the next green (good) time with a checkmark, or the time the window closes.
- Details button — expands the same wind / rain / inversion / airspace breakdown as the verdict card, styled for the dark background.
- 5‑day weather button — tap to open the full Weather screen.
- Below, on the cream section: the Ask Swath Assist bar and a single "UP NEXT" job card (or a "No upcoming jobs" prompt). Tap the job to open it.
- The floating "+" button and quick‑action menu work as described above.
Plan layout (route map view)
If your saved preference is Plan, Home shows your day as a driving route.
- Slim verdict strip at the top (icon + verdict word + wind and window summary).
- Route map card: a map showing a blue "you" dot at your location, numbered pins for each job field, and a dashed line linking them in order. The footer shows the number of stops and an estimated total drive time ("Optimized from your location"), with a "Start" button — tap it to open turn‑by‑turn navigation to the first stop in your phone's maps app.
- If you have no scheduled jobs, the map area says "No scheduled jobs — tap + to schedule one". If your jobs have no field coordinates set, it says "No field locations set — add coordinates in Fields".
- AGENDA: the same up‑to‑five job cards as the Verdict layout, each numbered to match its map pin. Tap a card to open the job; tap a field name to open the field. Empty state prompts you to schedule a job.
- The floating "+" button and quick‑action menu work as described above.
Updates ("What's New")
Swath keeps a "What's new" screen (the Updates screen) that lists what has changed in the app. It opens as its own page with a back arrow in the top‑left — tap the back arrow to return to wherever you came from. From Home, you reach it via the update notice banner.
The screen shows:
- A force‑close reminder at the top: to actually receive the latest changes, force‑close the app and reopen it twice — updates download on the first reopen and apply on the second.
- A version pill showing the app version you're currently running (for example "Swath v1.4.0").
- A changelog — a dated list of updates, newest first. Each entry shows its date, an optional build/version badge, a title, and bullet points describing what changed.
This screen is for reading only — there is no "mark as read" action or dismiss button on the changelog itself; you simply read it and tap back when done. It does not require any input.
Jobs
The Jobs area is where you list, schedule, and manage every spray or scouting task. A "job" is one piece of work for one client (or one of your own fields, if your account is set up as a farm) on a given date: which fields, which product, how much area, who is flying, and what the weather looked like when it was done.
A note on wording: if your organisation is a spray operator, everything here is called a Job. If your organisation is set up as a farmer, the same screens call it a Task instead, and the client name is replaced by the task type. The behaviour is otherwise identical.
Jobs list
The Jobs list is the main tab where all your jobs appear. It opens showing the title (Jobs or Tasks) at the top.
Three ways to view your jobs. In the top-right corner there is a small toggle with three icons. Tap one to switch between:
- List (lines icon) — a simple scrolling list of job cards, sorted for you (see "Sorting" below). This is the default.
- Week (today/agenda icon) — a seven-day agenda starting on Monday. Each day is a heading with its jobs listed under it in start-time order; today is marked with a green TODAY badge. Use the left/right arrows to move a week back or forward, and tap the date range in the middle to jump back to this week. Days with no jobs show "No jobs".
- Calendar (calendar icon) — a month calendar. Days that have jobs show coloured dots (green for scheduled, amber for draft, grey for completed). Tap any day to see that day's jobs listed below the calendar. Days with nothing show "No jobs this day."
Whichever view you last used is remembered the next time you open the tab.
Status filter chips. Just under the header is a row of four chips: All, Draft, Scheduled, Done. Tap one to show only jobs of that status. (Internally "Done" means completed.) These chips apply in all three views.
Advanced filters. To the right of the view toggle is a filter button (sliders icon). If any advanced filters are active, a small number badge shows how many. Tapping it opens a Filters sheet where you can narrow the list by:
- Job Type — Pesticide, Seed, Fertilizer, or Scouting. You can pick more than one.
- Assigned Pilot — choose "Unassigned" or a specific pilot's name. (Only appears if some jobs have pilots assigned.)
- Equipment — choose "Unassigned" or a specific drone nickname. (Only appears if some jobs have equipment assigned.)
- Estimated Duration — under 1 hr, 1–2 hr, or over 2 hr.
Tap Apply Filters to use them, Clear all (top-right of the sheet) to reset everything. The status chips and the advanced filters work together, so you can, for example, show only Scheduled Pesticide jobs for one pilot.
Sorting. In the list view, jobs are ordered automatically: jobs with a date come first (undated jobs sink to the bottom), completed jobs are pushed toward the end, and within that everything is sorted by job date, soonest first. There is no manual re-ordering.
What each job card shows. In the list and calendar views, each job appears as a card with:
- Title — the client's business name (or, for a farm account, "Scouting · [type]" or "Task").
- Status badge — a small pill in the top-right: Scheduled (green), Draft (amber), or Completed (grey).
- Field line — the field name(s) and the area (in your chosen units).
- Product line — the pesticide product name(s), or "Scouting · [mission type]" for scouting jobs.
- Pilot / crew and drone — the assigned pilot and ground crew names, and the drone nickname with its model, if set.
- Duration and drive time — the estimated duration (e.g. "~1 h 30 m") and, if your phone location is available, a rough "~N min drive" estimate to the field.
- Spray Outlook — a short weather read-out for scheduled jobs with a date and location. It shows a coloured dot and a word — Favorable (green), Caution (amber), or Poor (red) — the job date, a mini wind bar for the day (green/amber/red segments by wind speed from about 5 a.m. to 5 p.m.), and a one-line reason. If the job has no date it says "Set a date to see the spray outlook"; if the date is too far out it says "Check closer to [date]"; if there is no field location it prompts you to add a field. Completed jobs instead show a "Logged" line with the wind recorded on the day.
In the Week view each row is more compact: the start time (or a time range if a duration is set), the title, status badge, field name, and pilot/crew/drone.
Opening a job. Tap any card or row to open the full Job detail screen.
Creating a job. There are two ways:
- The round + button (floating, bottom-right) — always available, opens the Schedule screen.
- If the list is empty, a large + Create Job (or + Create Task) button in the middle of the empty state does the same thing.
Empty state. When you have no jobs at all (after any role filtering), the tab shows a briefcase icon, the message "No jobs yet" (or "No tasks yet"), and the Create button.
Who sees which jobs (roles). The list is automatically filtered by your role:
- Pilots see only jobs assigned to them plus any unassigned jobs.
- Ground crew see only jobs where they are listed on the crew.
- Admins/managers (and other roles) see all jobs.
Creating & scheduling a job
Tapping + opens the Schedule Job screen (titled "Schedule Task" for farm accounts, or "Start a Job" if you came in from the home screen's "Start a job" shortcut, which pre-fills the date and time to right now). You fill in the cards top to bottom, then tap the button at the bottom to save and continue.
Client (spray operators only; hidden for farm accounts). Required. Type in the search box to find a client. Tap a name to select it (a green check appears). If no client matches what you typed, tap Add "[name]" as new client to create one on the spot — you will be brought back here with the new client already selected. Choosing a client resets any fields you had picked.
Job date. Required. Defaults to today. Tap the row to open a date picker and choose the day.
Job start time. Required. There is no default — you must open the picker and choose a time (the row is outlined in amber until you do). The one exception is starting a job "right now" from the home shortcut, which fills in the current time for you.
Fields. Appears once a client is selected (or always, for farm accounts). It lists the fields belonging to that client, each with its area in hectares. Tap to check the ones this job covers; you can select several. If the client has no fields yet, tap + Add field to create one and come back. When a field is selected, the app checks for nearby aerodromes and shows an aerodrome proximity warning if any are close.
Area to spray. Required. If you selected fields, the area is auto-calculated from them and shown as a hint ("Auto-calculated from N fields"). You can type your own number to override it. Use the ha / ac toggle to switch units; if you enter acres, the app shows the hectare equivalent underneath. You must either select at least one field or enter an area.
Drone / Equipment. Optional. Pick which drone you'll fly from the equipment picker.
Estimated Duration. Optional, in minutes. If your chosen drone has a known coverage rate, the app auto-estimates the duration from the drone and area (it shows "· auto-estimated from drone + area"). Once you type your own number it stops auto-filling. Tap the small i for an explanation of how the estimate is made. It also displays the value in hours and minutes. If the drone has no coverage rate on file, it tells you to enter the time manually.
Add Pilot & Crew. Optional. Pick one Pilot and, separately, any number of Ground Crew members by tapping their chips. If your organisation has no crew set up yet, a link takes you to add one and come back. Pilot and crew lists are synced from your organisation.
Job Type. Choose one of 🌿 Pesticide (the default), 🌱 Seed, 🪨 Fertilizer, or 🔍 Scouting. This choice decides which follow-on screen opens when you save (see below).
Billing Rate (spray operators only, and only if a rate exists for the chosen job type). The app pulls in the default rate per acre for that job type, with its label. Admins/managers can edit the rate here; other users only see it.
Notes. Optional free text — instructions, reminders, anything.
Saving — the "Next" button. The button at the bottom reads Next — mission config → for scouting jobs or Next — mix setup → otherwise. When you tap it the app:
- Checks the required fields — you'll get a "Required" alert if the client (operators), a field or area, or the start time is missing.
- Saves the job with status Draft.
- Sends you straight into the next step based on job type:
- Pesticide → the Mix screen (tank and product mix setup).
- Scouting → the Scouting mission screen (mission configuration).
- Seed or Fertilizer → the Spread screen (spreader setup).
So scheduling a job always flows straight into setting up its mix, spread, or scouting mission. The job is saved as a draft at this point regardless.
Job detail
Opening a job shows its full detail screen. The top bar shows the client name (or "Task"), the current status and date underneath, and two buttons on the right: a pencil (Edit) and a trash (Delete). Tapping the pencil turns on edit mode (it becomes a checkmark); most fields only become editable in this mode.
Overview card (top). Shows the field name(s), the client (or "Own field") with the area and crop, and the date. Below are three action buttons:
- Route — opens turn-by-turn directions to the first field with a saved location in your phone's maps app. If no field has a location, it tells you to add one.
- Call — dials the client's phone number. If none is on file, it says so.
- Start job — for jobs that aren't completed, this opens the Mission screen to fly the job. Once a job is completed this button is replaced by a greyed-out Completed marker.
Status & stats card. A three-way segmented control lets you set the status: Draft, Scheduled, or Done (completed). Below it are three figures — Area, Tank size (L), and Carrier volume (L/ha or L/AC). In edit mode these become editable, and two more rows appear to change the Job Date and Job Start Time (start time may be left "Not set" on an existing job even though it's required when first creating one).
Flight log card. Appears only when the job has equipment assigned and is marked completed. Enter the number of Flights and Flight Hours flown. When you save, these hours and flights are added to that drone's maintenance counters (and correctly adjusted if you later edit or un-complete the job).
Resources card. Shows and lets you set the Pilot, Crew, and Equipment (drone) for the job. The drone shows as its nickname and model; tap the "Drone" tag to clear it and pick another.
Scouting mission card. For scouting jobs only. Shows the mission type (Disease & Pests, Canopy Coverage, Orthomosaic, Stand Count, or Custom) and any subtype, plus whether standard or custom settings were used. For custom settings it lists drone height (ft), side/front overlap (%), sample area, and sensors (RGB or RGB + MS).
Product cards. For non-scouting jobs, each product is shown as a card. Read-only, it shows the category (Pesticide / Seed / Granular / Liquid), the product name, its rate (converted to per-acre if you use imperial units), and for pesticides the target crop and pest. In edit mode you can change the category, search the Health Canada registry for a pesticide (or type seed/fertilizer/liquid product names, with quick-pick chips for common cover-crop seeds and granular fertilizers), set the rate and its units, and enter crop and pest. Use Add Product to add another and the red ✕ to remove one.
Aerial label check. For a pesticide whose Health Canada registration is only conditionally approved for aerial use, a label-check card appears. You must confirm you've checked the label (recording the use site and pest). You cannot mark the job Done until this is confirmed for every such product — trying to save shows a "Label check required" alert listing them. Once confirmed, the card becomes an amber "Aerial approval confirmed" strip showing when it was checked.
Mix Details panel. For non-scouting jobs with a valid tank size, area, carrier volume, and at least one product, a dark panel shows the calculated tank mix (loads, water, product totals, etc.).
Safety — Rainfast period. Shows the rainfast hours for the job, with a reminder to verify on the product label ("apply 0 if unknown"). Editable in edit mode.
Notes. Free-text notes, editable.
Conditions at application. A read-only weather record that appears once the job has been completed. When you first mark a job Done and live weather is available, the app stamps the temperature, wind speed and direction, gusts, humidity, and inversion status, and records the time. This audit record is preserved on later edits.
Buttons at the bottom.
- Save Changes — saves everything. If you set the status to Done, the completion checks (aerial label check) run first. On success it confirms "Job updated" and returns to the list. Saving also handles the weather capture and drone maintenance accrual described above.
- Export application record (PDF) — appears only for completed jobs. Generates a spray/application record as a PDF and opens the share sheet so you can send or save it.
- Send client invoice — appears only for admins/managers on spray-operator accounts. Opens the Invoice screen for this job.
Delete. The trash icon in the top bar asks for confirmation ("This cannot be undone"), then removes the job. (Technically it is soft-deleted and hidden from all lists.)
Job status model (summary). Every job has one of three statuses: Draft → Scheduled → Done (completed). New jobs are created as Draft. You can move a job to any status freely using the segmented control on the detail screen — there is no forced order — except that marking a job Done is blocked until the aerial label check is confirmed for any conditionally-approved pesticides. Completing a job also triggers the one-time weather capture and adds flight hours/flights to the drone's maintenance counters.
Job Workflows (Mission, Spread, Scouting, Mix, Invoice)
Each job you open in Swath can lead into one of several workflow screens depending on what kind of work you are doing. This section explains each screen: what it is for, every field you fill in, every button, and what the app does when you save or finish. All of these screens are reached from inside a single job, and they all read and write to that job.
A quick way to think about the difference between the two application workflows:
- Spray Mission is a live, timed liquid-spray flight. It runs you through a preflight checklist, times the actual spray, records weather at the moment you start, and produces a permanent, signed flight record for aviation recordkeeping. Use this when you are spraying pesticide from the tank.
- Spread is a granular application (dry fertilizer or seed spread through the drone's dry hopper). It is a bag-count calculator and product record, not a timed flight, and it does not produce a flight record.
Spray Mission (live flight logging)
What it is for: This is the screen you run while you are physically at the field about to spray liquid. It walks you through three stages — a preflight checklist, a running spray timer, and a completion/attestation step — and when you finish it marks the job complete, adds the flight hours and flight count to your drone's maintenance totals, and saves a permanent flight record for your aviation records (Canadian Aviation Regulations 901.48).
The screen moves through four phases in order: Preflight → Spraying → Complete (log the application) → Attest.
Phase 1: Preflight
When the screen opens it loads the job's details and shows them at the top: client name, field name(s), area in hectares, the products (pesticides) on the job, and the assigned drone with its Transport Canada registration. If no drone is assigned, you will see a warning that maintenance won't be tracked.
Certificate check. The app looks for your Advanced RPAS certificate stored in the app (under More → Certificates). If it is missing or expired, a red warning appears at the top telling you to add or renew it before flying. This does not physically block you, but the missing/expired status is recorded on the flight record.
Weather verdict. A coloured bar shows the current spraying verdict based on live weather and the product labels on the job:
- Green — "Conditions clear for spraying."
- Yellow — "Caution — monitor conditions."
- Red — "Do not spray — conditions outside limits," with the specific reason (for example wind over the label limit).
The verdict uses the tightest (lowest) wind limit across every product on the job, so it always agrees with what the job card shows. A separate rain banner may appear at the top if heavy or light rain is forecast.
Preflight checklist. You must tick every item. Items are grouped into categories, and some carry a small aviation reference tag (CARs 901.27 site survey items). A counter shows how many of the total you have checked. You cannot start the spray until all items are checked.
Aerodrome / airspace check. The app checks whether any aerodrome (airport, heliport, etc.) is within 3 nautical miles of the field:
- If none is nearby, you see a green line: "Airspace: no aerodrome within 3 NM of this field."
- If one is nearby, a warning appears and you must tick an extra confirmation asking whether an SFOC (Special Flight Operations Certificate) has been granted for flying within that distance of the named aerodrome. This tick is required before you can begin.
Buttons:
- Begin spray — Only works once every checklist item (and the SFOC acknowledgement, if shown) is ticked. If you press it early, you get a reminder to finish the checklist. When it works, it captures the current weather as your start-of-spray snapshot, records the start time, and starts the timer.
- Emergency — Opens an emergency information sheet showing province-specific emergency contacts, your drone details, and the pesticides on the job (useful in a spill or incident). Available during preflight and while spraying.
- Close (X) — Leaves the screen. During preflight it just goes back.
Phase 2: Spraying
A large running timer counts up while you spray, showing the client and drone name underneath.
Buttons:
- Complete spray — Stops the timer, records the end time, pre-fills your flight hours from the elapsed time, and moves to the completion step.
- Emergency — Same emergency sheet as above.
- Close (X) — Warns you that the spray is in progress and that leaving won't save the timer or complete the job. You confirm "Leave" or "Stay."
Phase 3: Complete — log the application
This step shows the elapsed time and asks you to confirm two numbers:
- Flight hours — Pre-filled from the timer (as a decimal, e.g. 1.5). The hint tells you to adjust it to your drone's actual flight time. Decimal entry.
- Flight count — The number of flights/loads, which you read from your controller. Whole numbers. Not pre-filled.
If a drone is assigned, a note reminds you these numbers will count toward that drone's maintenance. If no drone is assigned, it warns maintenance won't be updated.
Button:
- Continue → Attest record — Moves to the attestation step.
Phase 4: Attest — pilot-in-command attestation
This is a read-only review of the flight record before you sign it. It shows a summary card with:
- PIC (pilot-in-command) name
- Advanced RPAS certificate number and expiry (flagged in red if missing or expired)
- Crew names (if any)
- Start time, end time, and duration
- Field name and province
- Nearest aerodrome and its distance
- Weather captured at start (wind, gusts, temperature in °C)
- Drone (nickname, model, registration)
- Site survey result (how many of the 901.27 checklist items were checked)
Below the summary is the attestation statement you are agreeing to: that the information is accurate and complete to the best of your knowledge and that the flight was conducted in accordance with the Canadian Aviation Regulations.
Buttons:
- Attest & complete job — Saves everything (see below) and returns you to the job. Shows "Saving…" while it works.
- ← Back to log — Returns to the previous step to change the hours or count.
What "Attest & complete job" actually does
When you attest, the app:
- Updates drone maintenance. It adds your flight hours and flight count to the assigned drone's hours-since-service, flights-since-service, and lifetime totals. If this job had been completed before, it first reverses the earlier amounts so the totals don't double-count.
- Marks the job completed and stamps the start time, end time, flight hours, and flight count onto it.
- Captures the weather onto the job (wind speed, wind direction, temperature °C, gusts, humidity, inversion status, condition) — but only if the job did not already have weather captured earlier.
- Writes a permanent flight record for your aviation recordkeeping (CARs 901.48). This record is a fixed snapshot and includes: PIC name and certificate details (and whether the cert was expired), crew, start/end/duration, field name and map location, province, nearest aerodrome and distance, the start weather, the drone's nickname/model/registration, the full preflight/site-survey checklist result, the product list (name, PCP registration number, rate), whether the NOTAM was checked, and your attestation name and time.
- Syncs the record to the cloud in the background (best effort; it still saves locally if offline).
Location note: During a mission the app tries to read your phone's GPS to record the province and field location, because you are physically at the field. If GPS isn't available it falls back to the field's saved map pin, and then to the client's province on file.
Spread (granular fertilizer or seed)
What it is for: This screen helps you work out how many bags of dry product (fertilizer or seed) you need for a job, how many hopper loads that is for your drone, and it saves the product and rate onto the job. Unlike a Spray Mission, there is no timer, no checklist, and no flight record — it is a planning calculator plus a product record.
The screen title reads "Seed Spread" or "Fertilizer Spread" depending on how you arrived. Which one you get is determined by the job's payload type. The field area, area unit, and the assigned drone are all passed in from the job automatically.
Fields
Product (Seed / Fertilizer). A search box. Type to filter a built-in list of seeds or fertilizers.
- For seeds, each suggestion shows a typical rate range in lb/ac.
- For fertilizers, each suggestion shows its N-P-K grade.
- Select a match from the dropdown, or if nothing matches, whatever you typed is used as a custom product name.
- Admin users also see a "+ Add new seed/fertilizer" option (see below).
Rate (lb/acre). The application rate in pounds per acre. Decimal entry. Required (must be greater than 0). If you picked a seed with a known rate range, a hint shows the typical lb/ac range for reference — but the rate you enter is treated as operator-entered and confirmed by you.
Pounds per bag. How many pounds are in one bag of the product. Defaults to 50. Only digits and a single decimal point are accepted. If you leave it blank it falls back to 50; if you enter 0 or a negative number it is invalid and flagged in red, and you cannot save.
Result (calculated live)
Once you have a product, a rate, and a valid bag weight, a result card shows:
- Headline — the number of bags you'll need of the named product for this job.
- Secondary line — total pounds, at your rate, over the area in acres.
- Hopper loads — an estimate of how many times you'll need to refill the drone's dry hopper, shown only if the drone's dry capacity is known. It names the drone and its dry capacity in kilograms. If capacity isn't known, it tells you to add the drone's spreader capacity, or to select equipment on the schedule screen, to see hopper loads.
- Disclaimer — reminds you to verify the rate against the actual seed/fertilizer label; this is a planning aid.
Below that, an area reminder restates the job area in both units (e.g. hectares with acres in brackets, or the reverse).
Buttons
- Save & go to job → — Requires a product name, a rate greater than 0, and a valid bag weight. It saves a product record onto the job (product name, the rate in lb/ac, the bag weight, marked as a dry seed or granular payload, and the calculated total pounds) and returns you to the job.
Adding a new product (admin only)
If you are an admin, the "+ Add new" option opens a form:
- Name (required)
- For seeds: Category (cereal, legume, brassica, grass, or broadleaf) and Season (spring, fall, or any), chosen as chips.
- For fertilizers: Grade (N-P-K), optional (e.g. 28-5-10).
- Rate min, Rate max, Rate default — all in kg/ha, all required and all greater than 0, and they must satisfy min ≤ default ≤ max.
- Notes — optional.
- Add & Select — Saves the new product to the shared product list and immediately selects it for this job.
Scouting (mission configuration)
What it is for: This screen sets up the parameters for a scouting/imaging flight over the job's field. It does not fly or time anything — it records what kind of scouting mission you want and the camera settings, saving them onto the job. The screen title is "Mission Config."
Fields
Mission Type (required). Pick one:
- Disease & Pests
- Canopy Coverage
- Orthomosaic
- Stand Count
- Custom
Subtype (only for Disease & Pests, and then required). Pick Statistical or Pest Corridor Validation.
Settings (shown for the four non-custom types). A toggle between Standard and Custom. Standard uses preset flight settings; Custom lets you enter them yourself. If you chose the "Custom" mission type, custom settings are always on.
Custom Settings (shown when Custom is selected, either as the mission type or the settings mode):
- Drone Height (feet) — Required, must be greater than 0. Decimal entry. Note this field is in feet, not metres.
- Side Image Overlap (%) — Required, must be between 10 and 80. The field automatically clamps what you type into that range.
- Front Image Overlap (%) — Required, must be between 10 and 80, also auto-clamped.
- Sample Area — Shown only for Disease & Pests, Canopy Coverage, and Stand Count. Required when shown. Pick one chip: 1,000 sq ft, 5,000 sq ft, 10,000 sq ft, 20,000 sq ft, 1 ac, or 2 ac.
- Sensors Required — Shown only for the Custom mission type. Toggle between RGB and RGB + MS (multispectral).
Button
- Save & Continue → — Validates your choices (mission type required; subtype required for Disease & Pests; and if custom fields are shown, height/overlaps/sample area must all be valid). It saves the mission type, subtype, settings mode, drone height, side and front overlap, sample area, and sensor choice onto the job, then returns you to the job.
Mix Setup (tank mix entry point)
What it is for: This is a short landing screen that sends you into the tank-mix calculator for a liquid spray job. It figures out your area and tank size from the job automatically, then lets you choose how you want to work through the mix. The screen title is "Mix Setup."
What it shows
A context banner confirms what the app already knows from your job:
- Area — the sprayable area in hectares, taken straight from the job.
- Tank — if a drone is assigned, the tank size in litres is auto-filled from the drone's model (or its saved payload capacity). If no drone is assigned, it tells you that you'll enter tank size manually in the calculator.
Choices
- Guided walkthrough — Recommended for first-timers ("Best for first-timers" badge). Steps you through the mix starting from spray-per-hectare, with area and drone already filled in.
- Quick calculator — All fields on one page, with area (and tank, if known) pre-filled. For operators who already know the flow.
- How mixing works — plain guide — A help link that opens a plain-language explanation of how mixing works.
The app remembers which mode (guided or quick) you used last time. Choosing either mode carries the job, the sprayable area, and the tank size and drone name into the mix calculator.
Note: the actual mixing calculations and product/rate entry happen in the mix calculator screens that this page opens; they are documented separately.
Client Invoice
What it is for: This screen builds a PDF invoice for the job's client and shares it. It pre-fills as much as it can from the job, the client, and your organization's settings, and lets you edit everything before generating. The screen title is "Client Invoice."
When it opens it loads your organization details (name, address, logo, billing details, and tax rate — defaulting to 15% if none is set) and the job's client and billing information.
Fields
Bill To
- Client — Shown as read-only, taken from the job.
- Recipient Name — Pre-filled from the client's billing contact (or client name). Editable — this is the name that appears on the invoice.
- Recipient Email — Pre-filled from the client's billing contact email. Editable. This is who the invoice is addressed to; if filled, the screen shows "Sending to: …" near the bottom.
Work Line
- Description — Pre-filled based on the job's payload type (for example "Pesticide application," "Seeding application," "Fertilizer application," or "Scouting application"). Editable.
- Rate ($/ac) — Pre-filled from the job's billing rate per acre. Decimal entry.
- Acres — Pre-filled by converting the job's area in hectares to acres. Decimal entry.
- Line total — Calculated automatically as rate × acres, shown in dollars.
Additional Items — Optional extra charges. Use Add item to add a row with a description and a dollar amount; the red circle removes a row. You can add as many as you like.
Custom Note — An optional free-text note to print on the invoice.
Summary (calculated live):
- Subtotal — the work line total plus all additional items.
- HST (tax %) — the subtotal times your organization's tax rate (15% by default; labelled HST).
- Total — subtotal plus tax.
Button
- Generate & Send Invoice — Assigns the next invoice number, dates the invoice today, and builds a PDF using your organization's branding (name, address, logo, billing details) and all the values above. It then opens your device's share sheet to send or save the PDF. If sharing isn't available, it tells you where the PDF was saved. In the background it also saves an invoice record (number, date, subtotal, tax rate, tax amount, total, note, and recipient) linked to the job and client. Shows "Generating…" while it works.
Fields
Fields are the pieces of land you work on. Each field has a name, an area, and a location on the map, and it can be linked to a client, given a crop, and marked up with hazards. Once a field exists, it can be added to jobs and its service history builds up automatically.
Areas are shown in the units set in your app settings. Hectares (ha) is the app's base unit — everything is stored in hectares behind the scenes — but you can type and view areas in acres (ac) too, and the app converts for you.
Fields list
The Fields tab is where all your fields live. It has two layouts depending on how you hold your phone.
Portrait (upright) layout
- Map at the top. A satellite map fills the top of the screen. It shows a blue dot for your current location and a coloured pin for every field that has a location saved. Tapping a field's pin opens that field's detail screen. A small badge in the corner shows how many fields you have (for example "12 fields").
- Recenter button. Tap the round locate button on the map to snap the map back to your current position.
- Map view button. Tap "Map view" to turn your phone sideways into the full-screen map (see the landscape layout below).
- Title and totals. Below the map, the heading reads "Fields" followed by the total count and the combined area of all your fields (for example "12 · 340 ha").
- Filter / sort row. A row of tappable chips lets you change how the list is ordered:
- Closest — sorts fields by how far they are from you right now (nearest first). This needs location permission; without a location fix the order doesn't change.
- By client — tap once to show a dropdown of clients that have fields; pick one to show only that client's fields. Tap the chip again to reopen the dropdown.
- By crop — tap to show a dropdown of every crop used on your fields, plus an "All crops" option. Pick one to show only fields with that crop. If no fields have a crop set yet, the dropdown says so.
- Upcoming — sorts fields by their next scheduled or upcoming job, soonest first. Fields with no upcoming job drop to the bottom.
- Field cards. Each field appears as a card. Tap a card to expand it.
- The collapsed card shows the field name, an area chip (only if an area is saved), the client name, and the distance from you. If the field's most recent job is completed, it also shows a "Done
" note. - Expanded, the card shows three quick stats: Times serviced (how many completed jobs the field has had), Last visit (date of the most recent completed job, or a dash if none), and Current crop.
- Expanded, it also shows two buttons: Directions (opens turn-by-turn directions to the field in your maps app) and Field details (opens the full field detail screen).
- The collapsed card shows the field name, an area chip (only if an area is saved), the client name, and the distance from you. If the field's most recent job is completed, it also shows a "Done
- Add button. The round blue "+" button in the bottom-right corner opens the Add New Field screen.
Landscape (sideways) layout
Turning your phone sideways (or tapping "Map view") switches to a full-screen satellite map of all your fields:
- Fields that have a drawn boundary appear as shaded outlines with a name label; fields with only a pin appear as a labelled marker. Tapping any field jumps to its detail screen.
- A badge shows how many fields are in view and their combined area.
- A radius control lets you limit the map to fields within a chosen distance of you: 25, 50, 100, 150, or 200 km (the default is 100 km). If your location isn't available, all fields are shown regardless.
- Zoom "+" / "−" buttons and a locate button sit in the corner. Tap the phone-portrait icon to return to the normal upright view.
Empty state
If you have no fields, the map simply shows no pins and the list is empty. Tap the "+" button to add your first field.
Adding a field
Tap the "+" button on the Fields tab to open Add New Field. The screen is split into two cards: Location and Field details. Tap the X in the top-left to cancel without saving.
Location card
- Client — a client picker. This lets you link the field to one of your clients. (This field is hidden if your account is set up as a farmer account, since a farmer's fields don't need a separate client.) Choosing a client is optional.
- How do you want to place it? — three ways to set the field's location, chosen with the Pin / Address / Draw buttons:
- Pin — a map you tap to drop a single pin at the field. You can drag the pin to fine-tune it, or clear it to start over. This just marks one point, not the shape of the field.
- Address — a search box where you type the field's address. When you pick a suggestion, the app looks up its coordinates and drops a pin there automatically; you can then drag that pin to fine-tune it. If the address can't be found, the app tells you to switch to Pin and tap the map directly.
- Draw — a boundary editor where you trace the outline of the field on the map. As you draw the outline, the app calculates the field's area and fills it into the Area box for you automatically, so you don't have to measure it yourself. The boundary editor is also where hazards can be marked (water boundaries, no-fly / obstacle zones), which then appear on the field's maps.
- Aerodrome warning — if you draw a boundary that sits close to an aerodrome (airport/airfield), the app shows a warning listing the nearby aerodromes. This is a safety heads-up for flying near airfields; it doesn't stop you saving.
Field details card
- Field name (required) — a short name for the field, for example "Up Home 7". You can't save without one.
- Area (required) — the size of the field. Type a number and choose the unit with the ha / ac toggle. The toggle defaults to acres if your app is set to imperial units, otherwise hectares. If you enter acres, a small line underneath shows the equivalent in hectares. If you drew a boundary, this box is filled in for you but you can still change it. You can't save without an area.
- Crop — the crop growing on the field, for example "Potatoes". Optional.
- Notes — a free-text box for anything useful about the field, such as access, hazards, or obstacles. Optional.
Saving
The Save field button stays greyed out until both a field name and an area are filled in. When you save:
- The area is converted to hectares for storage (acres are converted automatically).
- The location is saved from whichever placement method you used. If you drew a boundary, the field's map point is taken from the centre of that boundary; otherwise it uses your pin or address point.
- The field is marked to sync to the cloud.
If you opened Add Field from another screen (for example while scheduling a job or from a client's page), saving hands the new field straight back to that screen so you can keep going. Otherwise it returns you to the Fields list.
Field detail
Tapping a field (from a card's "Field details" button, a map pin, or the list) opens the field detail screen. It shows everything known about the field.
Header
The field name sits at the top, with a back arrow on the left and an Edit link on the right. Edit opens the full Edit Field screen (described below).
Map preview
- If the field has a drawn boundary, the map shows the field outline along with any hazards you've marked: water boundaries, no-fly / obstacle zones (shown with warning markers), and no-spray areas.
- If the field has only a pin (no boundary), the map shows a simple marker at that point.
- If the field has no location at all, this area shows "No location on file".
- Tap Expand to open the field full-screen in landscape, which adds a map legend (Field boundary, Water boundary, Obstacle / hazard) and a slim info panel. Pinch to zoom and tap a marker for detail; tap the phone-portrait icon to return.
Distance strip
A dark strip under the map shows how far the field is from you and a rough drive time (for example "8.3 km · ~14 min drive"). Its Directions button opens turn-by-turn navigation to the field.
Info chips
Three chips show:
- Client — the linked client's business name (or a dash if none). Tapping it opens that client's page.
- Crop — the current crop (or a dash).
- Area — the field's area.
Notes
If the field has notes, they appear in their own card.
Previous services
A table lists every completed job on this field, newest first, with:
- the date of the service,
- the service type shown with a coloured dot and label — Spray (pesticide), Spread (fertilizer or seed), or Scout (scouting) — plus the first product used where relevant,
- a View link that opens that job.
If the field has never had a completed job, it reads "No completed services yet."
Delete
At the bottom, Delete Field asks you to confirm, then removes the field. (It's a soft delete — the field is marked deleted and hidden, then synced.)
Editing a field
Tap Edit on the field detail screen to open Edit Field. This is the same screen as Add New Field, with the same Location and Field details cards, but pre-filled with the field's current information:
- The client, name, crop, area, and notes are all filled in.
- The area shows in your current unit (acres or hectares) and can be changed with the ha / ac toggle.
- The placement section opens in Draw if the field already has a boundary, otherwise on the Pin map. You can switch between Pin, Address, and Draw to change the location the same way as when adding, and re-drawing the boundary re-fills the area.
- If you draw a boundary near an aerodrome, the same aerodrome warning appears.
Field name and Area are still required — the Save changes button stays greyed out until both are filled. Saving updates the field (converting acres to hectares as needed), re-derives the map point from the boundary centre if you're in Draw mode, marks the field to sync, and returns you to the detail screen, which refreshes to show your changes.
Clients
Clients are the farms and businesses you spray for. Each client can have contact and address details, a set of fields (the actual land you service), a job history, and billing information. This section explains how to find, add, view, and edit clients.
Clients list
The Clients tab shows every client saved on your device.
Finding your way around the top of the screen
- The heading reads "Clients" with the total number of clients in brackets beside it, for example "Clients (12)".
- There is a + button in the top-right corner of the header. Tap it to start adding a new client.
- There is also a round + button (FAB) floating in the bottom-right corner of the screen that does the same thing — it stays visible while you scroll.
- Below the heading is a search box with the prompt "Search name, phone, email". As you type, the list filters instantly. Search matches the business/farm name, the contact name, and the phone number. You can clear the search using the small clear button that appears while editing.
What each client card shows (collapsed)
Each client appears as a card. Without tapping, you can see:
- A round avatar with the client's initials.
- The business/farm name in bold.
- A subtitle line underneath showing the contact name and the location (municipality and province), separated by a dot — for example "John MacNeil · Rustico, PE". If there is no contact or location, this line is hidden.
- An "N upcoming" chip on the right side if the client has any upcoming scheduled jobs (jobs that are scheduled and dated today or later). Clients with no upcoming work do not show this chip.
- A chevron (down when closed, up when open).
Expanding a card
Tap a card to expand it. The first time you open a card the app loads its stats, so you may briefly see dashes ("—") before numbers appear. When expanded you see:
- A stats block with:
- Acres serviced — the total area sprayed on completed jobs for this client, shown in acres.
- Invoiced — the total dollar amount invoiced to this client (shown in Canadian dollars). This column only appears if you are an admin or manager. Operators without those permissions do not see it.
- Upcoming — the number of upcoming scheduled jobs.
- An actions row with two buttons:
- Call — dials the client's phone number. If the client has no phone number saved, this button is greyed out and does nothing.
- Client details — opens the full Client detail screen (see below).
Tap the card again to collapse it.
Empty state
If you have no clients yet — or if your search matches nothing — the list area shows a people icon, the message "No clients yet", and an "+ Add Client" button that takes you to the Add client screen.
Adding a client
Reach this screen by tapping either + button on the Clients list (or the "+ Add Client" button in the empty state). The screen is titled "New Client". Tap the X in the top-left to cancel and go back without saving.
The form is grouped into three cards.
Contact card
- Business / farm name — required. This is the only field you must fill in. Example placeholder: "e.g. MacNeil Farms". Words are auto-capitalised.
- Contact name — optional. The person you deal with. Auto-capitalised.
- Phone — optional. As you type, the number is automatically formatted, for example "(902) 555-0148". Uses a phone keypad.
- Email — optional. Uses an email keyboard and is not auto-capitalised or auto-corrected.
Address card
The card is marked with a "🇨🇦 CANADA" tag. You can fill the address two ways:
- Use the address lookup field at the top to search for and select an address. When you pick a result, the app fills in the street address, municipality, province, and postal code for you. There is also a "Can't find it? Enter address manually" option.
- Or type the address yourself:
- Street address — optional.
- Municipality — optional (e.g. "Rustico"). Auto-capitalised.
- Postal code — optional. Automatically formatted (e.g. "A1A 1A1") and shown in capitals.
- Province — choose one by tapping a province chip. All 13 Canadian provinces and territories are available. Prince Edward Island (PE) is selected by default.
Notes card
- Notes — a free-text box for anything useful, such as a gate code, the best time to reach the client, or field notes.
Note: The Add client screen does not include billing-contact fields. You can add those later on the Edit client screen.
Saving
Tap Save client at the bottom. The button stays greyed out until you have entered a business/farm name; if you try to save without one, you get a "Business / Farm name is required" message. While saving, the button reads "Saving…". After a successful save you return to the previous screen. (If you arrived here from another flow such as scheduling a job, saving hands the new client back to that flow automatically.)
Client detail
Opening a client (via "Client details" on the list) shows everything about that client on one scrolling screen. The header has a back arrow, the title "Client", and an Edit link in the top-right that opens the Edit client screen.
Identity
At the top you see a business icon, the business/farm name, and a line reading either "[Contact name] · Contact" or "No contact on file".
Contact info and quick actions
If the client has at least one of a phone, email, or address, you see:
- A row of quick-action buttons:
- Call — dials the phone number (only shown if a phone number exists).
- Directions — opens the address in your maps app for navigation (only shown if an address exists). This works even if the location could not be pinned on the mini-map.
- Email — starts an email to the client (only shown if an email exists).
- A contact card listing each saved detail — Phone, Email, and full Address — that the client has.
- A small map of the client's location, with an "Open in Maps" button, whenever the address can be located. If the app is offline or the address cannot be found (for example a rural address the map service doesn't recognise), the map is simply skipped — no error is shown, and Directions still works.
If the client has no phone, email, or address, this whole area is replaced by a prompt card titled "No phone, email or address yet" with an "Add contact info" button that takes you to the Edit screen.
Billing contact
If the client has any billing-contact details saved, a "Billing contact" card shows the billing name, phone, and/or email. (This card is hidden if none are set.)
Notes
If the client has notes, they appear in a "Notes" card.
Fields serviced
A "Fields serviced" card lists the client's fields, with a "+ Add field" link in the corner that opens the Add field screen already linked to this client (and returns you here afterward). For each field you see:
- The field name, its area, and a chevron. Tap a row to open that field's detail screen.
- Last serviced — the date of the most recent completed job on that field (or "—" if none).
- Next scheduled — the date of the next upcoming scheduled job (or "None scheduled").
If there are no fields yet, it reads "No fields on file yet."
Invoices
An "Invoices" card appears only if you are an admin or manager. It lists each invoice with its number, total (in Canadian dollars), and date, most recent first. If there are none it reads "No invoices yet." Operators without manager/admin permission do not see this card at all.
Deleting a client
At the bottom is a Delete Client button. Tapping it asks you to confirm ("Delete [business name]?"). If you confirm, the client is removed and you return to the previous screen. (The deletion is marked to sync to the server.)
Editing a client
Reach this screen by tapping Edit on the Client detail screen (or "Add contact info" from the empty contact prompt). It is titled "Edit Client". While it loads the current details you'll see a brief spinner. Tap the X in the top-left to cancel.
The Edit screen has the same Contact, Address, and Notes cards as the Add screen, pre-filled with the client's current information, plus one extra card:
Billing Contact card
- Name on invoices — optional. The name that should appear on invoices. Auto-capitalised.
- Billing phone — optional. Automatically formatted like the main phone field.
- Billing email — optional, described as the "Default invoice recipient". Uses an email keyboard.
Saving changes
As with adding, the business/farm name is required — the Save Changes button stays greyed out until it is filled, and saving without it shows the "Business / Farm name is required" message. Empty optional fields are cleared (saved as blank). While saving, the button reads "Saving…". After saving you return to the Client detail screen, and the change is marked to sync to the server.
Equipment, Certificates & Calibration
This section covers the three tools that keep your drones and paperwork in order: the Equipment list (with maintenance tracking and service logs), the Certificates list (for your Transport Canada RPAS certificate, pesticide applicator licence, and similar documents), and the Drone Calibration flow-rate helper.
Equipment list
This screen shows every machine you have added, sorted so that anything needing attention floats to the top.
What you see:
- A header titled Equipment with a back arrow on the left and a + (add) button on the right.
- A summary line showing how many machines you have (for example "3 machines") and, on the right, either "All up to date" or, in amber, how many "need service".
- A card for each machine showing its nickname, the model underneath (or the manufacturer and model you typed, or "Custom" if none), and a maintenance meter (a small gauge showing how much of the service interval has been used up for flights and hours).
How the list is ordered: machines are grouped by maintenance status, with overdue first, then due soon, then up to date (ok), and within each group they are sorted alphabetically by nickname. The "need service" count in the summary only counts machines that have a maintenance schedule and are either overdue or due soon.
Actions:
- Tap the + button (top right) to add a new machine.
- Tap any machine card to open its detail screen.
- Tap the back arrow to leave the Equipment area.
If you have no equipment yet, the screen shows a "No equipment yet" message with an + Add Equipment button instead of the list.
Adding equipment
Reach this screen by tapping the + on the Equipment list. The header is Add Equipment; the X (close) button at top left cancels and returns you without saving.
Fields, in order:
- Nickname * (required) — a friendly name for the machine, for example "The Beast". You cannot save without this.
- Model * (required) — tap "Select a drone model" to open a picker. The picker has three groups:
- Spray Drones — DJI spray models, each listed with its routine service interval (shown as "X flights / Y h").
- Other Drones — non-spray DJI models, each marked "No maintenance schedule".
- Other / Custom… — pick this for any machine not in the lists (including non-DJI equipment). Choosing a listed model automatically fills the Manufacturer & Model text and, if the model has a known tank size, pre-fills the payload capacity. You cannot save without choosing a model or picking Other / Custom.
- After you pick a listed model, an information card summarises its schedule, either "Routine inspection every X flights or Y hours, whichever comes first." or "No scheduled maintenance requirements for this model."
If you choose Other / Custom…, extra fields appear:
- Type — a row of choices: Drone, Scout, Ground Rig, Other. (Drone is selected by default.)
- Manufacturer & Model — free text, for example "Hylio AG-272".
- Maintenance interval (optional; leave blank to skip tracking) — two boxes:
- Every (flights) — whole number.
- Every (hours) — allows decimals.
The remaining fields apply to every machine:
- Serial Number (optional) — typed in capital letters automatically.
- Tank / Payload Capacity (L) (optional) — the tank size in litres, for example 40.
- Transport Canada / RPAS Registration (optional) — your registration number.
- Current usage since last service (optional, for a machine already in use) — two boxes:
- Flights since service — whole number, defaults to 0.
- Hours since service — allows decimals, defaults to 0.
- Notes (optional) — free text.
Tap Add Equipment to save. The button shows "Saving…" while it works, then returns you to the list. If the nickname or model is missing you get a "Required" message; if something goes wrong you get "Could not save equipment."
Note on type: for a listed model the type is set automatically from that model (usually "drone"); for a custom machine it comes from the Type buttons you chose.
Equipment detail
Opened by tapping a machine on the list. The header reads Equipment, with a back arrow, an edit (pencil) icon, and a delete (trash) icon at top right.
What it shows:
- The machine's nickname and, underneath, the model name (or your manufacturer/model text, or "Custom equipment").
- A Maintenance card containing:
- The maintenance meter for flights and hours used against the interval.
- If the machine has a schedule, a line telling you either "Service overdue — log a service to reset the counters." or "Next inspection in N flights or M hrs." (only the parts that apply are shown).
- "Last serviced [date]" if a service has ever been logged.
- A Log Service button.
- A Lifetime totals row with two boxes: Total flights and Total hours for the machine's whole life.
- If the model has manufacturer milestones, a Manufacturer service milestones card listing each milestone and how often it applies (for example "every 12 mo", "every 200 h", "/ 300 flights").
- A specs area showing Serial Number, and — only if you filled them in — Tank / Payload (in litres), TC / RPAS Registration, and Notes.
- A Service History list. Each entry shows the service date, the flights and hours the machine had reached at that service ("at N flights · M hrs"), and any notes. If nothing has been logged it says "No services logged yet."
- A Delete Equipment button at the bottom.
Actions:
- Edit (pencil) — opens the Edit screen for this machine.
- Delete (trash), top right or the bottom button — asks "Delete [nickname]?" You must confirm; deleting removes the machine from your lists (it is marked deleted and queued to sync, not permanently erased).
- Log Service — opens the Log Service panel (see below).
Logging a service: the panel slides up titled Log Service with the reminder "This resets the maintenance counters to zero."
- Service Date — tap to open a calendar; defaults to today.
- Notes — optional, for example "parts replaced, who serviced".
- Tap Confirm Service to save (or Cancel to back out). Confirming records a maintenance log entry (capturing the flights and hours the machine was at) and resets the flights-since-service and hours-since-service counters to zero, and sets the last service date. The button shows "Saving…" while it works.
Editing equipment
Opened from the pencil icon on the detail screen. The header is Edit Equipment; the X (close) cancels without saving.
The fields are the same as Adding equipment and come pre-filled with the machine's current values: Nickname, Model (with the same Spray / Other / Custom picker and schedule summary), and — if the machine is Custom — Type, Manufacturer & Model, and the maintenance interval boxes. It also has Serial Number, Tank / Payload Capacity (L), Transport Canada / RPAS Registration, the Current usage since last service boxes (Flights since service, Hours since service), and Notes.
Editing the flights-since-service and hours-since-service here changes the counters directly (unlike Log Service, this does not add a service history entry).
Tap Save Changes to save. Only the nickname is required; if it is blank you get a "Required" message. On success you return to the detail screen; on failure you get "Could not update equipment."
Certificates
Tracks your operator paperwork and warns you before it expires. The header reads Certificates with a back arrow and a + (add) button.
Each certificate is a card showing:
- The certificate name.
- A small coloured status dot.
- A subtitle naming the type: "Transport Canada RPAS", "Pesticide Applicator Licence", or "Other".
- If an expiry date is set, an Expires: [date] line, coloured to match the status.
The status colour is based on how many days remain until expiry:
- Red — already expired (expiry date is in the past).
- Amber — expires in fewer than 30 days.
- Green — more than 30 days remaining.
Certificates are listed in order of expiry date, soonest first.
If you have no certificates yet, the screen shows an empty state with two suggested types you can add quickly — Transport Canada RPAS Certificate and Pesticide Applicator Licence — each with a + Add shortcut.
Actions:
- Tap + (top right) or a + Add shortcut to add a certificate.
- Tap a card to open its detail screen.
Adding a certificate
Opened from the + on the Certificates list. Header: Add Certificate; the X (close) cancels without saving.
Fields:
- Type * (required) — pick one with the radio buttons:
- Pilot Certificate
- Transport Canada RPAS Certificate (selected by default)
- Pesticide Applicator Licence
- Other Choosing a type auto-fills the Certificate Name and Issuing Authority with sensible defaults (Pilot and RPAS default to "Transport Canada"; Pesticide defaults to "Province / PMRA").
- Certificate Name * (required) — pre-filled from the type but editable. You cannot save without a name.
- Issuing Authority — pre-filled from the type but editable.
- Certificate / Licence Number (optional) — typed in capital letters automatically.
- Issue Date (optional) — tap to pick a date on the calendar; shows "Tap to select" until set.
- Expiry Date * (required) — tap to pick a date. You cannot save without an expiry date.
- Notes (optional) — free text.
Tap Save Certificate to save (the button shows "Saving…"). If the name or expiry date is missing you get a "Required" message. On success you return to the list.
Note: the province field is stored with the certificate (it defaults to PE) but there is no separate province input on this form.
Certificate detail
Opened by tapping a certificate. Header: Certificate, with a back arrow.
What it shows:
- The certificate name.
- A status badge reading Valid, Expired, or No expiry set, coloured green / red / grey using the same rules as the list (red once past the expiry date, amber within 30 days, green otherwise).
- Rows for Type, Issuing Authority, Certificate Number, Issue Date, Expiry Date, and — if present — Province and Notes. Empty values show a dash.
- A Document section for attaching a copy of the certificate.
Working with the document:
- If nothing is attached, tap Upload Photo or PDF. You choose a source: Camera, Photo Library, or PDF / File. The file is copied into the app so it stays available.
- If a photo is attached it is shown inline. If a PDF or other file is attached, tap it to open it.
- Tap Remove document to detach the file (you confirm first).
Deleting: tap Delete Certificate at the bottom and confirm "Delete [name]?" This removes the certificate (marked deleted and queued to sync, not permanently erased).
Drone calibration
A quick flow-rate helper for setting up your spray system. Header: Drone Calibration, with a back arrow. A subtitle reminds you this is a "Flow rate helper — starting point for field calibration, not a guarantee."
Under Spray Parameters, enter:
- Carrier volume (L/ha) — how much spray liquid you want to put on each hectare, for example 30.
- Ground speed (km/h) — how fast the drone flies, for example 5.
- Effective swath (m) — the working width of each pass in metres, for example 3.5.
- Number of nozzles — how many nozzles the drone has, for example 4 (whole number).
As soon as carrier volume, ground speed, and swath all have values, a Results card appears and updates live:
- Total flow required — the total litres per minute the system must deliver, calculated as carrier volume × ground speed × swath ÷ 600 (shown to three decimals). The card also displays this formula with your numbers.
- Per-nozzle flow — shown only once you have entered a number of nozzles: the total flow divided by the number of nozzles, in litres per minute (three decimals).
An amber note reminds you: "This is a calculated starting point. Confirm with a measured flow test on the ground before spraying."
This screen only calculates and displays; it does not save anything or change your equipment records.
Pesticide, Seed & Fertilizer Libraries
Swath has a built-in reference section where you can look up spray products, seeds, and fertilizers. You reach all of it from one landing screen ("Pesticide, Seed, & Fertilizer"). From there you can search the official Health Canada pesticide registry, find products that are approved for aerial (drone) application, ask the Swath Assist helper about label information, and browse (or add to) your seed and fertilizer lists.
Everything on these screens uses metric units. Pesticide product information comes from Health Canada's registry, and it is read-only — you cannot change a registered pesticide's data. Seeds and fertilizers are different: those lists can have custom entries added to them (by an admin user).
The landing screen (Pesticide, Seed & Fertilizer hub)
This is the menu you land on when you open the section. The header reads "Pesticide, Seed, & Fertilizer" and there is a back arrow in the top-left to return to wherever you came from.
Below the header are five cards. Tap any card to open that tool:
- Swath Assist (beta) — "Ask about aerial rates, buffers, and intervals — grounded in label data." An AI helper you can ask questions about aerial application rates, buffer zones, and intervals; its answers are based on label data. (Covered in its own section of this manual.)
- Pesticide Library — "Search the Health Canada registry by name, crop, or pest."
- Pesticide Finder — "Find products approved for aerial application."
- Seed Library — "Browse cover-crop & cereal seeds, add your own."
- Fertilizer Library — "Browse granular fertilizers, add your own."
Each card shows an icon, a title, and a short description, with a small arrow on the right. There are no other controls on this screen — it is purely a way to get to the five tools.
Pesticide Library
What it is for. The Pesticide Library is your searchable copy of the Health Canada pesticide registry (the PMRA / PPID product list). The empty-screen text calls it the "Health Canada Pesticide Registry" and states there are 7,742 currently registered products. You use it to look up any registered product by typing, read its details, and save the ones you use often as favourites.
The two tabs at the top (Search / Favourites). Just under the header there is a segmented switch:
- Search — the normal search view (described below).
- Favourites — your saved products. If you have any saved, the tab shows the count, e.g. "Favourites (3)." When this tab is empty it says "No favourites yet — Search for a product and tap the star to save it here."
How to search. In the Search tab there is a search box. What you type into it depends on which of the three search-mode chips is selected underneath:
- Product / Ingredient (the default) — searches by product name, active ingredient, or registrant (the company). The box hint reads "Product name, active ingredient, registrant…"
- By crop — searches by crop; type a crop and it finds every registered product for that crop. Hint: "Search a crop…"
- By pest — searches by pest or disease; type a pest and it finds every registered product for it. Hint: "Search a pest or disease…"
Tapping a different chip clears whatever you had typed. You need to type at least 2 characters before any results appear. A small "x" inside the box clears your text. Search shows up to 50 results at a time.
The "By crop" and "By pest" searches use Swath's cleaned-up crop and pest lists rather than the raw label text, so they give tidier matches than searching the label wording directly.
The "Aerial / drone approved only" toggle. Below the search box is a card with a small aeroplane icon and a switch. When it is on (its default), results are limited to products approved for aerial / drone application. When you have typed at least 2 characters with this toggle on, a line appears showing how many of the aerial-approved products your search matched, for example "12 OF ≈1,234 AERIAL PRODUCTS." Turn the toggle off to search the full registry of all 7,742 products.
What each result shows. Each result is a product card. In this library the cards also show the product's registration line (the registration number). Each card has a star you can tap to add or remove it from your favourites, and you tap the card itself to open the full details.
Tapping a product (detail view). Tapping a card opens a detail panel for that product, looked up by its registration number. From the detail panel you can also toggle the favourite star. Close it to go back to your results.
Favourites. The star on any card (or in the detail view) saves the product to your Favourites tab so you can get back to it quickly without searching again. Tapping the star again removes it. Favourites are stored on your device/account and are remembered between visits.
There is no "add your own pesticide" option here — the pesticide list is the official registry and is read-only.
Pesticide Finder
What it is for. The Finder answers a very specific question: "I have this crop and this pest/disease — which products can I legally use, and which of those are approved for aerial spraying?" Where the Library is a free-text search of the whole registry, the Finder is a guided two-step picker that returns only the products registered for both your chosen crop and your chosen pest.
Step 1 — Crop. In the "FIND A PRODUCT" card, tap the first dropdown ("1 · Crop", "Select a crop…"). A search-and-pick list opens; type to narrow it and tap the crop you want.
Step 2 — Pest or disease. The second dropdown ("2 · Pest or disease", "Select a pest…") stays greyed-out and disabled until you have chosen a crop. Once a crop is set, tap it to pick a pest or disease. Importantly, the pest list is filtered to your chosen crop — you only see pests/diseases that actually have registered products overlapping that crop, so you can't pick an impossible combination. If you change the crop, the pest selection is cleared and you pick again.
The results. As soon as both a crop and a pest are chosen, the matching products appear in a list below. Above the list:
- Two editable chips show your current CROP and PEST / DISEASE. Tap either chip to change that choice without starting over.
- A count line shows how many products matched, e.g. "5 MATCHING PRODUCTS."
- An "Aerial only" toggle. It is on by default, so the list is limited to aerial-eligible products. Turn it off to see every registered product for that crop-and-pest combination.
What each result shows and does. Each match is a product card (the same style as the Library), with a favourite star and a tap-to-open detail view, looked up by registration number. Favourites you set here appear in the Library's Favourites tab as well — it is one shared list.
If nothing matches. If both a crop and pest are chosen but there are no matches, you see "No [aerial-approved] products found for this crop and pest." When the aerial-only toggle is on, a "Show all registered products" link appears that turns the filter off for you. Before you have picked both a crop and a pest, the screen simply prompts "Pick a crop and pest to see approved products."
Finder vs. Library — the difference. Both draw on the same Health Canada product data and use the same product cards, detail view, and shared favourites. The difference is how you get to a product:
- Library — free-text search across the whole registry (by product/ingredient/registrant, or by crop, or by pest). Good when you know a name or want to browse broadly. Has a Favourites tab.
- Finder — a guided crop-then-pest picker that returns only products registered for that exact pairing. Good when you know the crop and the problem but not the product. The pest list is scoped to the crop so the choices always make sense.
Both default to showing only aerial/drone-approved products, and both let you switch that filter off.
Seed Library
What it is for. The Seed Library is a browsable list of seeds — cover crops and cereals. Unlike the pesticide data, this list can hold custom entries that an admin adds.
Browsing and searching. There is a "Search seeds…" box at the top. It matches on the seed's name or its category. Clear the box with the "x" to see the full list again. Each seed appears as a card showing:
- The seed name.
- Its category, and its season if the season is spring or fall (a season of "any" is not shown). Example: "cereal · spring."
- A typical rate range in kg/ha (e.g. "100–180 kg/ha typical"), when that information exists.
- A "Custom" tag if it is a custom-added entry (rather than one of the built-in seeds).
If nothing matches your search, the screen says "No seeds found."
Tapping a seed (detail view). Tap any card to open a detail sheet with the seed's name in the header. It lists whichever of these fields the seed has:
- Category
- Season
- Rate range (kg/ha) — the minimum to maximum.
- Default rate (kg/ha) — the suggested single rate.
- Notes
- A "Custom entry" tag at the top if it is a custom seed.
Close the sheet with the "x" to return to the list. This is a read-only view — there is no button here to send the seed into a job or mix; the library is a reference list.
Adding your own seed (admins only). If you are an admin user, a "+" (add) button appears in the top-right of the Seed Library header. (Non-admins do not see it.) Tapping it opens an "Add Seed" form with these fields:
- NAME * (required) — e.g. "Spring Triticale."
- CATEGORY — pick one chip: cereal, legume, brassica, grass, or broadleaf. Defaults to cereal.
- SEASON — pick one chip: spring, fall, or any. Defaults to spring.
- RATE MIN (kg/ha) * (required) — number keypad, e.g. 100.
- RATE MAX (kg/ha) * (required) — e.g. 180.
- RATE DEFAULT (kg/ha) * (required) — e.g. 140.
- NOTES (optional) — free text for special handling notes.
Tap "Add to Library" to save (the button reads "Saving…" while it works).
The rules the form enforces. You cannot save unless:
- A name is entered.
- Min, max, and default rates are all filled in and all greater than 0.
- The rates are in the right order: min ≤ default ≤ max. If not, you get an "Invalid rates" message explaining the problem.
Newly added seeds show up in the list with a "Custom" tag. Custom seeds sync/back up in the background so they aren't lost, and the list refreshes when you open the screen.
Fertilizer Library
What it is for. The Fertilizer Library works exactly like the Seed Library but for granular fertilizers, and it too supports custom entries added by an admin. The main difference is that fertilizers carry a grade (N-P-K) instead of a category and season.
Browsing and searching. There is a "Search fertilizers…" box that matches on the fertilizer's name or its grade. Clear it with the "x." Each fertilizer card shows:
- The fertilizer name.
- Its grade (the N-P-K numbers), if it has one — for example "28-5-10."
- A typical rate range in kg/ha (e.g. "100–250 kg/ha typical"), when available.
- A "Custom" tag if it was custom-added.
If nothing matches, the screen says "No fertilizers found."
Tapping a fertilizer (detail view). Tap a card to open a detail sheet showing whichever fields exist:
- Grade (N-P-K)
- Rate range (kg/ha) — minimum to maximum.
- Default rate (kg/ha)
- Notes
- A "Custom entry" tag if applicable.
Close with the "x." Like the Seed Library, this is a reference view with no "add to job/mix" action.
Adding your own fertilizer (admins only). Admins see a "+" button in the header. It opens an "Add Fertilizer" form:
- NAME * (required) — e.g. "Custom Blend."
- GRADE (N-P-K) (optional) — e.g. "28-5-10."
- RATE MIN (kg/ha) * (required) — e.g. 100.
- RATE MAX (kg/ha) * (required) — e.g. 250.
- RATE DEFAULT (kg/ha) * (required) — e.g. 175.
- NOTES (optional).
Tap "Add to Library" to save. The same rules apply as for seeds: a name is required; min, max, and default must all be greater than 0; and they must satisfy min ≤ default ≤ max, or you get an "Invalid rates" warning. Grade is optional. Custom fertilizers get the "Custom" tag and sync in the background.
Quick reference — how the libraries compare
- Pesticide data (Library + Finder) is the official Health Canada registry (PMRA / PPID), ~7,742 registered products. It is read-only — you can search, view details, and save favourites, but you cannot add or edit products. Both tools default to showing aerial/drone-approved products only, with a toggle to see the full registry.
- Seed and Fertilizer libraries are Swath's own lists. They are browse-and-view references (search by name/category or name/grade, tap for details) and they do allow custom entries — but only admin users see the "+" button to add them. Seeds carry category, season, and kg/ha rates; fertilizers carry an N-P-K grade and kg/ha rates. Both enforce min ≤ default ≤ max on rates.
- None of these libraries has a direct "add this product to a job or mix" button — they are reference lists. (Jobs and mixes are built in their own parts of the app.)
Mix Calculator
The Mix Calculator works out exactly how much pesticide and water to put in your tank, and how to split that mix across your drone loads so nothing is left over at the end of the job. There are two ways in (Quick and Guided), plus a special pre-filled version that opens straight from Swath Assist, and a plain-language help guide.
Overview
What it does. You give the calculator three things and it does the rest:
- The size of the area you're actually spraying (sprayable area, in hectares).
- How much spray liquid to put down per hectare (the carrier volume, in L/ha — this comes off the pesticide label, not your drone settings).
- Your drone's usable tank size (in litres).
You then add one or more pesticide products with their label rates. From those numbers the calculator tells you the total volume to mix, how much of each product to add, how much water to top up with, how many full tank loads you'll fly, the size of the final partial load, and how much product and water goes in each individual load.
The two ways to mix. When you open the Mix Calculator you land on a chooser screen ("How do you want to mix?") with two cards. Both run the same calculation engine — they only differ in how you enter the numbers:
- Guided walkthrough — one plain question at a time, with explanations for every term. Badged "Best for first-timers." Recommended if you're new or unsure what a term means.
- Quick calculator — every field on a single scrolling page. Best when you already know your numbers and just want to type them in.
The app remembers which mode you used last and shows a "Last used: …" note under the cards. There's also a "How mixing works — plain guide" link that opens the help screen.
How you reach it. You can open the Mix Calculator on its own, or from inside a job. When you launch it from a job's mix step, the job passes in the sprayable area (and often the assigned drone's tank size and name), so those fields arrive already filled and locked. Swath Assist, the in-app AI helper, can also hand off a product's rate and carrier straight into a pre-filled calculator (see "Mix from Swath Assist").
The calculation model (same for every mode). The engine takes your sprayable area, carrier volume, tank size and product list, and produces:
- Total mix volume = sprayable area × carrier volume. Example from the in-app worked example: 18.40 ha × 30 L/ha = 552 L total.
- Product amount for each product = sprayable area × its label rate. Example: 18.40 ha × 0.75 L/ha = 13.8 L of product. Dry products come out in kg or g instead of litres.
- Water = top up to the total mix volume after the product has gone in. Liquid concentrates take up room in the tank, so the water is whatever's left to reach the total; dry products don't displace water.
- Full loads = how many complete tanks fit into the total (whole number), e.g. 552 L ÷ 40 L = 13 full tanks.
- Final partial load = the litres left over for one last, smaller tank, e.g. 552 − (13 × 40) = 32 L. This last tank is sized precisely so that when it runs dry, the field is done — expected leftover is 0 L.
- Per-load breakdown = each tank's share of product and water, in proportion to its size. Example: a full 40 L load holds 1.0 L product + 39.0 L water; the 32 L last load holds 0.8 L product + 31.2 L water.
Units. The app works in metric — litres, hectares, L/ha. If your account is set to imperial, area fields offer an ha/ac toggle and the calculator converts acres to hectares internally (1 ac = 0.404686 ha); rate lines also show an imperial equivalent. All mixing maths is done in metric.
Safe-handling and legal notes shown throughout. Every product/rate area repeats the reminder: "Using a pesticide in any way other than directed on the label is against the law in Canada." This note turns into a prominent amber warning if you change a rate or carrier value that had been pre-filled from a trusted source (your last use or the label). Pre-filled figures are only assistive — the printed pesticide label is always the controlling authority. Products that are only conditionally cleared for aerial use ("mixed" aerial status) show a Label Check card asking you to confirm the use site and pest and attest that the label permits aerial application before the mix is saved to a job.
Quick mix
The Quick calculator (Quick Calculator screen) puts every field on one page and updates the result live as you type. There's a help (?) icon top-right that opens the plain guide.
Job context banner. If you opened Quick mode from a job, a green banner at the top confirms what was carried over (e.g. "18.40 ha from job · DJI T40 (40 L)").
Field section.
- Field size — the total gross area of the field, including anything inside the boundary you might skip. Decimal number; ha/ac toggle. Placeholder "e.g. 18.4". Not shown if the area was inherited from a job — instead you see a locked "Sprayable area — set from your job" tile.
- Area you're skipping — ponds, headlands, buffer zones, obstacles you fly around. Decimal number; ha/ac toggle. Defaults to blank/0; leave at zero to spray the whole field.
- The app subtracts skipped area from field size and shows a green "Spraying X ha" confirmation. That result (sprayable area) is what everything is mixed for. When area is inherited from a job, it's used directly with no subtraction.
Spray settings section.
- Spray per hectare — the carrier volume: total spray liquid (water + chemical) per hectare. Units L/ha (fixed suffix). Placeholder "e.g. 30". Drones typically run 10–50 L/ha. Find it on the label under "spray volume" or "water volume." This field can be pre-filled from your last use of a product, or from a label default; a badge tells you the source. Editing a pre-filled value flips the legal note to its prominent warning style.
- Drone tank size — how much your drone carries per flight (usable litres, e.g. 40 for a DJI T40). Units L. Placeholder "e.g. 40". If a drone was assigned by the job, this is auto-filled and locked with an "Override" option. Tank size only changes how many loads you fly, never how much chemical lands on the field.
Products & rates section. You can add as many products as you need.
- Product search — tap "Search product…" to look up a product by name or active ingredient from the Health Canada registry (via the Product Picker). If it's not listed you can type a custom name (it just won't carry a registration number).
- Favourites — if you've saved favourite products, they appear as one-tap chips under an "— or pick from your favourites —" divider.
- Amount — the application rate exactly as written on your label. Decimal number, placeholder "rate".
- Unit from label — a picker to match your label's unit (e.g. L/ha, mL/ha, kg/ha, g/ha, mL/100L, % v/v). The calculator auto-detects whether a product is liquid or dry from this unit; dry units (kg, g, percent by weight) show a "Dry product — measured by weight" note and are handled as mass that doesn't displace water.
- Picking a product auto-fills the rate (and sometimes carrier) from your last use of that product, or from a stored label default, with a badge showing which. You can always overwrite it.
- Add another product — appends a second (third, …) product block. Each extra product beyond the first gets a remove (×) button.
Reading the Quick result. As soon as sprayable area, carrier, tank size and at least one product+rate are valid, the result appears:
- Mix this much — "Mix N.N L total," then a line per product ("Add 13.800 L of [product]"), then a "Top up with water to N.N L" row. Product amounts are shown to three decimals.
- Flying the loads — e.g. "13 full tanks (40 L each) + 1 partial tank (32.0 L)," with a "Per full tank" breakdown (product per full load) and a "Last tank" breakdown for the partial.
- No leftover chemical — a green confirmation when the mix comes out clean. If the engine returns warnings (for example an unusually low/ULV volume), amber warning rows show instead.
- If inputs conflict, a "Can't calculate yet" amber card lists the blockers to fix. Until enough is entered, an empty-state prompt says "Fill in the fields above to see your mix plan."
Saving Quick results. When you're in a job context, a Schedule this job button appears. Tapping it writes the areas, carrier, tank size, total solution, water and load counts back onto the job, replaces the job's pesticide list with your products (including per-product totals and any aerial attestation), sets the job status to "scheduled," and returns you to Jobs. Outside a job there is no separate save/share button — the calculator is a live worksheet; your product rates and carrier are quietly remembered as "last used" for next time.
Guided mix
The Guided walkthrough (Guided Wizard screen) asks one question per screen with a progress bar and Back/Next buttons. It reaches the same result as Quick mode but explains every term as you go. A help (?) icon is available on every step.
The steps are numbered and the progress bar reflects them. If area or tank were inherited from a job, the matching steps are skipped automatically and the header counts only the steps you actually see.
- Step 1 — Field size. "How big is the field you're spraying?" Enter the total (gross) field area, ha/ac toggle. Required (> 0). Skipped if the job supplied the area.
- Step 2 — Area you won't spray. "Any parts of the field you won't spray?" Choose "No, spray it all" or "Yes, I'll skip some." Choosing Yes reveals a "How much are you skipping?" field. The screen then shows "This is what we'll mix for: X ha" with the subtraction spelled out. You must answer this step (pick yes/no, and enter a value if yes). Skipped if area was inherited.
- Step 3 — Spray per hectare. "How much spray liquid per hectare?" Enter the carrier volume in L/ha. Required (> 0). A "where to find it" tip points you to "spray volume / water volume" on the label. May arrive pre-filled from a product's label default.
- Step 4 — Drone tank size. "How much does your drone's spray tank hold?" Enter usable litres. Required (> 0). Skipped (and shown in the top strip) if the job auto-filled the drone's tank. Includes the watering-can analogy: tank size only changes how many refills you make, not how wet the field gets.
- Step 5 — Products. "Which pesticide(s) are you using?" Search and select one or more products (or enter a name manually), with favourite chips and "Add another product." Required: at least one named product. Last-used and label-default rate hints appear here; conditional-aerial products show the Label Check card.
- Step 6 — Rates. "How much of each product to use?" For each product, enter the amount per hectare and choose how the rate is written on the label (the unit picker). Dry products are flagged "measured by weight, not volume." Required: every product needs a rate > 0. The Calculate → button finishes this step.
- Step 7 — Your mix plan (result). Same layout as Quick: a Mix this much card (total, per-product amounts — dry products add "(dry — add to tank and stir)" — and the water top-up), a Flying the loads card ("Fill the drone N times full (40 L), then once with 32.0 L," plus full-tank and last-tank per-load breakdowns), and either a green "No leftover chemical" confirmation or amber warnings. If anything is inconsistent, a "Something needs fixing" card lists the problems with a "← Go back and fix" button that returns you to Step 6.
Navigation. Back/Next move between steps; Next is disabled until the current step's requirement is met, and a friendly alert tells you what's missing if you try to skip ahead. On the result screen you get Start a new calculation (clears everything and returns to Step 1) or, in a job, ← Back to mix setup.
Saving Guided results. Exactly like Quick: in a job context a Schedule this job button writes the full plan and product list back to the job, marks it "scheduled," and returns to Jobs. Your rates and carrier are saved as "last used" as you move from Step 6 to the result, so the next calculation for the same product starts pre-filled.
Mix from Swath Assist
This is a slimmed-down calculator (Mix calculator / from-assist screen) that opens when you tap "Use in mix calculator" on a product suggestion inside Swath Assist, the in-app AI helper. It exists so the AI can hand you a ready-to-mix setup.
What gets pre-filled. Swath Assist passes across the product it found and its label figures. The screen shows a green "Pre-filled from Swath Assist (beta) — rate & carrier from the [product]" banner, then a product card with the product name, its PCP registration number, active ingredient, crop, and an "Aerial" pill if the product is aerial-approved. Below that are two read-only tiles marked "from label":
- RATE — the product rate and unit the assistant pulled from the label (e.g. "0.75 L/ha"). You can't edit it here — it's locked to what the label says.
- CARRIER — the carrier volume from the label, prefixed with "≥" if the label states it as a minimum.
What you still enter. Two editable tiles (outlined in the accent colour):
- AREA — the sprayable area, defaulting to 8.0 (ha, or ac in imperial). Tap to edit.
- TANK SIZE — your drone tank, defaulting to 50 L. Tap to edit.
Result. Once area and tank are valid (and the assistant supplied a rate and carrier), the same full mix panel appears below (total, per-product, water, loads, per-load amounts). If something blocks the calculation, an amber note shows the first blocker instead.
Saving. There's a fixed Add to a job button at the bottom. Tapping it creates a brand-new draft job dated today, stores the areas, carrier, tank size, total solution, water and load counts, attaches the pesticide (name, rate, unit, PCP number), and opens that new job so you can carry on. This is the one calculator flow that creates a job rather than updating an existing one. If your inputs aren't valid yet, it prompts "Fix inputs first" instead of saving.
Help & formulas
The help screen ("How mixing works," reachable from the "How mixing works — plain guide" link on every calculator screen) is a plain-English reference. It covers:
- What the tool does — the three inputs (area, spray-per-hectare, tank size) and that everything else follows from them.
- Field size vs the area you skip — why you mix for the sprayable area, not the gross field: mixing for land you won't fly over leaves waste chemical you can't legally dump.
- Spray per hectare (carrier volume) — the total spray liquid landing per hectare; drones run ~10–50 L/ha vs 100–300 for ground rigs. The watering-can analogy: carrier is how wet the crop gets; tank size only changes how many refills. Find it on the label as "spray volume," "water volume" or "carrier volume."
- Drone tank size — use the usable amount (T40 = 40 L, T10 = 10 L), minus any reserve you keep; it only affects the number of flights.
- Reading your label: the rate — the rate can be written as L/ha, mL/ha, kg/ha, g/ha, mL/100 L, or % v/v; pick the matching unit and the app converts.
- Liquid vs dry products — liquids displace water in the tank; dry products (wettable powders, granules) are measured by mass and don't displace water. The app decides which from the unit you pick (kg, g, percent by weight = dry).
- Reading your mix plan — the worked example (18.40 ha, 30 L/ha carrier, 40 L tank, one product at 0.75 L/ha): total 552 L, product 13.8 L, water topped up to 552 L, 13 full 40 L tanks + one 32 L partial, 1.0 L product / 39.0 L water per full load, 0.8 L / 31.2 L for the partial. Advice: mix each load as you go rather than pre-filling 14 tanks.
- Why there's never leftover — the last tank is deliberately a partial sized so the field finishes exactly when it empties; expected leftover 0 L, avoiding a pesticide-disposal problem.
- Go deeper — two external links that open in your browser: Sprayers101's drone calibration guide, and the Health Canada pesticide label search.
Formulas at a glance (as documented in-app):
- Total mix (L) = sprayable area (ha) × carrier volume (L/ha)
- Product per mix = sprayable area (ha) × label rate (per ha) — in L for liquids, kg/g for dry
- Water = total mix − volume taken up by liquid product (dry products don't reduce water)
- Full loads = whole tanks that fit in the total; Final partial load = the remainder, flown as one last smaller tank
- Per-load product/water = each tank's share in proportion to its volume
Team & Organization
This section covers everything under the Organization hub: your team and their roles, your personal account, organization-wide settings, billing rates, and the tools for backing up, exporting, and importing your data.
The Organization hub (Organization screen) is the starting point. It shows a simple list of links:
- Organization Settings — always visible to everyone.
- Billing Rates — visible only if you are an admin or manager.
- Team Members — always visible to everyone (opens the Team screen).
- Data Management — visible only if you are an admin or manager.
Tap any row to open that area. If you are a pilot or ground crew member, you will only see Organization Settings and Team Members.
Team & roles
The Team screen lists everyone in your organization, grouped by role. It is where admins invite new people, change roles, flag pilot/ground-crew capability, and remove members.
Who can do what (the role model)
There are four roles. From most to least access:
- Admin — full access. Can invite new members (including other admins), change anyone's role, flag members as pilot or ground crew, and remove members. Admins are the only role that sees the invite (+) button, the list of pending invites, and can tap a member to open their action sheet.
- Manager — can manage billing rates and data management (backup/export/import), and can view the team. Managers do not get the admin-only team controls (they cannot invite, change roles, or remove members from the Team screen — those controls are gated to admins).
- Pilot — a regular member who can be assigned as pilot-in-command on jobs. No team-management or org-editing powers.
- Ground crew — a regular member who can be assigned as supporting ground crew on jobs. No team-management or org-editing powers.
Two capability flags are separate from the role itself:
- Pilot capability — "Can be assigned as pilot-in-command on jobs."
- Ground crew capability — "Can be assigned as supporting ground crew on jobs."
A member can carry a capability flag on top of their role (for example, a manager who is also flagged as a pilot). On the member card, a small PILOT or GROUND CREW badge appears next to the name when the member has that capability but their main role is something else.
Non-admins see a note at the bottom of the screen: "Contact your admin to change roles or invite new members." Tapping a member does nothing for them; only admins can open a member's action sheet.
The Team screen header
- Back arrow — returns to the previous screen.
- Add person (+) icon — admins only. Opens the "Invite team member" screen.
- Refresh icon — everyone. Syncs the member list from your organization. If sync fails you get a "Sync failed" message; otherwise the list reloads. Non-admins with an empty list are told to tap refresh to sync.
Inviting a new member (admins only)
- Tap the + (add person) icon in the header.
- Choose the role for this invite. You can pick Manager, Pilot, or Ground crew directly. To create an Admin invite, tap the Admin option; a confirmation warns "This person will have full admin access including inviting others and removing members" and you must confirm with Yes, admin. The default selection is Pilot.
- Tap Generate invite code.
- A single-use code is created and shown in large text. The screen reads "Share this code with your new [role]" and notes the code is single-use and expires in 14 days.
- Tap Share code to open your device's share sheet (the message reads "Join our org on Swath with this invite code… Code expires in 14 days."). Or tap Create another to generate a fresh code (this resets the role back to Pilot).
The new person joins by entering that code in their own app. Removing a member does not delete their sign-in account — they can re-join later with a new code.
Pending invites (admins only)
When you have unused invite codes, a Pending invites section appears at the top of the Team screen. Each row shows the formatted code, its role, and its expiry date, plus two buttons:
- Share (arrow) icon — re-opens the share sheet for that code.
- Revoke (x) icon — asks you to confirm, then makes the code unusable.
Changing a member (admins only)
Tap a member to open their action sheet. What you can do depends on whether it is yourself or someone else:
- Role (only for other members): choose Admin, Manager, Pilot, or Ground crew, then tap Set role to [role]. If nothing changed the button reads "No change." After a change the app re-syncs the team.
- Pilot capability toggle — turn on/off whether this person can be assigned as pilot-in-command. Takes effect immediately; if it fails the switch reverts.
- Ground crew capability toggle — same, for ground-crew assignment.
- Remove from org (only for other members) — asks you to confirm. The warning explains their sign-in account stays and they can re-join with a new invite code.
Protecting the last admin
The app never lets you strip the organization of its only admin:
- If you are the last remaining admin, you cannot demote yourself to another role — those role options are greyed out with the note "Last admin — can't demote."
- The last admin also cannot be removed; the Remove from org button is disabled with "Can't remove the last admin. Promote another member first."
Editing yourself
If you open your own action sheet, you can toggle your own pilot and ground crew capability flags. You cannot change your own role or remove yourself here — the note reads "To change your own role or leave the org, ask another admin." Your card shows "(you)" next to your name.
My account
The Account screen holds your personal profile. It is stored on the device (there is no password change, email-login change, or subscription/billing management on this screen).
Fields
- Full Name — your name (e.g. "Lee McArthur"). Used for the avatar initials and appears on exported spray records.
- Organization / Farm Name — e.g. "Aerial Insights." Shown under your name in the avatar preview.
- Email — optional.
- Phone — optional.
- Province — pick one of the first six province buttons (single choice; defaults to PE).
- Pesticide Applicator Licence # — e.g. "PEI-2024-1234." An info note explains: "Your name and pesticide licence number appear on exported spray records."
There is a live avatar preview at the top showing your initials, name, and organization.
Actions
- Save (header text button) or Save Profile (button at the bottom) — writes your profile and shows "Saved — Your profile has been updated," then returns to the previous screen. While saving, the buttons read "Saving…". If it fails you get an error message.
- Back arrow — leaves without saving.
There are no required fields enforced here and no sign-out control on this screen.
Organization settings
The Organization Settings screen holds details that apply to the whole organization and appear on invoices. When it opens it syncs the latest org info in the background.
Who can edit: only admins can change anything here. Everyone can open the screen, but for non-admins all fields are read-only and a note at the bottom reads "Only admins can edit organization settings" (there is no Save button).
Organization type (Farmer vs Operator) — admins only. A switch changes how the app behaves:
- Farmer — personal operations, no client billing. Client billing features (and the billing-related fields below) are hidden.
- Operator — a service business with client management; client billing features are shown.
Tapping Switch to Operator / Switch to Farmer shows a confirmation explaining the change, then applies it. You can switch back at any time.
Fields
- Logo — tap Pick logo (or Change logo) to choose a square image from your photo library (it asks for photo permission; the image is cropped to 1:1). Remove clears it. A business icon is shown as a placeholder when no logo is set.
- Organization Name — your org's name.
- Address — mailing address; the placeholder notes it "appears on invoices."
- Payment / Billing Details — Operator mode only. Free-text billing instructions to include on each client invoice (e-transfer email, cheque payable to, account #, terms, etc.).
- Tax Rate (%) — Operator mode only. Applied as HST/GST on invoices. Defaults to 15. Set to 0 to disable the tax line. If you type an invalid value it falls back to 15 on save.
Actions
- Save Settings (admins) — saves and shows "Organization settings updated," then returns. Shows "Saving…" while working; shows "Save failed" with a reason on error.
- Back arrow — leaves without saving.
Billing rates
The Billing Rates screen defines the per-acre prices you charge for different kinds of work. These rates feed into client billing.
Who can use it: only admins and managers reach this screen (pilots and crew don't have access). When it opens it syncs rates in the background and seeds a set of default rates if none exist.
How a rate is defined — every rate has three parts:
- Job Type — one of Pesticide, Seed, Fertilizer, or Scouting (pick one).
- Label — a name for the rate (e.g. "Custom pesticide application"). Required.
- Price per acre ($) — the dollar amount charged per acre (e.g. 55). Required, must be a valid number of 0 or more. All pricing here is per acre — there is no per-hectare or per-job option.
Each rate row in the list shows the label plus "[Job Type] · $[price]/ac", with a pencil (edit) and trash (delete) icon.
Actions
- Add (+) icon in the header, or the Add Rate button — opens the "New Rate" form.
- Pencil icon — opens "Edit Rate" pre-filled with that rate's values.
- Save Changes / Add Rate button — validates (label required, price valid) and saves.
- Trash icon — asks "Delete '[label]'?" and removes the rate on confirm.
If there are no rates, the screen shows "No billing rates yet."
Data management: backup
Reached from Data Management → Backup. (The Data Management hub is admin/manager only.) The hub also lists Export and Import.
Create backup
Tap Create backup to bundle your clients, fields (with all field boundaries), jobs and spray products, and Transport Canada flight records into a single file. The file is JSON and you can save it to Files/iCloud or email it to yourself via the share sheet. Certificate documents are not included in a backup. After creating, the screen shows the last backup's filename and a per-category record count. If the share sheet is dismissed, the backup file was still created.
Restore from backup
Tap Restore from backup, then pick a previously created Swath backup file. The app first reads the file and shows a preview: the org name, the export date/time, and a count of records per category. It then warns "Matching records already on this device will be overwritten. This cannot be undone." Confirm with Restore.
On restore, any record already on your device with a matching id is overwritten, and everything else is added. When done you'll see "Restore complete — Your data has been restored. Reopen any open screens to see the changes," plus a per-category count of what was restored. If a file can't be read you get "Cannot restore" with a reason.
Data management: export
Reached from Data Management → Export.
This screen is currently a "Coming soon" placeholder. It describes the planned exports — clients (CSV), fields (GeoJSON), and flight records and spray records (bulk CSV) — and notes that, for now, the full local Backup already covers this data for safekeeping. There are no working buttons on this screen yet other than the back arrow.
Data management: import (clients & fields)
Reached from Data Management → Import, which offers two importers: Clients (from CSV) and Fields (from GeoJSON). Both let you review everything before anything is saved, and both skip unreadable/incomplete rows automatically.
Import clients (CSV)
A three-step flow: Pick → Map → Preview.
1. Pick. Two options:
- Download template — creates a sample CSV (
swath-clients-template.csv) with the correct column headers already in place, shared via the share sheet. Fill in your rows and re-import it — no column mapping needed. - Choose CSV file — pick any CSV. If the file has no headers or no data rows you'll see "Empty file"; if it can't be read you'll see "Could not read file — Make sure this is a plain CSV file."
2. Map columns. For each column in your file you choose which Swath client field it maps to, or leave it as "Don't import" to skip it. The app auto-maps columns it recognizes when the file is first read. The screen shows how many rows were found. Rules:
- Each Swath field can be mapped to only one column — choosing a field for a new column clears it from any other.
- Business name is required — at least one column must map to Business name, or you'll be blocked with "Business name required" when you tap **Continue." (Client fields visible in the preview include business name, contact name, email, and phone; the mapping list shows the full set of Swath client fields, with Business name marked "(required)".)
3. Preview. Every row is listed with its business name and contact details. Each importable row has an on/off switch:
- Rows missing a business name are shown in red, labelled "Skipped — no business name," and are always skipped (no switch).
- Rows that look like a possible duplicate of an existing client are flagged in amber and default to off (switch turned off) so you don't create duplicates by accident.
- All other rows default to on.
The header text reads "X of Y rows will be imported." Tap Import [n] clients (disabled if none are selected). When done you'll see a success screen: "[n] clients imported," plus how many were skipped for a missing business name and how many you left unchecked, and a View Clients button.
Import fields (GeoJSON)
A two-step flow: Pick → Preview.
1. Pick. Tap Choose GeoJSON file and pick a .geojson or .json file exported from QGIS, Google Earth, DJI Terra, or similar. Each shape (Polygon or MultiPolygon) becomes a field. If no boundaries are found you'll see "No fields found," with a reminder that the file must be GeoJSON with Polygon/MultiPolygon shapes. KML/KMZ and shapefiles are not supported yet — convert to GeoJSON first.
2. Preview. At the top, an "Assign new fields to" client picker sets a default client for all imported fields at once. The list shows every shape with its name, area (in your chosen units), and assigned client. You can:
- Tap any field to give it a different client (choose No client or any existing client).
- Use the per-row switch to include/exclude a valid field.
Rules:
- Shapes that can't be read are shown dimmed with a warning icon and the reason (e.g. couldn't be parsed); they have no switch and are always skipped.
- Fields that look like a possible duplicate under the chosen client are flagged in amber. Changing a field's client re-checks for duplicates.
The header text reports how many shapes were found and how many couldn't be read. Tap Import [n] fields (disabled if none are selected). The success screen shows "[n] fields imported," how many were skipped as unreadable shapes and how many you left unchecked, and a View Fields button.
Weather, Reports, More & Support
This part of the manual covers the weather tools, the reports and flight‑record screens, the More menu (the app's secondary navigation hub), the Support chat, and the Swath Assist AI assistant. Everything here uses metric units and Celsius, the same as the app.
Weather
The Weather screen is titled 5‑Day Weather. Its job is to tell you, at a glance, whether it is safe to spray now and which days and time windows this week are best. Weather data comes from the Open‑Meteo forecast service, sampled at your chosen location and at a few nearby points.
At the top you will see your current weather location and the map radius (for example "Charlottetown · 200 km radius"). Tap the back arrow (top left) to leave the screen.
The map
- A satellite/hybrid map is centred on your weather location, with three white rings drawn at even steps out to your chosen radius so you can judge distance.
- A green pin marks your own location. Tapping it shows a label like "You · 12 km/h" (your current wind speed).
- Extra pins are placed at real nearby Maritime towns (Summerside, Charlottetown, Souris, Pictou) that fall inside your radius. These sample the same forecast engine so you can see how the wind varies around you. Each town pin is coloured by its wind: green (clear), amber (caution) or red (stop), and tapping it shows the town name and its wind speed.
- Radius control: Tap the white "200 km" pill on the top‑right of the map to open a dropdown, then choose 25 km, 50 km, 100 km or 200 km. Changing it re‑draws the rings and re‑samples the nearby town pins.
- A legend across the bottom of the map explains the pin colours: Clear (green), Caution (amber), Stop (red).
Best window banner Below the map, when a good window exists, a green banner reads "Best window this week:" followed by the best day, roughly the time of day (AM/PM or all‑day), whether the wind is light or moderate, and whether it is dry or has some rain.
5‑Day Outlook (wind & rain) A small legend shows four colours: Spray (green), Caution (amber), Stop (red) and Rain (blue). A hint reminds you that the coloured bars run from sunrise to sunset, and that you can tap any day to see its best windows.
Each day is a card. On every card you get:
- The weekday and date. Today is labelled "Today". The single best day of the five carries a blue BEST tag.
- A status chip on the right: "Do not spray" (red) when there is no usable window, "All‑day window" when almost the whole day is sprayable, or "1 window", "2 windows" etc.
- A WIND readout showing the day's low–high wind in km/h and the maximum gust as "G" followed by a number (for example "8–14 G22"). If the peak gust reaches the provincial stop limit the gust figure turns red.
- If rain is expected, a blue "rain" label with the time range (for example "rain 2:00 – 4:00 PM").
- A coloured timeline bar running sunrise → sunset, split hour‑by‑hour into green/amber/red so you can see exactly when the wind is safe. Rainy hours are outlined in blue. Small tick marks show the clock hours, and the ends are labelled with the sunrise (☀) and sunset (🌙) times.
Tapping a day expands it to show Best spray windows. Each window lists its time range and length in hours, the wind range during that window, and whether there is rain in it. If no window qualifies, it says there is no long‑enough window because winds stay at or above 20 km/h through the sprayable hours. The soonest day opens automatically the first time you load the screen.
Business rules (wind thresholds). The footer states them plainly: clear under 15 km/h, caution 15–19 km/h, stop at 20 km/h and above. Readings are blended from nearby forecast points within your chosen radius. These are wind‑only suitability colours — they are guidance to help you plan, not a legal clearance.
Weather location
Reached from the home screen's location picker, this screen (titled Weather location) is where you choose which place the weather is shown for. Tap the X (top right) to close without changing anything.
- Search box: Type a town or address and submit to look it up. If it is found, a result row appears with the place name and "Search result" — tap it to use that spot (it is saved as a favourite‑type location).
- Current: A row showing your GPS position ("here now"). Tap it to track wherever you physically are. A checkmark shows when it is the active choice.
- Your Fields: Every field you have saved that has a location on file, each showing the client name and area in hectares. Tap one to use that field's coordinates. If you have none, it says "No fields with a saved location yet."
- Favorites: Your saved weather locations, each with a star. Tap one to select it. If empty, it points you to add one in More › Display › Weather.
- Choosing any option immediately sets it and returns you to the previous screen. A footer link ("Manage favorites in More › Display › Weather") jumps to the weather settings screen.
Weather settings
Found under More › Display › Weather (breadcrumb shown at the top). Tap the back arrow to leave.
- Default map radius: A four‑way selector — 25 km, 50 km, 100 km, 200 km. Whatever you pick becomes the radius the 5‑Day Weather map opens at. The choice is saved right away.
- Favorite weather locations: A list of your saved spots, each showing its name and its latitude/longitude to two decimals. Tap the red X on a row to remove it (you are asked to confirm). Tap Add location to open a small form: enter a Name (for example "Mooney's yard") and a Town or address, then tap Save (or Cancel). The app looks up the address; if it cannot be found you are told to try a nearby town name. Saved favourites appear both here, in the home location picker, and on the weather map.
- Spray‑alert badge on home: A switch that turns the "!" warning dot on the home‑screen weather icon on or off.
Reports
The Reports screen is the hub for paperwork you can share. Tap the back arrow to leave.
- Spray Records → Pesticide Application Log: Described as "All applications — metric units, Canadian format." Tap Export PDF to generate the log as a PDF and open the share sheet so you can email, save or send it. If sharing is not available on the device, it tells you where the PDF was saved. If generation fails you get an error message.
- Coming Soon: Three greyed‑out cards that are not yet available — Field Report, Client Report, and Transport Canada Flight Log — each marked "Available in a future update."
Note: the More menu links Spray Records, Field Reports and Client Reports all open this same Reports screen; Flight Records opens its own screen (below).
Flight records
The Flight Records screen is your Transport Canada / RPAS recordkeeping log. The subtitle cites CARs 901.48 and shows how many records match your current view. Flight records are not created here — they are generated automatically when you complete and attest a mission. Tap the back arrow to leave.
The list. Each flight is a card showing the field name, the pilot (pilot‑in‑command), the date, the flight duration, and the start → end times. If the pilot's Advanced RPAS certificate was missing or expired for that flight, a red "Cert flag" badge appears. If there are no records at all it explains that records are created when you complete and attest a mission; if a filter hides everything it tells you to clear your filters.
Filtering. Tap Filter (top right) to open a sheet with four fields: From date and To date (typed as YYYY‑MM‑DD), Pilot name, and Field name. Tap Apply filters to use them (the button then shows how many filters are active, e.g. "Filters (2)"), or Clear filters to reset.
Opening a record. Tapping a card opens the full record. If the certificate was bad, a red banner at the top says the Advanced RPAS certificate was either expired or not on file at the time of the flight. The record is grouped into sections:
- Pilot & Crew: pilot‑in‑command, certificate number, certificate expiry date, and ground crew names. Missing or expired certificate details are shown in red.
- Flight Times: date, start time, end time, and duration.
- Location & Airspace: field, province, nearest aerodrome and its distance in km, whether a NOTAM was checked (Yes / "Not recorded"), and any airspace authorization.
- Weather: wind (speed in km/h, direction, and gusts if any), temperature in °C, humidity as a percentage, and whether a temperature inversion was present.
- Aircraft: the drone's nickname, model, and registration.
- CARs 901.27 Site Survey: the pre‑flight site‑survey checklist, each item shown with a green ✓ or a red ✗.
- Products Applied: each product and its PCP (Pest Control Product) registration number.
- Attestation: the pilot's signed statement that the record is accurate and the flight followed the Canadian Aviation Regulations, with the name and date it was attested.
Tap Export PDF at the bottom to produce that single flight record as a PDF and open the share sheet (or you are told where it was saved). This gives you a compliant, shareable copy for your records or an inspector.
The More menu
More is the app's secondary navigation hub. From top to bottom it contains:
- Profile card (your name and organization) — tap to open your Account.
- Display section:
- Home layout — opens a picker to choose which home screen you see: The Verdict, Your Day, Sky, or The Plan. The current choice is shown on the row.
- Area units — tap to switch between Hectares (metric) and Acres (imperial); the current setting is shown.
- Weather — opens the Weather settings screen (radius, favourites, spray‑alert badge).
- Account section:
- Certificates — opens your certificates screen.
- Organization — opens your organization screen.
- Spray Setup section:
- Equipment — opens the equipment screen.
- Mix Calculator — opens the mix calculator.
- Drone Calibration — opens the drone calibration screen.
- Pesticide, Seed, & Fertilizer — opens the pesticide information screen.
- Reports section:
- Spray Records — opens the Reports screen.
- Field Reports — opens the Reports screen.
- Client Reports — opens the Reports screen. (This row is hidden if your organization is a farmer‑type account.)
- Flight Records — opens the Flight Records screen.
- Support section:
- Chat with Support — opens the Support screen.
- Sign Out button — warns you to make sure sync shows "Up to date" first, because signing out clears this device's local data and anything not yet synced is lost. You must confirm.
- Version line at the very bottom (for example "Swath v1.2 · update abc1234") — tap it to open the Updates screen.
Support & help
The Swath Support screen is a guided help chat. It starts with "How can we help?" and three topic cards:
- How do I…? — "Get help with any feature in the app." This starts an AI chat: it greets you, and you type any question about how Swath works into the message box; it answers using the app's support assistant. If it cannot connect, it asks you to check your connection and try again.
- Report a bug — "Something isn't working the way it should." This runs a short guided interview, asking in turn: what you were trying to do; what happened instead; which section of the app you were in; and whether it has happened more than once.
- Suggest a feature — "An idea for something we should build." Its interview asks what you'd like to be able to do, how you imagine it working, and how often you'd need it.
For a bug report or feature request, once you have answered every question a Send bug report / Send feature request button appears. Tapping it opens your device's mail app with the report filled in (using your name and email from your profile) so you just tap Send — the message goes straight to the Swath team, who read every one. The back arrow returns you to the topic list from a chat, or leaves Support if you are already at the topic list.
Swath Assist (AI assistant)
Swath Assist (marked "beta") is an AI agronomist that answers spray questions from Health Canada pesticide label data. The header describes it as "AI agronomist · label‑sourced." Tap the back arrow to leave.
What it can do. As the opening screen says, it covers aerial rates, carrier volumes, wind limits, buffer distances, mix calculations, and unit conversions — all grounded in label data. You can ask about a product, a crop, or a pest.
How you chat. Type your question into the box at the bottom ("Ask about a product, crop, or pest…") and send it. While it works it shows "Looking up label data…". Answers come back as plain text plus, where relevant, label answer cards (product/rate details), an authority note showing how current the label data is, and tappable follow‑up suggestion chips that ask a related question when you tap them.
Suggested prompts. On the empty screen it offers three example questions to tap, freshly chosen each time you open it. They always include at least one potato question (the operator's own crop) plus a calculation and a general question — for example "What's the aerial rate for Headline EC on potatoes?", "Calculate my mix for Actara on potatoes, 60 acres, 100 litre tank", or "Convert 60 acres to hectares".
Mix calculations. If you ask it to work out a mix, it replies with a mix result card: the product, crop, area and tank size; the total product and total solution; a mix‑ratio bar (product vs water); a zero‑waste tank plan showing each full and partial load as a gauge with litres; the per‑load product and water amounts; any warnings; and the exact rate and carrier volume it used.
Connection to the mix calculator ("from‑assist"). Both the label answer cards and the mix cards have a "Use in mix calculator ↗" button. Tapping it opens the mix calculator's "from‑assist" screen with all the details already filled in from the assistant's answer, so you can review and fine‑tune the mix without re‑typing it.
If something goes wrong it replies "Sorry, something went wrong. Please check your connection and try again."