GPX Map Viewer

GPX Files

\n\n \n \n \n \n \n \n \n \n \n",["D",1748291723139],"branchVersion","label",[18],"pulls","branches","forks","envVars",{"_182":113,"_184":26},"connections",{"_182":26,"_183":26},"count","unfilledCount","emptyCount",{"_35":220,"_13":221,"_64":222,"_45":-5,"_37":38,"_172":223,"_194":109,"_39":224,"_41":42,"_67":21,"_169":225,"_69":24,"_173":-5,"_198":226,"_17":227},{"_35":212,"_13":213,"_64":214,"_45":-5,"_37":38,"_172":133,"_194":109,"_39":215,"_41":216,"_67":21,"_169":217,"_69":24,"_173":-5,"_198":218,"_17":219},{"_35":168,"_13":18,"_64":65,"_45":-5,"_37":38,"_172":89,"_194":109,"_39":209,"_41":42,"_67":21,"_169":170,"_69":24,"_173":-5,"_198":210,"_17":211},{"_35":201,"_13":202,"_64":107,"_45":-5,"_37":38,"_172":203,"_194":109,"_39":204,"_41":89,"_67":205,"_169":206,"_69":24,"_173":-5,"_198":207,"_17":208},{"_35":190,"_13":191,"_64":192,"_45":-5,"_37":38,"_172":193,"_194":109,"_39":195,"_41":196,"_67":68,"_169":197,"_69":24,"_173":-5,"_198":199,"_17":200},"1069a548-53cb-11f0-9095-f69ea79377d9","map.js","d7511872-3a70-11f0-9108-9e149126039e",49,"latest",["D",1751079206696],18,"// Initialize the map\nconst map = L.map(\"map\").setView([0, 0], 2);\n\n// Define basemaps\nconst basemaps = {\n \"OpenStreetMap\": L.tileLayer(\"https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png\", {\n attribution: \"© OpenStreetMap contributors\",\n }),\n \"OpenTopoMap\": L.tileLayer(\"https://{s}.tile.opentopomap.org/{z}/{x}/{y}.png\", {\n attribution: \"© OpenStreetMap contributors, © OpenTopoMap\",\n }),\n \"Thunder - Landscape\": L.tileLayer(\n window.location.origin + \"/tiles/landscape/{z}/{x}/{y}.png\",\n {\n attribution: \"© OpenStreetMap contributors, © Thunderforest\",\n maxZoom: 22,\n },\n ),\n \"Thunder - Outdoors\": L.tileLayer(\n window.location.origin + \"/tiles/outdoors/{z}/{x}/{y}.png\",\n {\n attribution: \"© OpenStreetMap contributors, © Thunderforest\",\n maxZoom: 22,\n },\n ),\n \"USGS - National Map\": L.tileLayer(\n \"https://basemap.nationalmap.gov/arcgis/rest/services/USGSTopo/MapServer/tile/{z}/{y}/{x}?blankTile=false\",\n {\n attribution:\n \"USGS The National Map: National Boundaries Dataset, 3DEP Elevation Program, Geographic Names Information System, National Hydrography Dataset, National Land Cover Database, National Structures Dataset, and National Transportation Dataset; USGS Global Ecosystems; U.S. Census Bureau TIGER/Line data; USFS Road data; Natural Earth Data; U.S. Department of State HIU; NOAA National Centers for Environmental Information. Data refreshed February, 2025.\",\n maxZoom: 22,\n },\n ),\n};\n\n// Add default basemap\nbasemaps[\"OpenStreetMap\"].addTo(map);\n\n// Define overlay layers\nconst overlayLayers = {};\n\n// NOAA Weather Radar WMS Layer\nconst noaaRadarLayer = L.tileLayer.wms('https://opengeo.ncep.noaa.gov/geoserver/conus/conus_bref_qcd/ows', {\n layers: 'conus_bref_qcd',\n format: 'image/png',\n transparent: true,\n version: '1.1.1',\n attribution: '© NOAA National Weather Service',\n opacity: 0.7\n});\n\n// Create layer group for weather radar\nconst weatherRadar = L.layerGroup([noaaRadarLayer]);\noverlayLayers[\"Weather Radar\"] = weatherRadar;\n\n// Add layer control with basemaps and overlays\nconst layerControl = L.control.layers(basemaps, overlayLayers).addTo(map);\n\nlet currentGPX = null;\nlet allFiles = []; // Store all files for filtering\nlet selectedFiles = new Set(); // Store selected files\nlet gpxLayers = new Map(); // Store GPX layers for each file\nlet lastSelectedIndex = -1; // Track the last selected index\n\n// Function to select all tracks\nasync function selectAllTracks() {\n // Use filtered files if available, otherwise use all files\n const filesToSelect = window.currentFilteredFiles || allFiles;\n \n if (filesToSelect.length === 0) {\n return; // No files to select\n }\n\n // Add all visible files to selection (don't clear existing selections from other filters)\n filesToSelect.forEach(file => {\n selectedFiles.add(file.url);\n });\n\n // Update visual selection in the UI for currently visible items\n document.querySelectorAll(\".file-item\").forEach(item => {\n item.classList.add(\"selected\");\n });\n\n // Load all GPX files that aren't already loaded\n for (const file of filesToSelect) {\n if (!gpxLayers.has(file.url)) {\n await loadGPX(file);\n }\n }\n\n // Update the map to show all tracks\n await updateMap();\n}\n\n// Function to deselect all tracks\nasync function deselectAllTracks() {\n // Use filtered files if available, otherwise use all files\n const filesToDeselect = window.currentFilteredFiles || allFiles;\n \n // Remove visible files from selection\n filesToDeselect.forEach(file => {\n selectedFiles.delete(file.url);\n });\n\n // Update visual selection in the UI for currently visible items\n document.querySelectorAll(\".file-item\").forEach(item => {\n item.classList.remove(\"selected\");\n });\n\n // Reset last selected index if no files are selected\n if (selectedFiles.size === 0) {\n lastSelectedIndex = -1;\n }\n\n // Update the map\n await updateMap();\n}\n\n// Function to update track opacity\nfunction updateTrackOpacity(opacity) {\n gpxLayers.forEach(layer => {\n if (layer) {\n layer.setStyle({ opacity: opacity, weight: 3 });\n }\n });\n}\n\n// Function to load a GPX file\nasync function loadGPX(gpxFile) {\n // Check if we already have this file loaded\n if (gpxLayers.has(gpxFile.url)) {\n return gpxLayers.get(gpxFile.url);\n }\n\n try {\n // Read the file content\n const text = await gpxFile.file.text();\n\n // Create new GPX layer\n const gpxLayer = new L.GPX(text, {\n async: true,\n marker_options: {\n startIconUrl:\n \"https://raw.githubusercontent.com/pointhi/leaflet-color-markers/master/img/marker-icon-2x-red.png\",\n endIconUrl:\n \"https://raw.githubusercontent.com/pointhi/leaflet-color-markers/master/img/marker-icon-2x-green.png\",\n shadowUrl: \"https://cdnjs.cloudflare.com/ajax/libs/leaflet/1.7.1/images/marker-shadow.png\",\n wptIconUrls: {\n \"\": \"https://raw.githubusercontent.com/pointhi/leaflet-color-markers/master/img/marker-icon-2x-blue.png\",\n },\n },\n });\n\n // Wait for the GPX to be loaded\n await new Promise((resolve, reject) => {\n gpxLayer.on(\"loaded\", resolve);\n gpxLayer.on(\"error\", reject);\n });\n\n // Store the layer\n gpxLayers.set(gpxFile.url, gpxLayer);\n return gpxLayer;\n } catch (error) {\n console.error(\"Error loading GPX file:\", error);\n return null;\n }\n}\n\n// Function to update the map with selected files\nasync function updateMap() {\n // Remove all existing layers\n gpxLayers.forEach(layer => {\n if (map.hasLayer(layer)) {\n map.removeLayer(layer);\n }\n });\n\n // Add selected layers and collect their bounds\n const bounds = L.latLngBounds();\n let hasBounds = false;\n\n for (const fileUrl of selectedFiles) {\n const layer = gpxLayers.get(fileUrl);\n if (layer) {\n layer.addTo(map);\n if (layer.getBounds) {\n bounds.extend(layer.getBounds());\n hasBounds = true;\n }\n }\n }\n\n // Fit map to show all tracks if we have bounds\n if (hasBounds) {\n map.fitBounds(bounds, { padding: [50, 50] });\n }\n}\n\n// Function to create file list\nfunction createFileList(files) {\n const container = document.getElementById(\"file-list-container\");\n container.innerHTML = \"\";\n\n files.forEach((file, index) => {\n const div = document.createElement(\"div\");\n div.className = \"file-item\";\n if (selectedFiles.has(file.url)) {\n div.classList.add(\"selected\");\n }\n div.textContent = file.name;\n div.onclick = async (e) => {\n const isMultiSelect = e.metaKey || e.ctrlKey;\n const isRangeSelect = e.shiftKey && lastSelectedIndex !== -1;\n\n if (isRangeSelect) {\n // Select range of files\n const start = Math.min(lastSelectedIndex, index);\n const end = Math.max(lastSelectedIndex, index);\n\n // Clear existing selections if not using multi-select\n if (!isMultiSelect) {\n selectedFiles.clear();\n document.querySelectorAll(\".file-item\").forEach(item => {\n item.classList.remove(\"selected\");\n });\n }\n\n // Select all files in range\n for (let i = start; i <= end; i++) {\n const rangeFile = files[i];\n selectedFiles.add(rangeFile.url);\n container.children[i].classList.add(\"selected\");\n const layer = await loadGPX(rangeFile);\n if (layer) {\n await updateMap();\n }\n }\n } else if (isMultiSelect) {\n // Toggle selection\n if (selectedFiles.has(file.url)) {\n selectedFiles.delete(file.url);\n div.classList.remove(\"selected\");\n } else {\n selectedFiles.add(file.url);\n div.classList.add(\"selected\");\n }\n } else {\n // Single select\n selectedFiles.clear();\n document.querySelectorAll(\".file-item\").forEach(item => {\n item.classList.remove(\"selected\");\n });\n selectedFiles.add(file.url);\n div.classList.add(\"selected\");\n }\n\n // Update last selected index\n lastSelectedIndex = index;\n\n // Load the file if not already loaded\n const layer = await loadGPX(file);\n if (layer) {\n // Update the map\n await updateMap();\n }\n };\n container.appendChild(div);\n });\n}\n\n// Function to filter files based on search input\nfunction filterFiles(searchTerm) {\n const filteredFiles = allFiles.filter(file => file.name.toLowerCase().includes(searchTerm.toLowerCase()));\n createFileList(filteredFiles);\n \n // Store filtered files for selection buttons to work with\n window.currentFilteredFiles = filteredFiles;\n}\n\n// Function to handle directory selection using File System Access API (modern browsers)\nasync function handleDirectorySelectModern() {\n try {\n // Request directory access\n const dirHandle = await window.showDirectoryPicker();\n\n // Get all files in the directory\n allFiles = [];\n for await (const entry of dirHandle.values()) {\n if (entry.kind === \"file\" && entry.name.endsWith(\".gpx\")) {\n const file = await entry.getFile();\n allFiles.push({\n name: entry.name,\n url: URL.createObjectURL(file),\n file: file,\n });\n }\n }\n\n if (allFiles.length > 0) {\n processSelectedFiles();\n } else {\n throw new Error(\"No GPX files found in the selected directory\");\n }\n } catch (error) {\n console.error(\"Error accessing directory:\", error);\n const container = document.getElementById(\"file-list-container\");\n container.innerHTML = \"

