User Guide

What is Trasely?

Trasely is an iOS app that turns any shape into a real GPS route you can run, walk, or cycle. Instead of planning a route manually on a map, you start from a visual idea — a photo silhouette, a built-in shape, or a freehand sketch — and Trasely maps it onto real streets near you.

Under the hood, an on-device AI pipeline extracts the outline of your chosen shape, and a routing algorithm finds the closest real-world match on the street network. The result is a navigable GPS route you can export to virtually any fitness platform or device.

Requirements

• iOS 17.0 or later — required for the on-device Vision Framework (VNGenerateForegroundInstanceMaskRequest).
• iPhone or iPad — compatible with any device running iOS/iPadOS 17+.
• Internet connection — needed during route generation. Route viewing, editing, and the library work fully offline.
• Location permission — optional. Only requested when using "current location" as a starting point.
• Photos permission — only requested when importing a photo from your library (Photo to Route mode).

Your first route

The fastest way to create your first route:

1. Open Trasely and tap Create.
2. Tap Shape Library and pick a shape — a heart or star is a great start.
3. The Contour Editor opens with the shape pre-loaded. You can simplify or smooth it, or just tap Continue.
4. On the Route Setup screen, choose your activity (running, walking, or cycling) and set a target distance.
5. Tap Continue to open the Contour Placement map. Drag, pinch, and rotate the shape overlay to position it over your neighborhood.
6. Tap Generate Route and wait a few seconds.
7. Review the result on the Results screen. Tap Save & Export to keep it.

Shape Library

The Shape Library contains 50+ pre-optimized shapes: geometric forms, animals, letters, symbols, and more. Each shape is available in a Simple and Detailed variant. Simple variants produce cleaner, shorter routes; Detailed variants preserve more character but require a longer distance to match well.

After selecting a shape, you can still adjust it in the Contour Editor before routing.

Photo to Route PRO

Use any photo as a route template. Trasely uses Apple's Vision Framework to isolate the main subject and trace its outline entirely on-device — no image is ever uploaded anywhere.

Steps

1. Tap Create → Photo and select an image from your library.
2. Crop the image to frame your subject tightly.
3. Trasely automatically extracts the contour. Review and refine it in the Contour Editor if needed.
4. Continue to Route Setup → Contour Placement → Generation as usual.

Tips for clean contours

• High-contrast images with a clear subject on a simple background work best.
• Simple silhouettes — animals, logos, letters — translate best to street routes.
• Avoid complex scenes with multiple subjects or intricate fine detail.
• A hand-drawn shape on white paper, photographed from directly above, gives excellent results.

Freehand Draw PRO

Draw any shape directly on screen with your finger or Apple Pencil. No photo or library needed — Trasely captures your sketch as a contour and maps it to real streets.

Steps

1. Tap Create → Freehand Draw.
2. Draw your shape on the canvas. Close the shape by ending near your starting point.
3. Tap Done — Trasely converts your sketch into a contour.
4. Refine in the Contour Editor if needed, then continue to Route Setup.

Loop Route

Loop Route generates a circular route that starts and ends at the same point — ideal for training runs, where finishing where you started matters.

Options

• Activity — running, walking, or cycling, each with its own routing profile.
• Distance — set your target loop distance.
• Starting point — your current location or any point on the map.
• POI Waypoints — enable to route through nearby parks, cultural spots, cafés, or fitness facilities. Trasely uses MapKit to find nearby POIs and optimizes their order automatically.

Point-to-Point

Point-to-Point plans a route between any two locations. Tap a start and an end point on the map — Trasely builds the best path between them.

Unlike Loop Route, Point-to-Point routes don't return to the start. They're ideal for one-way exploration runs, city sightseeing routes, or planning a race course between two landmarks.

Distance is determined by the two chosen points, so there is no distance slider in Route Setup for this mode.

Image Overlay PRO

