← Back to your chart

TANOOKI FISHING / GETTING STARTED

Your coast. On your terms.

The map works now with real NOAA contours, saved waypoints, manual routes and imported tracks. Background GPS needs the Overland receiver below. No paid API or chart subscription is used.

What still needs your laptop / iPhone
Deploy the free receiver, connect Overland, import your satellite MBTiles and test locked-screen tracking and airplane-mode use on your iPhone.

Start without buying a domain

Use the current private preview while developing. To connect your own hosting, create a Cloudflare account and verify your email. Keep Workers on its Free plan. The website can run at a free PROJECT.pages.dev address before you purchase anything.

  1. On your laptop, download the Pages upload ZIP below.
  2. In Cloudflare, open Workers & Pages → Create application → Get started → Drag and drop your files (look for the Pages / Direct Upload option if the dashboard wording differs).
  3. Name the project, for example tideline-map. Upload the ZIP, then select Deploy site. No frontend build command is needed.
  4. Open the returned HTTPS pages.dev address. Check that the chart loads. This static map address is public unless you separately configure access controls; your local waypoints and token-protected receiver tracks are not included in its uploaded files.
  5. Keep this address for the receiver's ALLOWED_ORIGINS setting below. A domain is not needed for GPS uploads.
Download Pages upload ZIP ↓

Direct Upload projects cannot later switch to Git integration in place. For this personal app, uploading a replacement ZIP is a straightforward update path. Official Direct Upload guide.

Buy and connect the domain later

  1. Sign into the same Cloudflare account that hosts your Pages project. Open Domain registration → Register domains.
  2. Search for your preferred name, including its extension, such as yourchosenname.com. Check availability and the displayed registration and renewal costs. We have not reserved a name.
  3. Select Purchase for the exact spelling you want. Choose your registration period, enter your own accurate registrant/contact information and payment details, and complete checkout yourself. You only need the domain; this build requires no paid hosting upgrade or email package.
  4. Complete any registrant-email verification message from Cloudflare. Keep account access and renewal reminders; enable auto-renew if you want ongoing annual renewal.
  5. Open Workers & Pages → your Pages project → Custom domains → Set up a custom domain. Enter the purchased domain and follow the activation steps. Let Cloudflare create the DNS record; do not merely add a CNAME without associating the domain in Pages.
  6. Wait until the custom domain is active and HTTPS works. If you also want www, associate that hostname too.
  7. Add the exact new origin, for example https://yourchosenname.com, to the receiver's ALLOWED_ORIGINS list and redeploy the receiver. Retain your temporary address if you still use it. The Overland upload URL can remain on workers.dev.
  8. Before switching, export your Tanooki Fishing backup on the old address. Open the new domain, restore that backup, re-enter the receiver connection, and download the offline pack again. Browser storage belongs to each domain: it does not transfer automatically. Re-import satellite files separately when available, and add the new address to your Home Screen.

Cloudflare-registered domains use Cloudflare nameservers. Annual domain renewal is recurring; free hosting quotas are finite. Domain purchase instructions · Connecting a Pages domain.

1. Install the web app

Open the map in Safari on your iPhone. Use Share → Add to Home Screen. Launch it from that new icon, then choose Chart → Download offline pack. The Home Screen app may use different storage from Safari, so download and import inside the installed app.

Offline packs must be downloaded before going out. Test an actual offline restart. This private preview can require ChatGPT sign-in when online; we can move the same source to your own domain once you’re ready.

2. Bring your satellite imagery

Send a raster .mbtiles file from your OpenCPN charts folder. Start with the Jacksonville / St. Johns entrance area and a file under 100 MB. PNG, JPEG and WebP tiles work. A georeferenced MBTiles file preserves its tile coordinates—screenshots don’t.

In the map, open Setup → Satellite imagery → Choose MBTiles file. The imagery stays on that device in IndexedDB. To view it on both your laptop and iPhone, import it on each. Keep your original file. KAP and GeoTIFF need conversion before this importer can read them. Only use imagery you have permission to reuse and store offline.

3. Deploy the Overland receiver

This is a small authenticated Cloudflare Worker and D1 database. It is built, but has not been deployed to your account. The private map’s login cannot serve as Overland’s upload endpoint, so the receiver uses its own private access token.