Error accessing directory: \" + error.message + \"

\";\n }\n}\n\n// Function to handle directory selection using fallback method (broader browser support)\nfunction handleDirectorySelectFallback() {\n // Create a hidden file input with directory support\n const fileInput = document.createElement(\"input\");\n fileInput.type = \"file\";\n fileInput.webkitdirectory = true;\n fileInput.multiple = true;\n fileInput.accept = \".gpx\";\n fileInput.style.display = \"none\";\n\n fileInput.addEventListener(\"change\", (event) => {\n const files = Array.from(event.target.files);\n const gpxFiles = files.filter(file => file.name.toLowerCase().endsWith(\".gpx\"));\n\n if (gpxFiles.length > 0) {\n allFiles = gpxFiles.map(file => ({\n name: file.name,\n url: URL.createObjectURL(file),\n file: file,\n }));\n \n processSelectedFiles();\n } else {\n const container = document.getElementById(\"file-list-container\");\n container.innerHTML = \"

No GPX files found in the selected directory.

\";\n }\n });\n\n // Trigger the file picker\n document.body.appendChild(fileInput);\n fileInput.click();\n document.body.removeChild(fileInput);\n}\n\n// Function to process selected files (common logic)\nasync function processSelectedFiles() {\n // Clear previous selections\n selectedFiles.clear();\n gpxLayers.clear();\n lastSelectedIndex = -1;\n\n // Initialize filtered files to all files\n window.currentFilteredFiles = allFiles;\n\n createFileList(allFiles);\n // Select and load the first file\n selectedFiles.add(allFiles[0].url);\n document.querySelector(\".file-item\").classList.add(\"selected\");\n lastSelectedIndex = 0;\n const layer = await loadGPX(allFiles[0]);\n if (layer) {\n await updateMap();\n }\n}\n\n// Main function to handle directory selection with fallback\nasync function handleDirectorySelect() {\n // Check if the modern File System Access API is available\n if ('showDirectoryPicker' in window) {\n await handleDirectorySelectModern();\n } else {\n // Fallback to the older webkitdirectory method\n handleDirectorySelectFallback();\n }\n}\n\n// Add directory selection button and search input\nconst fileList = document.getElementById(\"file-list\");\n\n// Create opacity control\nconst opacityContainer = document.createElement(\"div\");\nopacityContainer.style.marginBottom = \"20px\";\n\nconst opacityLabel = document.createElement(\"label\");\nopacityLabel.textContent = \"Track Opacity: \";\nopacityLabel.style.marginRight = \"10px\";\n\nconst opacitySlider = document.createElement(\"input\");\nopacitySlider.type = \"range\";\nopacitySlider.min = \"0\";\nopacitySlider.max = \"1\";\nopacitySlider.step = \"0.1\";\nopacitySlider.value = \"1\";\nopacitySlider.style.width = \"100%\";\nopacitySlider.style.marginTop = \"5px\";\n\nopacitySlider.addEventListener(\"input\", (e) => {\n updateTrackOpacity(parseFloat(e.target.value));\n});\n\nopacityContainer.appendChild(opacityLabel);\nopacityContainer.appendChild(opacitySlider);\nfileList.insertBefore(opacityContainer, document.getElementById(\"file-list-container\"));\n\n// Create basemap selector\nconst basemapContainer = document.createElement(\"div\");\nbasemapContainer.style.marginBottom = \"20px\";\n\nconst basemapLabel = document.createElement(\"label\");\nbasemapLabel.textContent = \"Base Map: \";\nbasemapLabel.style.marginRight = \"10px\";\n\nconst basemapSelect = document.createElement(\"select\");\nbasemapSelect.style.padding = \"5px\";\nbasemapSelect.style.width = \"100%\";\nbasemapSelect.style.marginTop = \"5px\";\n\nObject.keys(basemaps).forEach(name => {\n const option = document.createElement(\"option\");\n option.value = name;\n option.textContent = name;\n basemapSelect.appendChild(option);\n});\n\nbasemapSelect.addEventListener(\"change\", (e) => {\n // Remove current base layer\n Object.values(basemaps).forEach(layer => {\n if (map.hasLayer(layer)) {\n map.removeLayer(layer);\n }\n });\n // Add selected base layer\n basemaps[e.target.value].addTo(map);\n});\n\nbasemapContainer.appendChild(basemapLabel);\nbasemapContainer.appendChild(basemapSelect);\nfileList.insertBefore(basemapContainer, document.getElementById(\"file-list-container\"));\n\n// Create search container\nconst searchContainer = document.createElement(\"div\");\nsearchContainer.style.marginBottom = \"20px\";\n\n// Create search input\nconst searchInput = document.createElement(\"input\");\nsearchInput.type = \"text\";\nsearchInput.placeholder = \"Search GPX files...\";\nsearchInput.style.width = \"100%\";\nsearchInput.style.padding = \"10px\";\nsearchInput.style.boxSizing = \"border-box\";\nsearchInput.style.marginBottom = \"10px\";\nsearchInput.addEventListener(\"input\", (e) => filterFiles(e.target.value));\n\n// Add elements to the page\nsearchContainer.appendChild(searchInput);\nfileList.insertBefore(searchContainer, document.getElementById(\"file-list-container\"));\n\nconst selectButton = document.createElement(\"button\");\nselectButton.textContent = \"Select GPX Directory\";\nselectButton.style.marginBottom = \"20px\";\nselectButton.style.padding = \"10px\";\nselectButton.style.width = \"100%\";\nselectButton.onclick = handleDirectorySelect;\n\nfileList.insertBefore(selectButton, document.getElementById(\"file-list-container\"));\n\n// Create selection control buttons container\nconst selectionContainer = document.createElement(\"div\");\nselectionContainer.style.marginBottom = \"20px\";\nselectionContainer.style.display = \"flex\";\nselectionContainer.style.gap = \"10px\";\n\n// Create Select All button\nconst selectAllButton = document.createElement(\"button\");\nselectAllButton.textContent = \"Select All\";\nselectAllButton.style.padding = \"8px 12px\";\nselectAllButton.style.flex = \"1\";\nselectAllButton.style.fontSize = \"12px\";\nselectAllButton.onclick = selectAllTracks;\n\n// Create Deselect All button\nconst deselectAllButton = document.createElement(\"button\");\ndeselectAllButton.textContent = \"Deselect All\";\ndeselectAllButton.style.padding = \"8px 12px\";\ndeselectAllButton.style.flex = \"1\";\ndeselectAllButton.style.fontSize = \"12px\";\ndeselectAllButton.onclick = deselectAllTracks;\n\nselectionContainer.appendChild(selectAllButton);\nselectionContainer.appendChild(deselectAllButton);\nfileList.insertBefore(selectionContainer, document.getElementById(\"file-list-container\"));","children",[],[191],"79d63cb4-3a74-11f0-8eea-9e149126039e","main.tsx",15,["D",1748293238312],"http","import { readFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\nexport default async function (req: Request): Promise {\n const url = new URL(req.url);\n \n // Serve the main index.html page\n if (url.pathname === \"/\" || url.pathname === \"/index.html\") {\n try {\n const html = await readFile(\"/index.html\", import.meta.url);\n return new Response(html, {\n headers: { \"Content-Type\": \"text/html\" },\n });\n } catch (error) {\n return new Response(\"Error loading index.html\", { status: 500 });\n }\n }\n \n // Proxy Thunderforest tile requests to keep API key private\n if (url.pathname.startsWith(\"/tiles/\")) {\n const thunderforestApiKey = Deno.env.get('thunderforestAPIKey') || '';\n if (!thunderforestApiKey) {\n return new Response(\"API key not configured\", { status: 500 });\n }\n \n // Extract the tile path (everything after /tiles/)\n const tilePath = url.pathname.substring(7); // Remove \"/tiles/\"\n const queryParams = url.search;\n \n // Construct the Thunderforest URL\n const thunderforestUrl = `https://tile.thunderforest.com/${tilePath}?apikey=${thunderforestApiKey}${queryParams ? '&' + queryParams.substring(1) : ''}`;\n \n try {\n const response = await fetch(thunderforestUrl);\n const headers = new Headers();\n \n // Copy relevant headers\n if (response.headers.get('content-type')) {\n headers.set('content-type', response.headers.get('content-type')!);\n }\n \n // Add CORS headers for browser access\n headers.set('Access-Control-Allow-Origin', '*');\n \n return new Response(response.body, {\n status: response.status,\n headers: headers\n });\n } catch (error) {\n return new Response(\"Error fetching tile\", { status: 500 });\n }\n }\n \n // Serve a config.js with free map providers (no API key needed)\n if (url.pathname === \"/config.js\") {\n const configJs = `const config = {\n // Using free OpenStreetMap tiles - no API key required\n MAP_PROVIDERS: {\n osm: {\n url: 'https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png',\n attribution: '© OpenStreetMap contributors'\n },\n // If you want to use Thunderforest, tiles are proxied through /tiles/\n thunderforest: {\n url: '/tiles/landscape/{z}/{x}/{y}.png',\n attribution: '© Thunderforest, © OpenStreetMap contributors'\n }\n }\n};`;\n \n return new Response(configJs, {\n headers: { \"Content-Type\": \"application/javascript\" },\n });\n }\n \n // Serve map.js\n if (url.pathname === \"/map.js\") {\n try {\n const mapJs = await readFile(\"/map.js\", import.meta.url);\n return new Response(mapJs, {\n headers: { \"Content-Type\": \"application/javascript\" },\n });\n } catch (error) {\n return new Response(\"Error loading map.js\", { status: 500 });\n }\n }\n \n // 404 for other paths\n return new Response(\"Not Found\", { status: 404 });\n}",[],[202],["D",1748291723139],[],[18],"1e01c96a-53cb-11f0-8b66-f69ea79377d9","README.md","aebe3a2e-3a76-11f0-951a-9e149126039e",["D",1751079229524],16,"# GPX Map Viewer\n\nA web-based GPX file viewer that allows you to visualize GPS tracks on various basemaps.\n\n### Key Features\n\n- **Multi-file Support**: Load and view multiple GPX files simultaneously from a local directory\n- **Interactive Map Controls**: Pan, zoom, and switch between different map styles\n- **Multiple Basemaps**: Choose from OpenStreetMap, OpenTopoMap, and premium Thunderforest maps (Landscape and Outdoors)\n- **File Management**: Search and filter GPX files, select multiple files with Ctrl/Cmd+click or Shift+click for range selection, or use Select All/Deselect All buttons for quick bulk operations\n- **Track Customization**: Adjust track opacity with a slider control\n- **Visual Markers**: Start points (red), end points (green), and waypoints (blue) are clearly marked\n- **Auto-fit**: Map automatically adjusts to show all selected tracks\n- **API Key Protection**: Thunderforest API keys are kept secure on the server side\n\n### Technical Architecture\n\n- **Frontend**: Vanilla JavaScript with Leaflet.js for mapping and Leaflet.GPX for GPX file parsing\n- **Backend**: TypeScript HTTP handler that serves static files and proxies map tile requests\n- **Map Tiles**: Supports both free (OpenStreetMap, OpenTopoMap) and premium (Thunderforest) tile providers\n- **File Access**: Uses the modern File System Access API for Chrome/Edge browsers, with automatic fallback to webkitdirectory for broader browser compatibility\n\n## How to Run\n\n### Prerequisites\n\n1. **Val Town Account**: This application runs on Val Town's serverless platform\n2. **Thunderforest API Key** (Optional): Required only if you want to use premium Thunderforest maps\n\n### Environment Variables\n\nTo use Thunderforest premium maps (Landscape and Outdoors styles), you need to set up an API key:\n\n1. **Get a Thunderforest API Key**:\n - Visit [Thunderforest](https://www.thunderforest.com/)\n - Sign up for a free account (includes 150,000 free map requests per month)\n - Navigate to your API Keys section in the dashboard\n - Copy your API key\n\n2. **Set Environment Variable in Val Town**:\n - In your Val Town project, go to the Environment Variables section\n - Add a new environment variable:\n - **Name**: `thunderforestAPIKey`\n - **Value**: Your Thunderforest API key (e.g., `abc123def456ghi789`)\n\n### Running the Application\n\n1. **Deploy to Val Town**: The `main.tsx` file is configured as an HTTP trigger\n2. **Access the Application**: Visit your Val Town URL to open the GPX viewer\n3. **Load GPX Files**: Click \"Select GPX Directory\" to choose a folder containing your GPX files\n\n### Usage Instructions\n\n1. **Select Directory**: Click the \"Select GPX Directory\" button and choose a folder containing `.gpx` files\n2. **Browse Files**: Use the file list on the left to navigate your GPX files\n3. **Select Tracks**: \n - Single click to select one file\n - Ctrl/Cmd+click to select multiple files\n - Shift+click to select a range of files\n - Use \"Select All\" button to select all visible files\n - Use \"Deselect All\" button to deselect all visible files\n4. **Search**: Use the search box to filter files by name\n5. **Bulk Selection**: \n - \"Select All\" button selects all currently visible files (respects search filter)\n - \"Deselect All\" button deselects all currently visible files\n6. **Customize View**:\n - Change basemap using the dropdown menu\n - Adjust track opacity with the slider\n7. **Navigate**: Use standard map controls to pan and zoom\n\n### Map Providers\n\n- **OpenStreetMap**: Free, general-purpose map (no API key required)\n- **OpenTopoMap**: Free topographic map (no API key required)\n- **Thunderforest Landscape**: Premium landscape-focused map (requires API key)\n- **Thunderforest Outdoors**: Premium outdoor activities map (requires API key)\n- **USGS National Map**: [The National Map](https://www.usgs.gov/programs/national-geospatial-program/national-map) from USGS\n\n### Browser Compatibility\n\nThis application works with most modern browsers:\n- **Chrome/Edge 86+**: Full support with modern File System Access API\n- **Firefox, Safari, and older browsers**: Fallback support using webkitdirectory attribute\n- **All browsers**: ES6+ JavaScript features and WebGL for map rendering required\n\n### File Format Support\n\n- **GPX Files**: Standard GPS Exchange Format files with tracks, routes, and waypoints\n- **File Extensions**: `.gpx` files only\n- **Content**: Supports tracks with multiple segments, waypoints, and route data\n\n## Development\n\n### Project Structure\n\n```\n├── main.tsx # HTTP handler and tile proxy server\n├── index.html # Main application HTML\n├── map.js # Frontend JavaScript for map functionality\n└── README.md # This file\n```\n\n### API Endpoints\n\n- `/` - Serves the main application\n- `/tiles/*` - Proxies Thunderforest tile requests (keeps API key secure)\n- `/config.js` - Provides map configuration\n- `/map.js` - Serves the main JavaScript file\n\n### Security Features\n\n- API keys are stored securely as environment variables\n- Thunderforest requests are proxied through the server to prevent key exposure\n- CORS headers are properly configured for tile requests\n\n## Troubleshooting\n\n### Common Issues\n\n1. **\"Select GPX Directory\" not working**: \n - Modern browsers (Chrome/Edge 86+) use the File System Access API\n - Older browsers automatically use a fallback method with broader compatibility\n - If neither works, ensure JavaScript is enabled and try a different browser\n2. **Thunderforest maps not loading**: Check that your `thunderforestAPIKey` environment variable is set correctly\n3. **No GPX files found**: Ensure your directory contains files with `.gpx` extension\n4. **Maps not displaying**: Check browser console for JavaScript errors and ensure internet connectivity\n\n### Error Messages\n\n- **\"API key not configured\"**: Set the `thunderforestAPIKey` environment variable\n- **\"Error accessing directory\"**: Browser doesn't support File System Access API or permission denied\n- **\"No GPX files found\"**: Selected directory contains no `.gpx` files",[],[213],"4351fd6a-3a77-11f0-afb8-9e149126039e","LICENSE.md","3b0f808c-3a77-11f0-aad8-9e149126039e",25,["D",1748294435338],"MIT License\n\nCopyright (c) [year] [fullname]\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.",[],[221],["D",1748291677148],{"_11":12,"_146":72},{"_11":12,"_142":-5,"_71":72,"_30":70,"_143":144,"_145":24},{"_41":133,"_13":16,"_35":38,"_134":95,"_135":-5,"_136":-5,"_137":-5,"_138":-5,"_139":-5,"_140":14,"_141":12},"ctx",{"_54":-5,"_165":265,"_266":267,"_268":269,"_270":24,"_271":24,"_272":24,"_273":109,"_274":-5,"_275":-7,"_276":-7,"_277":26,"_278":24,"_279":24,"_280":-5,"_281":24,"_282":24,"_283":24,"_284":-5},"ENV",{"_236":237,"_238":239,"_240":16,"_241":242,"_243":244,"_245":246,"_247":248,"_249":250,"_251":252,"_253":254,"_255":256,"_257":258,"_259":260,"_261":262,"_263":264},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","71c1b20804b3232a7e513be260cfffc1932a9e97","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History · index.html