Point-to-Point includes an Image Overlay tool (requires PRO) — tap the Overlay button in the toolbar to place a reference photo on top of the map. You can then trace streets that follow the shape in your image. Drag to reposition, pinch to scale, rotate with two fingers, and adjust opacity. Tap Done when finished — the overlay disappears before saving.

Contour Editor

The Contour Editor appears after any shape is loaded — whether from the Shape Library, a photo, or a freehand sketch. It lets you refine the outline before routing.

Controls

• Drag a point — reposition individual vertices of the contour.
• Pinch — zoom in or out on the contour canvas.
• Simplify slider — reduces the number of points (Douglas–Peucker algorithm). Increase to remove noise; decrease to preserve detail. Fewer points generally means a cleaner route match.
• Smooth toggle — applies Chaikin curve smoothing for rounder, more organic-looking shapes.

Contour Placement & Scaling

Before generating a route, you position and size the shape on the map using the Contour Placement screen. The shape is overlaid on the map as a transparent outline.

Gestures

• Drag — move the shape to any location on the map.
• Pinch — scale the shape up or down. Larger = longer route distance.
• Two-finger rotate — rotate the shape. Orientation matters — sometimes rotating 45° dramatically improves the street match.
• Mirror — flip the shape horizontally using the toolbar button.

The overlay shows an approximate bounding box with the estimated route distance, so you can gauge the size before generating.

Route Editor

After a route is generated, the Route Editor lets you manually adjust individual waypoints. Drag any waypoint to a new position — it snaps to the nearest routable road in real time.

Tap the Undo button (or shake your device) to revert the last change. The full undo history is preserved for the duration of your editing session.

Route Options

The Route Setup screen appears before every route generation. It controls your activity profile, distance target, and detailed routing preferences.

Activity

Choose Running, Walking, or Cycling. Each uses a different routing profile: running/walking prioritizes footpaths and pedestrian zones; cycling prefers bike lanes and cycling paths.

Target Distance

Not available in Point-to-Point mode (distance is set by your two chosen points). For all other modes:

• Presets — tap chips like 5K, 10K, Half Marathon, Marathon, 50K, 100K (running); equivalent presets for walking and cycling. Longer presets require PRO.
• Stepper — increment or decrement by 1 km/mile.
• Slider — drag freely within the allowed range. The PRO portion of the range is highlighted; sliding into it snaps back unless you have PRO.
• Custom (PRO) — tap Edit to type in any exact value.

For contour-based routes, a Shape Tolerance stepper (5%–30%) controls how strictly the route must hit the target distance. A higher tolerance gives the algorithm more freedom and often improves the shape match.

Routing Options

These toggles apply to all activity profiles:

• Prefer Parks — biases routing toward park paths and green spaces.
• Avoid Highways — excludes main roads and motorways. Recommended for all on-foot activities.
• Avoid Ferries — prevents routes that require a ferry crossing.

Additional options for Running & Walking:

• Avoid Stairs — routes around staircases where an alternative exists.
• Prefer Flat Terrain — biases the route toward level ground. Useful for recovery runs or accessible walking routes.
• Prefer Lit Paths — favors paths with street lighting. Ideal for early-morning or after-dark runs.

Additional options for Cycling:

• Bicycle Type — Road, Hybrid, City, or Mountain. Affects which surfaces and paths the engine considers suitable.
• Avoid Hills — biases the route toward flatter terrain.

POI Waypoints (Loop Route only)

Enable to route through nearby points of interest. Choose from category groups — Parks & Nature, Culture & Landmarks, Food & Drink, Fitness & Sport. The routing engine determines the optimal visit order automatically.

Export Formats: GPX & TCX

From any Route Detail screen, tap Export to save your route as a file. Trasely supports two formats:

• GPX 1.1 — the universal GPS standard. Accepted by virtually every fitness platform, app, and device worldwide.
• TCX (Training Center XML) — a Garmin standard that includes structured workout data. Preferred by Garmin devices and platforms like TrainingPeaks. Requires Trasely PRO.

