Help & User Guide

Welcome

Maplet is your companion for saving, organizing, and exploring places that matter to you. Whether you’re a traveler, adventurer, or someone who loves to keep track of favorite spots, Maplet lets you:

• Save unlimited locations with notes, photos, and voice memos
• Organize places into folders and categories
• Instantly see distances to your saved places and mark them as visited
• Open or share locations in any major map app (Apple Maps, Google Maps, Waze, HERE, and more)
• Plan journeys, optimize routes, and share folders with friends
• Sync your data privately across Apple devices with iCloud
• Import locations from CSV, GPX, or KML files, and export to PDF or CSV

Maplet is designed to be simple, powerful, and privacy-friendly — giving you full control over your location data.

Home Screen (Map)

The Home screen is your main map view, where you can:

• See your current location (blue dot)
• Pan and zoom the map to explore
• Search for places
• Drop temporary or green (persistent) flags
• Save new locations
• Share locations
• Import from a share link
• Hide/show saved pins and flags
• Clear temporary flags
• Lock the save/share button to the current location (for use in cars or on the move)

Key Features

• Center on User: Tap the location button to center the map on your current position.
• Search: Use the search bar to find addresses or places. Results appear in a dropdown.
• Drop Flags: Tap and hold the flag button to choose between a temporary flag or a green flag (persistent). Temporary flags are cleared when the app restarts or by pressing the clear flag button. Green flags remain after restart and can later be saved as locations. Clear green flags in Settings, or tap an individual green flag to delete or save it.
• Save Button: Tap the floating save button to open the Save Location screen for the current map center.
• Map Style: Switch between standard and satellite map styles using the map style toggle.

Saving a Location

1. Open the Save Sheet
   • Tap the floating Save/Share button on the Home screen.
   • Tap Save to open the Save Location sheet for the current map center.
2. Fill in Details
   • Title: Give your location a memorable name (required).
   • Category: Choose a category (e.g., Food, View, Shopping, Other) or create your own.
   • Folder: Organize locations into folders (e.g., Travel, Favorites).
   • Notes: Add any extra details about the place.
   • Rating: Optionally rate the location (1–5 stars).
   • Photo: Attach a photo from your camera or library.
   • Voice Note: Record a quick audio note.
3. Save — Tap Save Location at the bottom. Your place is now saved.

Tip: You can create new categories and folders directly from the Save sheet.

Viewing Saved Locations

• List / Grid / Folders: Switch between list, grid, and folder views.
• Sort & Filter: Sort by distance, date, category, or visited status.
• Search: Quickly find a saved place by name or notes.
• Bulk Actions: Select multiple locations for batch actions (delete, move, etc.).
• Visited Flags: Mark locations as visited with a green checkered flag.
• Show Distance: Show current distance to locations in the list view.

Location Details

Tap any saved location to view its title, address, notes, attached photos and voice notes, category and folder, date added and last modified, and distance from your current location.

Editing a Saved Location

1. From the Saved tab, tap a location, then tap the Edit button (pencil icon).
2. Change the title, notes, category, folder, or rating. Add or update a photo or voice note, or delete an existing voice note.
3. Tap Save Changes at the bottom.

Viewing Distance to Locations

• In the Saved tab, each location displays the distance from your current position.
• The distance updates when you press the refresh distance button.
• You can sort saved locations by distance to find the nearest places.
• When viewing a location’s details, the distance is shown at the top or in the info section.

Sharing Folders via Universal Link

The fastest way to share a folder is a Universal Link — a short https://maplet.net/share?data=… URL generated entirely on your device.

How to share

1. Long-press a folder and select Share.
2. Choose Share via Deep Link.
3. Send the link via Messages, Mail, AirDrop, or any other app.

What the recipient sees

• The link is a real HTTPS URL, so it always opens in a browser first.
• If they have Maplet installed, iOS Universal Links hand the folder off to the app automatically.
• If they don’t have the app — or they’re on a computer — they get an interactive web map at maplet.net/share, with pins, notes, and directions. They can tap Open in Maplet if they later install the app.

What’s included — and what isn’t

• Included: folder name, color, and up to 30 locations with title, coordinates, category, notes, address, rating, visited status, and contact fields when set.
• Not included: photos and voice notes. Use a .maplet file if you need the full archive.
• Older share links generated before this format may have been capped at 15 locations.

Try a live example: open a sample shared folder.

Share a single location, or open in any map app

Tap the share button on a saved location card to generate a link or share in various map formats. You can open any location directly in Apple Maps, Google Maps, Waze, HERE, Citymapper, Gaode, Yandex, 2GIS, or Maps.me. When sharing, you can include all supported map formats at once so the recipient can open it in their app of choice.

Sharing Folders as .maplet Files

For complete folder sharing with all content, export folders as secure .maplet files. This creates an encrypted archive containing every location, photo, and voice note — with no location-count limit.

