Loading 3D GPX Viewer
Upload a .glb or .3mf model, or build one from a Strava or GPX route, and it gets a clear resin dome. Drag to orbit, scroll or pinch to zoom.
No examples yet. Upload your own model in the Model tab.
This file already contains clear resin, so no dome was added.
Turns a ride, run or hike into a 3D terrain model with your route on top.
Android phones with Chrome place it live on your desk. iPhones and iPads open it in Apple’s AR viewer.
Lifts or deepens the model’s colours if the resin washes them out. Only changes how it looks here, not your downloads.
Orbit and zoom until the paperweight sits naturally on the surface in the photo.
Saves the loaded model with everything as it looks now: resin, background, lighting and camera angle.
Surface
Shape
Match your dome: Square for Pyramid or Ziggurat, Hexagon for Hexagon or Twisted, Octagon for Diamond, Star for Star, Heart for Heart. Round and Square suit all the smooth domes.
Sides
Frame
Letters are raised in the route colour. Long titles shrink to fit.
Contour lines
Raised lines at even heights, every fifth one thicker. Spacing is picked to suit the hills.
Detail
Higher detail gives sharper hills and imagery, but takes longer and makes a bigger file.
3D printing
Your filaments
Use the viewer on the phone as normal. Press Esc to exit.
3D GPX Viewer shows a 3D model of your route inside a clear resin dome, like a paperweight, right in your web browser.
There's nothing to install, and nothing you open is uploaded anywhere.
It works on computers, tablets and phones in current versions of Chrome, Edge, Safari and Firefox.
Turn, zoom and slide the view with the gestures you already use.
| To do this | On a computer | On a phone or tablet |
|---|---|---|
| Turn the model | Drag with the mouse | Drag with one finger |
| Zoom in or out | Scroll the mouse wheel | Pinch |
| Slide the view | Right-drag | Drag with two fingers |
The settings panel sits in the corner of the screen and has five tabs:
Tap Hide to tuck the panel away and see the whole model, and Show to bring it back. The viewer remembers your settings, so it looks the same next time you visit on that device.
Tap any example card to open it, set up exactly as intended.
Each example loads with its own dome, background, lighting and camera angle already in place. After opening an example you can still change anything in the other tabs; tap the card again to go back to how it was set up.
If the tab says there are no examples yet, none have been published. You can still upload your own model in the Model tab.
Load your own model, save it with its dome, and choose what's shown.
Tap Upload .glb or .3mf and pick a file, or drag the file onto the page. The viewer accepts .glb files (from 3D apps and most online model makers) and .3mf files (from 3D-printing slicers such as Bambu Studio, OrcaSlicer and PrusaSlicer). A dome is added over the model automatically.
Tap Download with dome to save a .glb file of your model with the dome built in, ready to open in other 3D apps. Downloaded files include a small plaque on the table in front of the dome reading “Created with 3D GPX Viewer”. If the button isn't there, the site owner has turned downloads off.
| Tabletop and shadow | Shows the surface the model sits on. Turn it off to make the model float. |
| Show dome | Hides or shows the resin so you can compare. |
| Auto-rotate | Turns the model slowly by itself. |
The Model tab also has See it on your desk (AR), described in the AR section below.
Shape the resin and choose how clear, coloured and glassy it looks.
| Setting | What it does |
|---|---|
| Resin outline | Follow the model traces the model's outline; Circle makes a round dome. |
| Top edge | Dome curves smoothly, Chamfer gives a crisp angled edge, Flat gives a sharp square edge. |
| Height | How far the resin rises above the model. |
| Dome size or Chamfer size | How big the curve or angled edge is. The resin grows taller if needed so it always covers the model. |
| Opacity | From crystal clear at 0 to frosted resin at 100%. Frosting softens what's seen through the dome. |
| Tint | Colours the resin: Ice, Aqua, Emerald, Amber, Rose, Amethyst, Smoke, or any colour from the colour wheel. Tint strength sets how deep the colour is. |
| Reflections | How strongly the resin reflects light. |
| Bend the background through the resin | Makes the background warp through the resin like real glass. Turn it off for the sharpest view of the model. |
| Refraction | How strong the bending is. Shown when bending is on. |
Choose what the paperweight sits on and what's behind it.
Patterned backgrounds show off the clear resin best, because you can see the lines bend through the dome.
| Row | What's in it |
|---|---|
| Colours and patterns | Gradients (Studio sweep, Dusk, Sunset, Deep ocean, Midnight), patterns (Checker, Stripes, Diagonal, Polka dots, Waves, Grid paper) and a colour picker for any plain colour. |
| Abstract | Colourful images: Aurora, Bokeh lights, Liquid colour, Pearl and Silk. |
| Tables and desks | Oak, walnut, marble, concrete, linen, slate and terrazzo surfaces, each with a blurred office behind it. |
| Real world | Your own photo, or your device's camera. |
Pattern size appears for patterns and abstract images. Slide it left for a finer pattern, which gives a stronger bending effect through the dome.
Wall close behind the paperweight stands a wall just behind the model, whichever way you turn it, so there's always something close for the resin to bend. Wall distance moves it nearer or further away.
Tap Upload a photo, or drag an image onto the page, then choose how to use it:
| Backdrop | The photo fills the screen behind the model, like a photo of your desk. Turn and zoom until the model sits naturally on the surface. |
| Tabletop | The photo covers the table and the wall, repeated like a pattern. |
| Wall | The photo appears once on the wall behind the model, like a poster. |
| 360° | For panorama photos, which wrap all the way around. |
Use camera shows your device's live camera view behind the model. Your browser asks for permission first.
Pick a lighting preset to change the whole mood in one tap.
| Preset | Looks like |
|---|---|
| Studio | Soft, even light, good for seeing detail. |
| Window | Daylight falling across the table in soft window-shaped patches. |
| Golden hour | Low, warm evening sun with long shadows. |
| Overcast | Very soft, flat light with gentle shadows. |
| Desk lamp | Warm, moody light in a dim room. |
| Dramatic | One hard light with deep shadows. |
Open Adjust lighting to change individual settings:
| Direction | Moves the light around the model. |
| Height | Raises or lowers the light. |
| Brightness and Warmth | Change the light's strength and colour. |
| Shadow softness | Blurs or sharpens the shadow. |
| Room light | Brightens the dark side of the model. |
| Window light on the table | Adds the window patches to any preset. |
The resin's reflections move with the light, and the dome throws a small bright glint onto the table on the side away from it.
Place the paperweight on a real table through your phone's camera, at real size.
In the Model tab, under See it on your desk (AR), choose how big it should be: 8 cm, 12 cm or 20 cm across.
In AR the resin shows reflections but doesn't bend the real world behind it; phones don't let web pages do that. If neither button appears, your browser doesn't support AR. Try Chrome on Android or Safari on iPhone.
Quick fixes for the most common questions.
For the best-looking view, try a pattern or a table surface from the Scene tab with the Window or Golden hour lighting.
| Problem | Try this |
|---|---|
| The model looks blurry through the dome | Turn off Bend the background through the resin in the Dome tab for the sharpest view. |
| I can't see the resin | Pick a patterned or dark background in the Scene tab, and turn bending on in the Dome tab. |
| My model won't load | Make sure it's a .glb or .3mf file. If it mentions Draco or KTX2 compression, export it again without compression. Very large models may be too big. |
| My 3MF colours are missing | Colours painted with a slicer's paint tool aren't shown; each object shows its filament colour instead. |
| The page looks out of date | Refresh the page, or open it in a private window. |
| The camera or AR won't start | Allow camera access when your browser asks, and check the site address starts with https. |
Admins choose the examples visitors see in the Examples tab. How you sign in and publish depends on where the viewer runs.
| Where the viewer runs | Signing in | When visitors see changes |
|---|---|---|
| Your own website | With the admin password, at the bottom of the Examples tab. | After you export the examples and upload them to the website. |
| Inside Claude | Automatic for anyone who can edit the page. | Straight away. |
Open the Examples tab, enter the admin password at the bottom and tap Sign in.
Once you're signed in, the admin tools appear in place of the password box, and each example card gets buttons to reorder and delete it. Tap Admin guide there to open this guide in the app, and Sign out when you're finished.
While you're signed in, files you download (the model with its dome, and the iPhone AR file) have no watermark. Visitors' downloads include a small “Created with 3D GPX Viewer” plaque with your site address, and the same credit in the file's details.
You stay signed in until you sign out or close the browser tab. On the Claude-hosted page there's no password: if you can edit the page, the admin tools are already there.
An example saves the model together with how it looks, so visitors see it exactly as you set it up.
| Saved with the example | Not saved |
|---|---|
| The model, dome, background, lighting, reflections, refraction, AR size and camera angle | Your own uploaded photos and the live camera background. Choose a built-in background for examples. |
On the Claude-hosted page, models used as examples can be up to about 15 MB. On your website the limit is GitHub's 25 MB per file when uploading through the browser.
Examples appear in the order you set, left to right and top to bottom.
| Move earlier or later | Tap ↑ or ↓ on the card. |
| Delete | Tap ✕ on the card, then tap it again within five seconds to confirm. |
| Change an example | Open it, make your changes, add it again with the same name, then delete the old one. |
On your website, examples you add are saved in your browser as a draft. Visitors only see them after you publish.
elevate-examples.zip.examples, containing examples.json and a models folder.examples folder (not the zip) and commit.Repeat these steps whenever you add, remove or reorder examples. The new examples folder replaces the old one.
Open the site in a private window, or tap Sign out: while signed in you see your drafts, not the published examples. You can also open your-site-address/examples/examples.json; if it shows text starting with {"examples":, they're live.
Drafts are kept only in the browser you made them in. Clearing that browser's data, or switching to another computer, loses unpublished drafts, so export after each session. Signing in on a new device starts from the published examples.
Choose whether visitors can download the model and use iPhone AR. Admins can always do both.
In the Admin tab, under Visitor downloads:
| Visitors can download the model | Shows or hides Download with dome for visitors. |
| Visitors can use iPhone AR | Shows or hides the iPhone AR button in the Model tab. Apple’s AR viewer lets people save the file, so turn this off too if you don’t want visitors to have a copy. |
On the Claude-hosted page, changes apply straight away. On your website, the settings are saved with your example drafts: export the examples and upload the examples folder to apply them. Android AR places the model live without saving a file, so it stays available.
The Admin tab shows how many people have your website open right now, updated live, with a split by computer, phone and tablet.
It uses Supabase, a free online service. Setting it up takes about five minutes and only needs doing once.
config.js, tap the pencil icon and paste them between the quotes on the SUPABASE_URL and SUPABASE_KEY lines. Commit.| Status | What it means |
|---|---|
| Live | Working. The number updates as people arrive and leave. |
| Not set up | The Supabase details in config.js are empty. |
| Can’t connect | The details are wrong, the project is paused, or the connection dropped. Check config.js and your Supabase dashboard, then reload. |
| Website only | Shown on the Claude-hosted page, where the live count isn’t available. |
Each open copy of the viewer shares only its device type. No names, locations or cookies are used, and nothing is stored. The free plan allows about 200 people connected at once, and pauses projects that go unused for a week; if that happens, restore it from the Supabase dashboard. The publishable key is designed to be public, so it’s fine in config.js.
When there's a new version of the viewer, replace the files in your GitHub repository.
3d-gpx-viewer.zip on your computer.Your published examples folder isn't part of the download, so it stays as it is. Your settings live in config.js: leave that file out when uploading an update, so your password and Supabase details are kept.
To keep a record of each version, attach the zip to a GitHub release. Releases don't change the live site; only the files in the repository do.
The default password is elevate-admin. Change it before you share the site.
Only a coded version (hash) of the password is stored, in config.js on the line starting window.ELEVATE_ADMIN_HASH, so the password itself never appears in the code.
printf '%s' 'new-password' | shasum -a 256. On Windows, use the PowerShell command in the README.-).config.js, tap the pencil icon, replace the old value between the quotes, and commit.A website without a server can't truly lock anything, so the password only hides the admin tools. Nothing reaches visitors until someone with access to your GitHub repository uploads files, so your repository login is what really protects the site. Use a long password, as a short one could be guessed from its hash.
Quick fixes for common admin problems.
| Problem | Try this |
|---|---|
| Visitors don't see my examples | Export and upload the examples folder, then wait for the green tick in Actions. Check in a private window. |
| The site still shows the old version | Make sure you uploaded the unzipped files, not the zip, then refresh or use a private window. The site can take up to 10 minutes to update. |
| My drafts have disappeared | Drafts live in one browser. Use the browser you made them in, or add them again. |
| I forgot the admin password | Set a new one by replacing the hash in config.js. |
| The Admin tab says Can’t connect | Check the two Supabase values in config.js, and that the project isn’t paused. In Supabase, Realtime must allow public access (it does by default). |
| An example won't save | Load the model first, and keep it under the size limit. |
Move your phone slowly over a table, then tap to place the paperweight.