InsideGubbio AR — Location-based augmented reality platform for Gubbio monuments

.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+.DS_Store
+*.log
+.env
+dist/
+tmp/

CNAME

@@ -0,0 +1 @@
+dev.discoverygubbio.com

README.md

@@ -0,0 +1,88 @@
+# InsideGubbio AR
+
+Piattaforma di realtà aumentata per esplorare i monumenti di Gubbio.
+
+## Funzionalità
+
+- **Geolocalizzazione** — Rileva automaticamente la posizione dell'utente e identifica i monumenti vicini
+- **Fotocamera AR** — Inquadra i monumenti per attivare l'esperienza in realtà aumentata
+- **Audio guide** — Ascolta le storie di ogni monumento con il toggle audio
+- **Pannello informativo** — Leggi descrizioni dettagliate che compaiono dal basso
+- **Personaggi storici** — Incontra personaggi legati a ogni monumento
+- **Decorazioni AR** — Particelle ed effetti visivi unici per ogni monumento
+- **Percorsi guidati** — Scegli tra diversi itinerari tematici
+
+## Monumenti
+
+| Monumento | Epoca | Categoria |
+|-----------|-------|-----------|
+| Palazzo dei Consoli | XIV secolo | Palazzo |
+| Basilica di Sant'Ubaldo | XVI secolo | Chiesa |
+| Teatro Romano | I secolo a.C. | Archeologico |
+| Palazzo Ducale | XV secolo | Palazzo |
+| Fontana dei Matti | XIV secolo | Fontana |
+| Chiesa di San Francesco | XIII secolo | Chiesa |
+
+## Struttura
+
+```
+├── index.html              # Pagina principale (SPA)
+├── css/
+│   └── style.css           # Stili dell'applicazione
+├── js/
+│   ├── app.js              # Logica principale e navigazione
+│   ├── ar.js               # Engine AR (fotocamera, overlay, particelle)
+│   └── monuments.js        # Servizio dati monumenti
+├── api/
+│   └── monuments.json      # Dati dei monumenti e percorsi
+└── assets/
+    ├── audio/              # File audio delle guide (da caricare)
+    └── images/             # Immagini (da caricare)
+```
+
+## Utilizzo
+
+1. Apri `index.html` in un browser (o servila con un server HTTP)
+2. Dalla home, tocca **Avvia AR** per la modalità automatica con GPS
+3. Oppure tocca **Esplora monumenti** per scegliere un monumento specifico
+4. Nella vista AR:
+   - **Audio** — Attiva/disattiva la guida audio
+   - **Info** — Mostra il pannello con la descrizione completa
+   - **Personaggio** — Mostra/nascondi il personaggio storico
+
+## Aggiungere contenuti
+
+### Audio
+Carica i file audio MP3 nella cartella `assets/audio/` con i nomi specificati in `api/monuments.json`.
+
+### Testi
+Modifica le descrizioni in `api/monuments.json` per aggiornare i testi di ogni monumento.
+
+## Requisiti
+
+- Browser moderno con supporto a:
+  - Geolocation API
+  - MediaDevices API (fotocamera)
+  - CSS backdrop-filter
+- Connessione HTTPS (richiesta per fotocamera e geolocalizzazione)
+
+## Sviluppo
+
+Servire i file con un server HTTP locale:
+
+```bash
+# Con Python
+python3 -m http.server 8000
+
+# Con Node.js
+npx serve .
+```
+
+## Design
+
+Il design è ispirato a [insidegubbio.framer.website](https://insidegubbio.framer.website), con:
+- Palette scura ed elegante
+- Accenti dorati e colori per categoria
+- Tipografia serif per i titoli (Playfair Display)
+- Animazioni fluide e transizioni morbide
+- UI ottimizzata per dispositivi mobili

api/monuments.json

@@ -0,0 +1,144 @@
+{
+  "monuments": [
+    {
+      "id": "palazzo-dei-consoli",
+      "name": "Palazzo dei Consoli",
+      "subtitle": "Il simbolo di Gubbio",
+      "description": "Il Palazzo dei Consoli è uno dei più imponenti edifici pubblici medievali d'Italia. Costruito tra il 1332 e il 1349 su progetto attribuito a Angelo da Orvieto, domina Piazza Grande con la sua maestosa facciata in pietra bianca. Ospita il Museo Civico con le celebri Tavole Iguvine, sette lastre di bronzo con iscrizioni in lingua umbra risalenti al III-I secolo a.C.",
+      "shortDescription": "Imponente palazzo medievale del XIV secolo, simbolo della città e sede del Museo Civico.",
+      "lat": 43.35150,
+      "lng": 12.57740,
+      "radius": 100,
+      "audioFile": "assets/audio/palazzo-consoli.mp3",
+      "character": {
+        "name": "Angelo da Orvieto",
+        "role": "Architetto",
+        "greeting": "Benvenuto! Sono Angelo da Orvieto, l'architetto di questo magnifico palazzo. Lascia che ti racconti la sua storia..."
+      },
+      "decorations": ["medieval-banner", "stone-particles", "golden-glow"],
+      "epoch": "XIV secolo",
+      "category": "palazzo"
+    },
+    {
+      "id": "basilica-sant-ubaldo",
+      "name": "Basilica di Sant'Ubaldo",
+      "subtitle": "Il protettore di Gubbio",
+      "description": "La Basilica di Sant'Ubaldo si trova sulla cima del Monte Ingino, raggiungibile con una suggestiva funivia. Custodisce le spoglie del santo patrono di Gubbio, Sant'Ubaldo, e i tre Ceri, le grandi strutture di legno protagoniste della celebre Corsa dei Ceri che si tiene ogni 15 maggio. La chiesa attuale risale al XVI secolo.",
+      "shortDescription": "Basilica sul Monte Ingino che custodisce le spoglie del patrono e i famosi Ceri.",
+      "lat": 43.35570,
+      "lng": 12.58110,
+      "radius": 150,
+      "audioFile": "assets/audio/basilica-ubaldo.mp3",
+      "character": {
+        "name": "Sant'Ubaldo",
+        "role": "Patrono di Gubbio",
+        "greeting": "Pace a te, visitatore. Sono Ubaldo, vescovo e protettore di questa città. Ti svelerò i segreti di questo luogo sacro..."
+      },
+      "decorations": ["candlelight", "sacred-glow", "dove-particles"],
+      "epoch": "XVI secolo",
+      "category": "chiesa"
+    },
+    {
+      "id": "teatro-romano",
+      "name": "Teatro Romano",
+      "subtitle": "L'eredità di Roma",
+      "description": "Il Teatro Romano di Gubbio, costruito nel I secolo a.C., è uno dei teatri romani meglio conservati dell'Umbria. Con un diametro di circa 70 metri, poteva ospitare fino a 6.000 spettatori. Ancora oggi viene utilizzato per spettacoli estivi, mantenendo viva una tradizione che dura da oltre duemila anni.",
+      "shortDescription": "Antico teatro del I secolo a.C., ancora oggi utilizzato per spettacoli dal vivo.",
+      "lat": 43.34860,
+      "lng": 12.57970,
+      "radius": 120,
+      "audioFile": "assets/audio/teatro-romano.mp3",
+      "character": {
+        "name": "Centurione Marco",
+        "role": "Centurione Romano",
+        "greeting": "Ave! Sono il Centurione Marco. Questo teatro ha visto duemila anni di storia. Lascia che ti guidi..."
+      },
+      "decorations": ["roman-columns", "laurel-particles", "marble-glow"],
+      "epoch": "I secolo a.C.",
+      "category": "archeologico"
+    },
+    {
+      "id": "palazzo-ducale",
+      "name": "Palazzo Ducale",
+      "subtitle": "La corte dei Montefeltro",
+      "description": "Il Palazzo Ducale di Gubbio fu fatto costruire da Federico da Montefeltro nel 1470, ispirandosi al più celebre Palazzo Ducale di Urbino. Il cortile rinascimentale è un gioiello architettonico. Il palazzo ospita oggi un museo con arredi e opere d'arte che testimoniano lo splendore della corte dei Montefeltro.",
+      "shortDescription": "Elegante palazzo rinascimentale voluto da Federico da Montefeltro nel 1470.",
+      "lat": 43.35270,
+      "lng": 12.57820,
+      "radius": 80,
+      "audioFile": "assets/audio/palazzo-ducale.mp3",
+      "character": {
+        "name": "Federico da Montefeltro",
+        "role": "Duca di Urbino",
+        "greeting": "Benvenuto nella mia dimora eugubina! Sono Federico da Montefeltro. Scopri con me le meraviglie di questo palazzo..."
+      },
+      "decorations": ["renaissance-frame", "gold-particles", "noble-glow"],
+      "epoch": "XV secolo",
+      "category": "palazzo"
+    },
+    {
+      "id": "fontana-dei-matti",
+      "name": "Fontana dei Matti",
+      "subtitle": "La tradizione più pazza",
+      "description": "La Fontana del Bargello, nota come Fontana dei Matti, è una piccola fontana situata in Via dei Consoli. Secondo la tradizione, chi gira tre volte intorno alla fontana riceve la 'patente da matto', un documento goliardico rilasciato dal Comune. È uno dei simboli più amati e divertenti di Gubbio.",
+      "shortDescription": "La celebre fontana dove si ottiene la 'patente da matto' girando tre volte intorno.",
+      "lat": 43.35190,
+      "lng": 12.57710,
+      "radius": 60,
+      "audioFile": "assets/audio/fontana-matti.mp3",
+      "character": {
+        "name": "Il Matto di Gubbio",
+        "role": "Giullare",
+        "greeting": "Ahah! Benvenuto, amico! Sei pronto per diventare matto? Gira tre volte e la patente sarà tua!"
+      },
+      "decorations": ["water-splash", "confetti-particles", "rainbow-glow"],
+      "epoch": "XIV secolo",
+      "category": "fontana"
+    },
+    {
+      "id": "chiesa-san-francesco",
+      "name": "Chiesa di San Francesco",
+      "subtitle": "Il luogo del lupo",
+      "description": "La Chiesa di San Francesco sorge nel luogo dove, secondo la tradizione, San Francesco ammansì il lupo di Gubbio. Costruita nel XIII secolo in stile gotico, conserva affreschi di Ottaviano Nelli e altri pittori eugubini. La chiesa è un importante testimonianza del legame tra Gubbio e il santo di Assisi.",
+      "shortDescription": "Chiesa gotica del XIII secolo legata alla leggenda di San Francesco e il lupo.",
+      "lat": 43.34980,
+      "lng": 12.57580,
+      "radius": 90,
+      "audioFile": "assets/audio/chiesa-francesco.mp3",
+      "character": {
+        "name": "San Francesco",
+        "role": "Santo",
+        "greeting": "Pace e bene, fratello! Qui ammansii il lupo che terrorizzava Gubbio. Lascia che ti racconti questa storia..."
+      },
+      "decorations": ["wolf-shadow", "leaf-particles", "holy-glow"],
+      "epoch": "XIII secolo",
+      "category": "chiesa"
+    }
+  ],
+  "routes": [
+    {
+      "id": "percorso-medievale",
+      "name": "Gubbio Medievale",
+      "description": "Scopri i tesori del Medioevo eugubino",
+      "monuments": ["palazzo-dei-consoli", "fontana-dei-matti", "palazzo-ducale"],
+      "duration": "45 min",
+      "distance": "1.2 km"
+    },
+    {
+      "id": "percorso-completo",
+      "name": "Grand Tour di Gubbio",
+      "description": "Il percorso completo attraverso tutti i monumenti",
+      "monuments": ["teatro-romano", "chiesa-san-francesco", "fontana-dei-matti", "palazzo-dei-consoli", "palazzo-ducale", "basilica-sant-ubaldo"],
+      "duration": "2 ore",
+      "distance": "4.5 km"
+    },
+    {
+      "id": "percorso-spirituale",
+      "name": "Gubbio Sacra",
+      "description": "Un viaggio tra fede e storia",
+      "monuments": ["chiesa-san-francesco", "basilica-sant-ubaldo"],
+      "duration": "1.5 ore",
+      "distance": "3.2 km"
+    }
+  ]
+}