How to share as a .maplet file

1. Long-press the folder you want to share
2. Select Share Folder
3. Choose Share as File
4. Type a custom name or leave the default
5. Press Generate .maplet File
6. Share it normally or save it to Files

• Complete folder data export — no location-count limit
• Photos and voice notes included
• SHA-256 integrity verification
• Can only be opened by the Maplet app

Perfect for folder backups, device transfers, or sharing full folder data securely.

Managing Shared Files

All shared .maplet files are stored in the app for easy access.

1. Go to Settings
2. Under Export History, tap Export History
3. View all previously shared .maplet files

• View: See previously exported files with creation dates
• Re-share: Tap any file to share it again
• Delete: Remove individual files you no longer need

Auto-cleanup: Enable auto-delete after sharing, or clear files older than 7 days from Settings → Export History.

Managing Folders

In Folder view (Saved tab), long-press any folder to open the options menu:

• Rename: Change the folder’s name.
• Edit: Update the folder’s icon or color.
• Delete: Remove the folder (you may be prompted to move or delete its contents).
• Share: Create a Universal Link or a .maplet file.

Editing Categories in Settings

Go to the Settings tab and select Manage Categories. You can view custom categories, tap Edit to change name, icon, or color, or tap Delete to remove a category that isn’t in use. Built-in categories cannot be edited or deleted.

Journey Planner & Checklists (Pro)

Maplet’s Journey Planner lets you organize trips, create checklists of places to visit, and track your progress.

Accessing the Journey Planner

Tap the Journey Planner tab (or find it in the main menu) to see a list of all your journey plans.

Creating a Journey Plan

1. Tap the + button in the top right.
2. Enter a title and optional notes.
3. Add locations (stops) from your saved places.
4. Organize stops into the order you want to visit them.
5. Save your journey plan.

Viewing and Managing Journeys

• Journeys are listed with progress, number of stops, and completion status.
• Search by name or notes; filter completed journeys; sort by newest, oldest, A–Z, progress, or completion.
• Tap a journey to open its checklist view.

Journey Checklist View

• See all stops as a checklist and mark them complete as you visit them.
• View distance to each stop from your current location.
• Long-press a stop for actions like editing notes, adding media, or opening in maps.
• Reorder stops manually (drag-and-drop) or use Optimize for the best route.
• Enable Live Tracking to highlight the nearest stop as you move.

Exporting and Printing Journeys

Tap the … menu in the checklist view and select Print Summary to generate a PDF of your journey, including stops, notes, and media.

Completing or Deleting a Journey

Mark a journey as complete from the … menu, or delete it if you no longer need it (this cannot be undone).

Multi-Route Planner (Pro)

The Multi-Route Planner lets you plan and preview routes with multiple stops, optimize the order, and open or share the route in your favorite navigation apps.

Selecting Stops

1. Open the Multi-Route Planner from the Pro tab or main menu.
2. Tap locations to select them as stops. Selected stops are highlighted and counted at the top.
3. Use search or folder view to find locations. Select at least 2 stops.

Use the toggle at the top to include your current location as the Start Point, End Point, or Off.

Previewing the Route

1. Once you’ve selected at least 2 stops, tap Create Route.
2. The map view shows your stops and the calculated route.
3. In Route Options you can choose Driving or Walking, enable Optimize Route & Stops, reorder stops, and enable/disable individual stops.

See total distance and estimated time, then Open In Apple Maps, Google Maps, or Here WeGo — or Share a link for the route. Apple Maps is recommended for multi-stop routes.

Importing Locations (Batch Import)

Import multiple locations at once from CSV, GPX, or KML files — useful for migrating data from other apps or quickly adding many places.

1. Open Batch Import from the Pro tab or main menu.
2. Choose the file format: CSV (spreadsheets), GPX (GPS tracks/waypoints), or KML (Google Earth).
3. Pick a target folder and a default category for locations that don’t specify one.
4. Tap Choose File, then review the preview.
5. Handle duplicates (within 10 meters) by skipping or merging.
6. Tap Import.

Format tips

• CSV: Required columns: title (or name), latitude/lat, longitude/lon/lng. Optional: address, notes, category, folder, landmark, city, state, country, timezone. Supports a combined coordinates column.
• GPX: Supports waypoints, track points, and route points. Unnamed points prompt for a base name. Descriptions import as notes.
• KML: Supports placemarks and points with valid coordinates. Descriptions and addresses import as notes.

For best results, use UTF-8 encoding and valid coordinates. Use the preview to double-check data before importing.

Exporting Locations (Pro)

1. Go to the Pro tab and select Export to PDF / CSV.
2. Select the locations you want to export. Use search, sort, and filters as needed.
3. Tap Configure to choose PDF or CSV, include map links, pick a map service, and select which fields to include (title, photo, address, coordinates, notes, category, folder, date added, visited status, map link, landmark). Reorder fields if you like.
4. Tap Preview, then Export. The share sheet opens when the file is ready.

