Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ign-argentina/argenmap/llms.txt

Use this file to discover all available pages before exploring further.

Argenmap requires no build step and no package manager — you only need a copy of the repository and a web server. This guide walks you from zero to a running map viewer in five minutes. By the end you will have the official Argentina base map on screen, and you will know how to add your first WMS overlay layer.

​
Prerequisites

  • A web server — VS Code Live Server extension is the easiest option for local development; Apache, Nginx, or python3 -m http.server all work too.
  • Git (optional — you can also download a ZIP).
1

Clone or download the repository

Clone the repository with Git:
git clone https://github.com/ign-argentina/argenmap.git
cd argenmap
Or download and unzip the archive directly — no Git required:
# Download
curl -L -o argenmap.zip https://github.com/ign-argentina/argenmap/archive/master.zip

# Unzip (Linux / macOS)
unzip argenmap.zip
cd argenmap-master
You can also paste https://github.com/ign-argentina/argenmap/archive/master.zip into your browser to trigger a download.
2

Copy the default configuration files

Argenmap ships read-only reference configs in src/config/default/. Copy them into src/config/ so you can edit them freely without touching the originals.Linux / macOS:
cp -r src/config/default/* src/config/
Windows: In File Explorer, open src\config\default\, select all files, and paste them into src\config\. Alternatively, in PowerShell:
Copy-Item src\config\default\* src\config\ -Recurse
After this step your src/config/ folder should contain at minimum data.json and preferences.json.
3

Open index.html with a web server

Argenmap must be served over HTTP — opening index.html as a file:// URL will block all tile and WMS requests due to browser CORS restrictions.VS Code Live Server (recommended for development):
  1. Open the argenmap folder in VS Code.
  2. Right-click index.html in the Explorer panel.
  3. Select Open with Live Server.
  4. Your browser opens automatically at http://127.0.0.1:5500.
Python (no extra install on most systems):
python3 -m http.server 8080
# Open http://localhost:8080 in your browser
Apache quick example:
sudo cp -r ~/argenmap /var/www/html/argenmap
# Open http://localhost/argenmap in your browser
4

Confirm the map loads

Navigate to the URL your web server is serving. You should see:
  • The Argentina base map centered at approximately latitude -40, longitude -59, zoom level 4.
  • A collapsible layer panel on the left side of the screen.
  • A toolbar with buttons for layers, base maps, add layers, help, and accessibility.
The default base map is served from IGN’s TMS endpoint:
https://wms.ign.gob.ar/geoserver/gwc/service/tms/1.0.0/capabaseargenmap@EPSG%3A3857@png/{z}/{x}/{-y}.png
If the map tiles appear but show a blank panel, confirm that src/config/data.json and src/config/preferences.json exist and are valid JSON.
5

Add your first WMS overlay layer

Open src/config/data.json in a text editor. The file contains an items array. Add a new WMS section object to that array, then save the file and reload the browser tab.The example below adds the IGN industry-and-services WMS as a collapsible section in the layer panel:
{
  "items": [
    {
      "type": "basemap",
      "peso": 1,
      "nombre": "Mapas base",
      "short_abstract": "",
      "class": "",
      "seccion": "mapasbase",
      "capas": [
        {
          "titulo": "Argenmap",
          "nombre": "argenmap",
          "servicio": "tms",
          "version": "1.0.0",
          "attribution": "<a href='https://www.ign.gob.ar' target='_blank'>Instituto Geográfico Nacional</a>",
          "host": "https://wms.ign.gob.ar/geoserver/gwc/service/tms/1.0.0/capabaseargenmap@EPSG%3A3857@png/{z}/{x}/{-y}.png",
          "legendImg": "src/styles/images/argenmap.png",
          "peso": 10,
          "selected": true,
          "zoom": { "min": 3, "max": 21, "nativeMin": 3, "nativeMax": 21 }
        }
      ]
    },
    {
      "type": "wmslayer",
      "peso": 70,
      "nombre": "Industry and services",
      "short_abstract": "Industrial, agricultural, mining, and energy data.",
      "class": "",
      "seccion": "industry-services",
      "servicio": "wms",
      "version": "1.3.0",
      "host": "https://wms.ign.gob.ar/geoserver/industria-servicios/wms"
    }
  ],
  "template": "ign-geoportal-basic"
}
Reload the browser. The Industry and services section appears in the layer panel. Click the section header to expand it and toggle individual layers on and off.

​
Adjust the map center and zoom

Edit src/config/preferences.json to change where the map opens. The mapConfig block controls the initial center coordinates and zoom level: 
{
  "mapConfig": {
    "center": {
      "latitude": -34.6,
      "longitude": -58.4
    },
    "zoom": {
      "initial": 12,
      "min": 3,
      "max": 21
    }
  }
}
This example centers the map on Buenos Aires at city-level zoom. Valid latitude values for Argentina range from roughly -22 (north) to -55 (south).
Every change to data.json or preferences.json requires a full browser reload to take effect. There is no hot-reload; a standard Ctrl+Shift+R or Cmd+Shift+R refresh is sufficient.

​
Next steps

  • Production deployment — see Deployment for step-by-step Apache and Nginx configuration.
  • Full configuration reference — see Configure data.json for all layer types, section options, and base map properties.

Build docs developers (and LLMs) love

Get started for freeTalk to us