2 files changed, 115 insertions, 0 deletions
diff --git a/android-app/app/src/main/assets/docs/migrate_navionics.md b/android-app/app/src/main/assets/docs/migrate_navionics.md
new file mode 100644
index 0000000..83b28fa
--- /dev/null
+++ b/android-app/app/src/main/assets/docs/migrate_navionics.md
@@ -0,0 +1,56 @@
+# Migrating from Navionics
+
+Welcome to Nav. This guide covers the key differences and how to move your data over.
+
+---
+
+## What's Different
+
+| Feature | Navionics | Nav |
+|---|---|---|
+| Charts | Navionics SonarChart + Raster | OpenFreeMap vector tiles |
+| Track recording | In-app GPX | GPX saved to Documents/Nav/ |
+| Trip log | Voyage log | Voice log (transcribed) |
+| Departure planning | None | Pre-trip briefing with sail plan |
+| Wind overlay | Basic | Wind particles + hourly forecast |
+
+---
+
+## Exporting Your Tracks from Navionics
+
+1. Open Navionics on your phone or tablet
+2. Go to **My Charts → Tracks**
+3. Tap a track → **Share → Export GPX**
+4. Save or AirDrop the `.gpx` file to your device
+
+---
+
+## Importing Tracks into Nav
+
+Nav automatically reads GPX files from the **Documents/Nav/** folder on your device.
+
+1. Move your exported `.gpx` files to `Documents/Nav/` using the Files app
+2. Re-open Nav — tracks are loaded on startup
+3. Similar-conditions trip comparison in the Pre-Trip Briefing will use these tracks
+
+---
+
+## Waypoints
+
+Nav does not currently manage waypoints. Use Navionics or a dedicated chart plotter for waypoint routing. Nav focuses on departure briefing, track recording, and the sail log.
+
+---
+
+## Charts
+
+Nav uses **OpenFreeMap** vector tiles. These are free, fast, and work well for coastal cruising. They do not include depth contours or hazard overlays — continue using Navionics or a NOAA chart app for navigation in unfamiliar waters.
+
+---
+
+## Daily Workflow
+
+**Before you sail:** Open the **Safety → Plan Trip** screen for your departure briefing — sail plan, heading recommendation, watch items, and a look at how conditions will change over your trip window.
+
+**On the water:** Tap **Log** to dictate voice notes. The GPS track records automatically when you tap the record button.
+
+**After you return:** The post-trip report summarises distance, duration, and max SOG.
diff --git a/android-app/app/src/main/assets/docs/migrate_sea_people.md b/android-app/app/src/main/assets/docs/migrate_sea_people.md
new file mode 100644
index 0000000..b1920b4
--- /dev/null
+++ b/android-app/app/src/main/assets/docs/migrate_sea_people.md
@@ -0,0 +1,59 @@
+# Migrating from Sea People
+
+Welcome to Nav. This guide covers what transfers over and what works differently.
+
+---
+
+## What's Different
+
+| Feature | Sea People | Nav |
+|---|---|---|
+| Social feed | Community posts | Not applicable — Nav is single-user |
+| Trip log | Text entries + photos | Voice log (transcribed audio) |
+| Boat profiles | Basic boat card | Detailed sail inventory with reef points |
+| Weather | Integrated forecast | Open-Meteo hourly + NOAA marine |
+| Departure planning | Manual notes | Pre-trip briefing with sail plan & route |
+
+---
+
+## Exporting Your Log from Sea People
+
+1. Open Sea People → **Profile → My Logs**
+2. Use the **Export** option (CSV or PDF depending on your version)
+3. Save entries you want to keep for reference
+
+Nav's voice log works differently — entries are dictated on the water and transcribed. You won't be able to import Sea People entries directly, but you can review them alongside Nav going forward.
+
+---
+
+## Boat Profiles
+
+Nav stores a detailed boat profile with your sail inventory:
+
+- **Headsails** with wind range for each (e.g. 155% Genoa ≤ 13 kt, 100% Jib 10–21 kt, 65% Blade 18+ kt)
+- **Main reef points**
+- **Hull length** (used for hull-speed estimates in the departure briefing)
+
+Your boats are pre-seeded on first launch. Profiles are stored locally and used in the **Pre-Trip Briefing** to give sail recommendations specific to your boat.
+
+---
+
+## Trip Log Workflow
+
+**On the water:** Tap the **Log** tab and use the microphone button to dictate a note. Notes are timestamped with your GPS position.
+
+**Voice notes work well for:**
+- Sea state observations ("1.5m swell, 10s period, comfortable")
+- Traffic ("fishing vessel on starboard, gave way")
+- Sail changes ("reefed main at 18 kt")
+- Time stamps ("rounded the point, heading west")
+
+---
+
+## Daily Workflow
+
+**Before you sail:** Safety → Plan Trip for your departure briefing.
+
+**On the water:** Log tab for voice notes; tap the record FAB to start the GPS track.
+
+**After you return:** The post-trip report generates a narrative summary you can save or share.