Both formats contain a sequence of GPS waypoints that define the route. They are plain XML files — you can open them in any text editor and they will work on any GPS device that accepts course files.

Exporting to Strava

1. In Trasely, open Route Detail → Export → GPX.
2. In the iOS share sheet, tap Save to Files and choose a location (e.g. iCloud Drive or On My iPhone).
3. Open the Strava app → tap You (bottom right) → My Routes.
4. Tap the Upload icon (top right) → select your GPX file from the Files app.
5. Name your route and save. It will appear in My Routes and can be used for navigation or shared with others.

Garmin Watches (Forerunner, Fenix, Epix, Vivoactive, Venu)

Garmin watches navigate using Courses, synced through the Garmin Connect app.

Step 1 — Import to Garmin Connect

1. Export your route from Trasely as GPX (or TCX with PRO).
2. Open the Garmin Connect app on your iPhone.
3. Tap More (bottom right) → Training & Planning → Courses.
4. Tap the + icon → Import Course.
5. Select the exported file from the Files app. Garmin Connect imports it as a Course.

Step 2 — Sync to your watch

1. Keep your watch nearby with Bluetooth on.
2. In Garmin Connect, open the Course you just imported → tap Send to Device → select your watch.
3. Alternatively, open the Garmin Connect app and pull to sync — all pending courses transfer automatically.

Step 3 — Navigate on your Garmin watch

The exact menu path varies by watch model, but the general flow is:

• Forerunner 55/165/255/265/955/965: Hold Up → Navigation → Courses → select your course → Do Course.
• Fenix / Epix: Hold Menu → Navigation → Courses → select your course → Do Course.
• Vivoactive / Venu: Apps → Navigate → Courses → select and start.
• Forerunner 45 / 245: Hold Up → Navigation → Courses (may require enabling Navigation in settings).

Once started, the watch shows a breadcrumb trail and distance/time to the next turn. Some models (955, Epix, Fenix 7+) show a full map.

Garmin Edge (Bike Computers)

Garmin Edge devices sync Courses through Garmin Connect, same as watches.

Via Garmin Connect (wireless)

1. Import your GPX or TCX file into Garmin Connect as described above.
2. Open the Course → Send to Device → select your Edge device.
3. On the Edge, go to Navigation → Courses → Saved Courses and start your course.

Via USB (direct file transfer)

1. Export your route as GPX from Trasely.
2. Connect your Garmin Edge to your Mac with a USB cable.
3. Open Finder → select the Garmin Edge from the sidebar.
4. Copy the GPX file to Garmin/NewFiles/ on the device.
5. Eject the device. The course will appear under Navigation → Courses.

Compatible models: Edge 130 Plus, 540, 840, 1040, 830, 1030 Plus, and all Explore models.

Apple Watch

Apple Watch does not support GPX course navigation natively in the built-in Workout app. To navigate a Trasely route on Apple Watch, use one of these companion apps:

Option A — via Komoot (recommended)

1. Export your route from Trasely as GPX.
2. Open Komoot on your iPhone → tap your profile → Tours.
3. Tap the + button → Import GPX → select your file.
4. Open the Komoot Apple Watch app on your watch.
5. Find your imported tour and tap Start Navigation. Komoot provides turn-by-turn haptic guidance on the watch.

Option B — via Strava

1. Import your GPX into Strava as a Route (see the Strava section above).
2. On your iPhone, open the Strava app → You → My Routes → open your route → tap Start Route.
3. The Strava Apple Watch app will follow along, showing pace, distance, and the route map.

Option C — via AllTrails

1. Export your route as GPX and import it into AllTrails via the web app (alltrails.com → profile → Import Track).
2. Open AllTrails on your Apple Watch → find the imported trail → tap Start.
3. AllTrails shows a map breadcrumb trail and alerts when you go off-route.

Polar (Ignite, Vantage, Pacer, Grit)

Polar watches support Route navigation through the Polar Flow web app and Polar Flow mobile app.

