CuriooCity Tiles

🎨 Fast, local tile preview and theme editor for CuriooCity.

CuriooCity Tiles helps creators build and serve custom map styles for the game world. Built on top of Overpass API, it makes exploration more colorful, magical, and themeable.

Features

• Edit map theme colors and preview tiles instantly
• Preview themes without saving, then persist changes
• Serve PNG map tiles from OpenStreetMap / Overpass data
• Configure tile zoom range and runtime theme storage
• Protect tile requests with optional API keys
• Secure editor actions with Keycloak-based authentication
• Expose Prometheus metrics and use the included Grafana dashboard

Quick online start

Try Curioo Tiles instantly with the online demo:

👉 Launch the demo

No installation required. Open the demo, choose a map theme, and preview generated tiles directly in your browser.

Deploy with SaaShup

Quick local start

sudo docker run -p 3000:3000 \
  -e OVERPASS_URL=https://overpass/api/interpreter \
  saashup/curioo-tiles:latest

Then open:

• http://localhost:3000/editor

Documentation

• Installation from source
• Docker usage
• Configuration
• Monitoring with Prometheus and Grafana
• Contributing

Common commands

npm install
npm run dev
npm run test

Grafana dashboard

A ready-to-import Grafana dashboard is included here:

👉 Download the Grafana dashboard

License

MIT-style. See the project license file.