Download receiver source & instructions ↓
  1. Install Node.js LTS on your laptop and sign up for Cloudflare’s Free plan. Unzip the receiver and open a terminal in its folder.
  2. Run npx wrangler login.
  3. Run npx wrangler d1 create tideline. Open wrangler.toml in a text editor. Replace REPLACE_WITH_YOUR_DATABASE_ID with the returned database UUID. In ALLOWED_ORIGINS, keep the existing preview origin and append your Pages address, separated by a comma, with no path or trailing slash.
  4. Run npx wrangler d1 execute tideline --remote --file=schema.sql.
  5. Run npx wrangler deploy to create the Worker (it will refuse requests until configured). Then generate a private token with node -e "console.log(require('crypto').randomBytes(32).toString('hex'))".
  6. Run npx wrangler secret put API_TOKEN and paste the token at the prompt.
  7. Run npx wrangler deploy.
  8. In Tanooki Fishing → Setup → Connect Overland, enter the deployed receiver’s HTTPS origin and the token. Select Save & test connection.
  9. On your iPhone, select Open Overland setup. Alternatively set Overland’s Server URL to https://YOUR-RECEIVER.workers.dev/overland, with the same token and device ID ethan-iphone.

When using your own domain, add the map’s exact HTTPS origin to ALLOWED_ORIGINS in the receiver config, then redeploy. Keep the token private. The website saves it locally and omits it from exported backups.

4. Test before your first boat trip

In iPhone Settings → Apps → Overland → Location, grant Always and turn on Precise Location. If Always is not offered immediately, open Overland and follow its permission prompts, then check again. In Overland Settings, use Continuous Tracking Mode: Standard, Desired Accuracy: Best, Show Background Location Indicator: Always, and Pause Updates Automatically: Off for the test. Disable Wi-Fi-only sending. Enable Tracking when starting the test and stop it when finished to avoid recording unrelated travel. Keep the default response check; leave “Consider HTTP 2XX Successful” off. Leave the server URL blank until your receiver is deployed. Official Overland settings. Start a trip, lock your phone, and take a short outdoor walk. Unlock and sync the track in Tanooki Fishing. Repeat with airplane mode, then reconnect and sync.

The web app shows your current browser GPS while open. Overland records while locked. Unsynced offline points cannot be read by the website until uploaded. Tracks can be synced manually, or every 60 seconds while Tanooki Fishing is open and online when “Refresh while open” is enabled. This is not a continuous background feed to the web app. iOS controls background update timing, and force-quitting or restarting can interrupt recording.

5. Keep your data

Waypoints, imported tracks and imagery are stored locally. Setup → Back up places & tracks exports a JSON backup; Places also exports GPX. Imagery is not included in the backup. Overland tracks are held in your receiver after a successful upload and can be synced to each device.

Stay on the free hosting tier and monitor quota usage. If storage fills, the receiver returns an error and Overland retains its unacknowledged batch. Export/archive tracks before exhausting database storage. No paid tier or automatic paid upgrade is required.

Chart coverage and detail

The regional pack uses official NOAA charts within an envelope around your screenshot, from northern coastal Jacksonville to Guana, including the lower St. Johns, Intracoastal and offshore waters. It buffers the approximate screenshot boundary, rather than claiming an exact traced polygon. Finer chart cells take precedence over overlapping smaller-scale cells.

The supplementary USACE entrance survey has 1-foot contour intervals from September 2026 in Bar Cut-3 near Mayport. It is a narrow survey footprint, not complete high-resolution coverage across the region. Its own source labels it supplemental survey data, not for navigation. At wider views, 5-foot survey contours keep the map readable; zoom in to level 16 or closer for all 1-foot contours. Tap a survey contour to see its source and date. Density is not accuracy.

Red depth shading is the default: stronger red marks shallow charted bands and lighter peach tones mark deeper bands. The shallow threshold controls the strongest highlight. Coastal blue and bottom terrain remain selectable. Depth colors and shallow highlighting use charted MLLW depth bands. Bottom terrain colors are styling, not a newly measured 3D seabed. Satellite imagery is pending your files. BlueTopo depths are not merged into the MLLW chart.

Downloading the offline pack saves the hosted snapshot, not future NOAA updates. A failed replacement download preserves your previous completed pack. Source metadata and dates.

Routes and backups

Choose Routes → Draw a route, tap points on the chart, then reopen Routes to name, undo or save it. Distances are in nautical miles. Export GPX to move a route to another compatible tool. Routes are straight manually placed legs and do not avoid land or hazards. Setup backups include waypoints, tracks and routes; they exclude imagery and access tokens.

This planning prototype is not validated as a primary navigation system. A blank area outside chart coverage is missing data. Charted depths alone do not establish safe clearance at the current tide.

Continue on your laptop

The editable source is saved with this Site. Download the portable app source if you want to host it on Cloudflare Pages under your own domain. Deploy its dist/ folder as static assets; there is no frontend build step. The receiver is deployed separately.

← Open Tanooki Fishing