saashup/curioo-tiles repository overview

⁠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.