Canal Cruiser Log — User Guide

Version 1.2.1 · King Paramount Canal Adventures

1. Getting Started

First launch

When you open Canal Cruiser Log for the first time you will see the Log screen with a prompt to add your first boat. Tap Add a boat (or go to the Boats tab) to get started.

Adding your first boat

  1. Go to the Boats tab (bottom navigation bar).
  2. Tap the + button.
  3. Enter your boat name (e.g., "Kingfisher").
  4. Enter your CRT licence number exactly as it appears on your licence (e.g., "12345678").
  5. Tap Add Boat. Your boat is saved and set as the active boat automatically.

You can add as many boats as you like — useful if you own or crew multiple vessels.

Selecting an active boat

The active boat is the one all new log entries are recorded against. You can change it at any time:

2. Logging Your Position

The Log tab is your main recording screen.

Step by step

  1. Get GPS position — Tap the Get Position button. The app will request location permission on first use. Once permission is granted, your current latitude, longitude, and GPS accuracy are displayed.

    The GPS status indicator (coloured dot, top-right of the position card) shows signal quality:

  2. Attach a photo (optional) — Tap Add Photo to attach an image. Choose Take Photo to use your camera, or Choose from Library to pick an existing image. Tap the photo to change or remove it.
  3. Add a note (optional) — Type a short description in the Notes field (up to 300 characters). Useful for recording mooring details, conditions, or points of interest.
  4. Log it — Tap Log Position. The entry is saved immediately.

After logging

3. Understanding the Map

Maps appear on the Log screen (showing your current or just-captured position), in the History list (thumbnail previews), and on the Log detail screen (full interactive map).

4. Canal & River Trust Waterway Identification

After each log entry is saved, Canal Cruiser Log automatically contacts the Canal & River Trust's public waterway database to identify which waterway you are on.

What it shows

Each log entry can display:

How it works

The app sends your GPS coordinates to the CRT's ArcGIS FeatureServer (a publicly accessible service). If your position falls within a known CRT waterway, the name and code are saved to the log entry. The lookup widens its search radius automatically if no waterway is found at first, to account for slight GPS offsets.

If the location is not identified

5. Viewing Your History

The History tab shows all your past log entries for the active boat, newest first.

Browsing entries

Each entry in the list shows:

Tap any entry to open the full Log Detail screen, which shows the complete interactive map, all metadata, and a larger version of the attached photo.

Filtering by date

Use the filter chips at the top of the History screen to narrow the list:

FilterShows
AllEvery entry for the active boat
TodayEntries logged today
This WeekEntries from the past 7 days
This MonthEntries from the current calendar month
CustomA date range you specify

Tap Custom then select a start and end date from the date pickers.

Deleting an entry

Open the log detail screen (tap any entry) and tap the delete icon (top-right). Confirm when prompted. This action cannot be undone.

Editing notes

To edit (or add) the notes on a saved entry:

  1. Open the entry from the History tab.
  2. In the Notes section at the bottom of the detail card, tap the pencil icon.
  3. Edit the text in the field that appears. Notes are limited to 300 characters.
  4. Tap Save to keep your changes, or Cancel to discard them.

If the entry has no notes yet, the section shows "Add notes…" as a placeholder — tap the pencil icon to add them.

6. Exporting a PDF

You can export all currently visible log entries (respecting the active date filter) as a PDF.

How to export

  1. On the History tab, apply any date filters you want.
  2. Tap the Export PDF button (share icon, top-right of the History screen).
  3. Wait a moment while the app generates the PDF — map images are rendered for each entry, which can take a few seconds.
  4. The system share sheet appears. Choose to save to Files, share by email, AirDrop it to your Mac, or send it any other way.

What the PDF contains

File name

The PDF is saved with the format: [Boat Name] [Start Date] - [End Date].pdf
Example: Kingfisher 01 Jan 2026 - 30 Apr 2026.pdf

7. Backup & Restore

Canal Cruiser Log stores all data locally on your device. To avoid losing your data when you change phones, you can export a backup file and import it on your new device.

Exporting a backup

  1. Go to the Settings tab.
  2. Under Backup & Restore, tap Export Backup.
  3. The app creates a single .json file containing all your boats, all log entries, and any attached photos.
  4. The system share sheet appears. Choose where to save the file:

What the backup contains

Importing a backup

  1. Locate your backup file (e.g., in iCloud Drive or Google Drive).
  2. Go to the Settings tab in the app.
  3. Under Backup & Restore, tap Import Backup.
  4. Pick the .json backup file from the file picker.
  5. Confirm the warning — importing replaces all existing data.
  6. The app restores all boats and logs. Your first boat is set as active automatically.

Important: Importing a backup permanently deletes all data currently in the app and replaces it with the contents of the backup file. Export a fresh backup before importing if you want to preserve your current data.

File name

Backup files are named: canal-navigator-backup-YYYY-MM-DD.json
Example: canal-navigator-backup-2026-05-04.json

8. Managing Boats

Adding a boat

See Getting Started above.

Switching boats

Tap any boat on the Boats tab, or use the dropdown at the top of the Log screen. History and log entries are shown per boat — switching boats changes which history you see.

Deleting a boat

On the Boats tab, tap the delete icon on a boat card. A confirmation alert will appear warning you that all log entries for that boat will also be permanently deleted. This cannot be undone. Tap Delete to confirm.

9. Settings

Access settings via the Settings tab.

14-Day Location Reminder

When enabled, Canal Cruiser Log schedules a notification for 14 days after each new log entry you make in a new CRT location. The notification reminds you to move your boat — useful for liveaboards managing CRT continuous cruising requirements.

Location Warning

When enabled, Canal Cruiser Log shows an alert after you log a position if your boat appears to be in the same CRT location as the previous entry. This is a heads-up, not a block — you can still save the entry.

10. Troubleshooting

GPS won't get a fix

CRT location is not identified

Notifications are not arriving

PDF export is slow

The app shows "No boat selected"

11. Privacy

All your data — GPS positions, photos, notes, and boat details — is stored locally on your device. King Paramount Canal Adventures does not operate servers and cannot access your data.

The app communicates with two external services:

For the full privacy policy, see Privacy Policy or contact ccwakely@gmail.com.