TANOOKI FISHING / GETTING STARTED
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.
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.
tideline-map. Upload the ZIP, then select Deploy site. No frontend build command is needed.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.ALLOWED_ORIGINS setting below. A domain is not needed for GPS uploads.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.
yourchosenname.com. Check availability and the displayed registration and renewal costs. We have not reserved a name.www, associate that hostname too.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.Cloudflare-registered domains use Cloudflare nameservers. Annual domain renewal is recurring; free hosting quotas are finite. Domain purchase instructions · Connecting a Pages domain.
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.
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.
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 ↓npx wrangler login.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.npx wrangler d1 execute tideline --remote --file=schema.sql.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'))".npx wrangler secret put API_TOKEN and paste the token at the prompt.npx wrangler deploy.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.
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.
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.
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.
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.
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.