Step 1 — Import to Polar Flow

1. Export your route from Trasely as GPX.
2. On your computer, open flow.polar.com and log in.
3. Go to Explore → Routes → click Import route.
4. Select your GPX file. It will appear in your Routes list.

Step 2 — Sync to your watch

1. Connect your Polar watch to the Polar FlowSync app on your Mac or via the Polar Flow mobile app with Bluetooth.
2. The route syncs automatically during the next sync. On some models, you can also push a specific route from the Routes page.

Step 3 — Navigate on your Polar watch

• Polar Vantage V2/V3, Grit X/X Pro: Swipe to Favorites during an activity, or go to Back to Start / route navigation from the sport profile settings.
• Polar Pacer Pro / Ignite 3: Start an activity → swipe to the Route screen to see your position on the breadcrumb trail.
• Polar M430 / Vantage M2: Sync via Polar FlowSync → the route appears in Favorites → select it before starting an activity.

Polar watches show a breadcrumb map view and vibrate when you deviate from the route by more than a set distance.

Suunto (9 Peak, Vertical, Race, Wing)

Suunto watches import routes through the Suunto app on iPhone.

Steps

1. Export your route from Trasely as GPX.
2. Open the Suunto app on your iPhone → tap Explore (map icon).
3. Tap the + button → Import GPX file.
4. Select your file from the Files app. The route appears in your Routes list.
5. Keep your Suunto watch nearby — it syncs routes automatically over Bluetooth when the app is open.

Navigate on your Suunto watch

• Suunto 9 Peak Pro / Vertical / Race: Long press the upper button → Navigation → Routes → select your route → Navigate.
• Suunto 5 Peak / 7: Press and hold Start → Navigation → Routes → select and start.

Suunto shows a breadcrumb trail on the map screen, with distance remaining and deviation alerts.

COROS (APEX 2, PACE 3, VERTIX 2, PACE Pro)

COROS watches import routes through the COROS app.

Steps

1. Export your route from Trasely as GPX.
2. Open the COROS app on your iPhone → tap Training → Routes.
3. Tap the + icon in the top right → Import Route.
4. Select your GPX file from the Files app.
5. The route syncs to your watch automatically over Bluetooth.

Navigate on your COROS watch

• APEX 2 / APEX 2 Pro / VERTIX 2S: Press the bottom button → Navigation → Routes → select your route → press the dial to start.
• PACE 3 / PACE Pro: Press and hold the dial → Navigation → Routes → select and start.

COROS displays the route as a breadcrumb map with your current position, heading arrow, and distance to the finish.

Wahoo ELEMNT (Bolt, Roam, Mini)

Wahoo ELEMNT bike computers sync routes through the Wahoo Fitness app.

Steps

1. Export your route from Trasely as GPX.
2. Open the Wahoo Fitness app on your iPhone → tap Routes.
3. Tap Import (or the + icon) → select your GPX file from the Files app.
4. The route appears in your Routes library and syncs to your ELEMNT automatically over Wi-Fi or Bluetooth.

Navigate on your Wahoo ELEMNT

• On the ELEMNT, press the Menu button → Routes → select your route → press OK/Ride.
• The route appears as a turn-by-turn map. The ELEMNT gives audio and visual cues at each turn.

Compatible: ELEMNT Bolt (v1 & v2), ELEMNT Roam (v1 & v2), ELEMNT Mini.

Hammerhead Karoo (2, 3)

Hammerhead Karoo bike computers can receive routes directly via the web dashboard, no cable required.

Steps