PDF is best for printing and sharing with photos. CSV is ideal for backups or importing into other tools.

Maplet Pro Subscription

• Pro users get: unlimited location saves, Smart Journey Planner, Multi-Stop Route Mapping, Custom Export (PDF/CSV), Batch Import (CSV/GPX/KML), and more.
• Free users: all basic features, limited to saving up to 30 locations. You can organize, search, and share, but cannot access Pro-only features.

The one-year Pro subscription includes a 7-day free trial. Cancel before the trial ends to avoid being charged. Subscriptions auto-renew unless cancelled at least 24 hours before the end of the current period. Manage or cancel anytime via your Apple ID settings. By subscribing, you agree to the Terms of Use and Privacy Policy.

Cloud Sync (iCloud)

• Maplet uses iCloud to automatically sync locations, folders, and categories across your Apple devices.
• No account setup: just be signed into iCloud with iCloud Drive enabled.
• Your data is only accessible via your Apple ID.
• Changes (add, edit, delete) sync in the background.

If data isn’t syncing, check that you are signed into iCloud, have a stable internet connection, and iCloud Drive is enabled for Maplet. Try restarting the app or your device if issues persist.

Tips & Tricks

• Quick Save: Use the map center to quickly save your current view.
• Categories & Folders: Organize places for easy access.
• Photos & Voice Notes: Add rich details to remember why a place matters.
• Visited Flags: Track places you’ve been with a single tap.
• Search: Use the search bar in both Home and Saved tabs.
• Long-Press Actions: Long-press folders to share, rename, or delete.

Frequently Asked Questions

What happens if I reach the free location limit?

You won’t be able to save new locations until you delete some or upgrade to Pro for unlimited saves.

How do I restore my Pro subscription?

Go to the Pro/Upgrade screen and tap “Restore Purchases.” Make sure you’re signed in with the same Apple ID you used to subscribe.

Is my data private?

Yes. All your personal data is stored locally and synced via your private iCloud account. Folder share links are encoded on-device in the URL — nothing is uploaded to a Maplet server. Anonymous analytics and crash data may be sent to Firebase; see the Privacy Policy.

How do I transfer my data to a new device?

Sign in to iCloud on your new device and install Maplet. Your data will sync automatically.

What if I accidentally delete a location or folder?

Deletions are permanent. There’s no undo, so please double-check before deleting. If you delete a folder and it still appears, restart the app.

Can I use Maplet offline?

Yes. You can view, organize, and manage saved locations offline. Some features (map previews or iCloud sync) require internet.

What map apps are supported for sharing/opening locations?

Apple Maps, Google Maps, Waze, HERE, Citymapper, Gaode, Yandex, 2GIS, and Maps.me.

How do I cancel my subscription?

Open your device’s Settings, tap your Apple ID, go to Subscriptions, and select Maplet.

Can I share folders with others?

Yes, two ways: (1) a Universal Link at https://maplet.net/share?data=… — up to 30 locations, encoded on-device, opens as a web map (or in the app if installed); photos and voice notes are not included. (2) a .maplet file with complete data including photos and voice notes, and no location limit.

Does the other person need Maplet installed to open a share link?

No. The link always works in a browser. If they have Maplet, iOS can open it directly in the app via Universal Links.

What file formats does Maplet support for importing?

CSV, GPX, and KML. CSV is best for spreadsheets, GPX for GPS tracks, and KML for Google Earth files.

What export formats are available?

Pro users can export to PDF (for printing/sharing with photos) or CSV (for data backup and use in other apps). Both can include map links and customizable fields.

What’s the difference between temporary and green flags?

Temporary flags are cleared when the app restarts or when you press the clear flag button. Green flags are persistent, remain after restart, and can later be saved as a location.

What happens to my data if I uninstall Maplet?

If iCloud sync is enabled, your data remains in iCloud and can be restored when you reinstall. If not, local data will be lost.

Can I use Maplet without location permissions?

You can save locations manually by searching for addresses, but distance calculation, current-location display, and automatic location saving require location permissions.

What’s included in the Pro subscription?

Unlimited location saves, Shared Folders as .maplet files, Journey Planner & Checklists, Multi-Route Planner, Batch Import (CSV/GPX/KML), and Custom Export (PDF/CSV).

What if my iCloud sync isn’t working?

Check that you’re signed into iCloud, have a stable internet connection, and iCloud Drive is enabled for Maplet. Try restarting the app or your device.

What if I see duplicate folders or categories?

Restart the app. Maplet will automatically detect and fix these duplicates during startup.

Feature Requests & Support

For feature requests, bug reports, or anything else, email gemshi@me.com.