1. Export your route from Trasely as GPX and transfer it to your Mac (AirDrop, iCloud Drive, or email).
2. On your Mac, open my.hammerhead.io and log in.
3. Go to Routes → click Upload → select your GPX file.
4. The route is pushed to your Karoo automatically over Wi-Fi the next time it syncs (or immediately if it's connected).

Navigate on your Karoo

• Tap Navigate on the home screen → Routes → select your route → Ride.
• The Karoo's full-color touchscreen shows turn-by-turn navigation with automatic rerouting if you go off-course.

Sigma ROX (12.1, 11.1, 4.0)

Sigma ROX bike computers import routes through the Sigma Link app.

Steps

1. Export your route from Trasely as GPX.
2. Open the Sigma Link app on your iPhone → tap Routes.
3. Tap the + button → Import from file → select your GPX from the Files app.
4. Sync your ROX device (connect via Bluetooth or USB depending on model).

Navigate on your Sigma ROX

• ROX 12.1 Evo / ROX 11.1 Evo: Menu → Navigation → Routes → select your route → Start Navigation.
• ROX 4.0: Menu → Routes → select → Start. Note: ROX 4.0 shows a breadcrumb trail; turn-by-turn is available on ROX 11.1 and 12.1.

Other Devices & Platforms

Komoot

Import GPX via the Komoot website or app → Tours → Import. Komoot provides turn-by-turn navigation on iOS, Android, and Apple Watch, and syncs to most Garmin, Wahoo, and COROS devices as well.

Apple Maps

Apple Maps does not support GPX import directly. Use Komoot, Strava, or AllTrails as an intermediary, then navigate via those apps.

Bryton (Rider 750, 420)

Import GPX via the Bryton Active app on iPhone → Routes → Import → sync to device over Bluetooth.

Amazfit (GTR 4, Cheetah, T-Rex)

Import GPX via the Zepp app → Discover → Route Import. Route navigation is available on Amazfit Cheetah, T-Rex Ultra, and Falcon. Availability varies by model; check the Zepp app for your specific device.

Samsung Galaxy Watch (Wear OS)

Samsung Galaxy Watch does not support native GPX navigation. Use Komoot or Strava (both have Wear OS apps) and import the route there. Navigate from the companion app's watch interface.

Pixel Watch / Other Wear OS

Same approach as Samsung Galaxy Watch — use a Wear OS-compatible navigation app like Komoot or Strava.

TrainingPeaks

Import GPX or TCX via the TrainingPeaks website → Add workout → Upload file. Courses in TrainingPeaks sync to Garmin Connect, Wahoo, and other connected platforms automatically.

Route Library

Every route you save is stored in the Library tab, powered by SwiftData — all data stays on your device. From the Library you can:

• Browse saved routes sorted by date or activity type.
• View full metrics, elevation profile, and the route map.
• Re-export any route to GPX or TCX at any time.
• Delete routes you no longer need.

There is no account or cloud sync — your library is private and stays on your device. It is included in your iPhone's iCloud or local backup automatically.

Settings

• Units — metric (km) or imperial (miles). Changes the display throughout the app.
• Default activity — pre-selects running, walking, or cycling when opening Route Setup.
• Map style — choose between map tile styles (street, terrain, satellite).
• EU routing server — routes requests through the Stadia Maps EU endpoint. Enable if you're based in Europe for potentially lower latency.

Trasely PRO

Trasely PRO is an optional subscription that removes all limits and unlocks advanced features. Three plans are available at launch:

• Monthly — billed monthly, cancel anytime.
• Annual — billed once per year, best ongoing value.
• Lifetime — single purchase, permanent access. Supports Family Sharing.

What PRO unlocks

• Unlimited route distance
• Unlimited saved routes in the library
• Full shape library (all 50+ shapes)
• Photo to Route mode
• Freehand Draw mode
• Custom distance input
• Image Overlay in Point-to-Point
• TCX export (in addition to GPX)
• Advanced contour editing tools

Restoring Purchases

If you have an active PRO subscription or Lifetime purchase and it's not showing on a new device:

1. Open Trasely → Settings → Subscription → Restore Purchases.
2. Make sure you're signed in with the same Apple ID used for the original purchase.
3. The restore completes instantly — no charge is made.

If restore fails, verify the subscription is still active: iOS Settings → tap your name → Subscriptions → Trasely.