# kundinga — sito ed editor per Cloudflare

Versione del 17 ottobre 2026. Il pacchetto contiene `sito/` (tutti i file da pubblicare) e questo README. Non richiede installazioni, compilazione o abbonamenti a un CMS. Conserva la cartella completa sul computer come copia principale.

## Prima pubblicazione

1. Estrai `kundinga-cloudflare.zip` con un doppio clic.
2. Accedi al tuo account su https://dash.cloudflare.com e apri **Workers & Pages**.
3. Seleziona **Create application → Get started → Drag and drop your files**, nel percorso dedicato a **Pages**.
4. Come nome del progetto usa `kundinga` (oppure un nome disponibile). Carica la cartella **sito**, quella contenente direttamente `index.html`, `content.json` e `assets`. Non caricare la cartella esterna con il README.
5. Seleziona **Deploy site** / **Save and Deploy**, secondo la schermata, e apri l’indirizzo `*.pages.dev` restituito.
6. Verifica apertura, Ascolta, calendario, mappa ed **Editor del sito** in fondo alla pagina.

Procedura verificata sulla [documentazione Cloudflare Direct Upload](https://developers.cloudflare.com/pages/get-started/direct-upload/). Questo pacchetto è statico e non richiede un comando di build. Il progetto Direct Upload si aggiorna manualmente; per passare alla pubblicazione automatica da Git occorre creare un altro progetto.

## Collegare kundinga.xyz mantenendo le email

1. Nel progetto Pages apri **Custom domains → Set up a domain**.
2. Inserisci `kundinga.xyz`, premi **Continue** e segui la configurazione DNS proposta per il sito. Il dominio è già gestito da Cloudflare.
3. Attendi lo stato attivo e verifica `https://kundinga.xyz`.
4. Se desideri anche `www.kundinga.xyz`, aggiungilo nello stesso pannello come secondo dominio.

Non eliminare né sostituire i record **MX**, i record **TXT** di SPF/DKIM/DMARC o la configurazione Email Routing esistente: riguardano la posta. Se esiste già un record web A/AAAA/CNAME in conflitto, verifica solo quel record prima di cambiarlo. Il pacchetto non modifica il DNS automaticamente.

Riferimento: [domini personalizzati Cloudflare Pages](https://developers.cloudflare.com/pages/configuration/custom-domains/).

## Trovare e usare l’editor

1. Apri il sito e scorri in fondo: premi **Editor del sito ↗**. Puoi salvare tra i preferiti `https://kundinga.xyz/edit.html` dopo il collegamento del dominio; prima usa lo stesso percorso sull’indirizzo `pages.dev`.
2. Scegli **Profilo & apertura** per bio, foto/video di apertura e testi dei contatti; **Ascolta · player** per Spotify, Bandcamp e YouTube; **Link & collaborazioni** per social e progetti; **Concerti** per calendario; **Mappa dei live** per luoghi e racconti.
3. Modifica i campi. I pulsanti **↑ Sposta su**, **↓ Sposta giù**, **Rimuovi** e **+ Aggiungi…** gestiscono gli elementi.
4. Premi **Salva bozza**, poi **Anteprima ↗**. Controlla le modifiche nella pagina con il banner di anteprima.
5. Premi **Esporta contenuti ↓**: scaricherai `content.json`.
6. Nel Finder sostituisci `sito/content.json` con il file scaricato, mantenendo esattamente quel nome (senza suffissi come “(1)”). Conserva una copia della versione precedente.
7. In Cloudflare, apri il progetto Pages e **Create a new deployment**, scegli **Production**, carica tutta la cartella `sito` aggiornata, poi **Save and Deploy**.
8. Apri il sito normale, senza `?preview=draft`, e verifica il cambiamento.

La bozza è locale al browser e all’indirizzo usato: localhost, pages.dev e kundinga.xyz hanno bozze separate. **Riprendi bozza** recupera quella locale; **Importa content.json** recupera un file salvato. Il sito pubblico non cambia con “Salva bozza”. Non c’è un CMS remoto: l’editor è accessibile anche ai visitatori, ma non permette loro di pubblicare sul tuo account. Non inserire segreti nei contenuti.

## Player e foto

- **Spotify:** incolla un link pubblico. “moody” è già attiva; la prima playlist fornita risulta non disponibile ed è conservata con **Mostra sul sito** disattivato. Il player può offrire anteprime in base alle limitazioni di Spotify.
- **YouTube:** puoi aggiungere video, Shorts, live e playlist nella sezione Ascolta; un canale può essere aggiunto come semplice link in Link & collaborazioni. Premi **Verifica player** e controlla la riproduzione: alcuni video non consentono l’incorporamento.
- **Bandcamp:** nella pagina del brano/album usa **Share/Embed → embed this album**, copia il codice nel campo Player dell’editor. Il solo link alla pagina non basta. [Istruzioni Bandcamp](https://get.bandcamp.help/en/articles/15263071-how-do-i-create-a-bandcamp-embedded-player).
- **Foto:** aggiungi il file nella cartella `sito/assets`, poi usa `assets/nome-foto.jpg` nel campo URL. In anteprima online il nuovo file sarà disponibile dopo il caricamento su Cloudflare. Puoi anche usare un URL HTTPS già accessibile.

## Cosa contiene questa versione

Testi della nuova bio, grafica calda, player modificabili, cinque concerti P.H.A.T., sei luoghi nella mappa satellitare. Le date sono impostate a ottobre/novembre 2026 e gennaio 2027, ruolo Basso: verifica nell’editor prima della pubblicazione. Alcune coordinate sono indicative e dichiarate come tali.

Il form contatti **prepara un’email** per [email protected] nell’app di posta del visitatore; non invia dal server. Foto/video personali di apertura e contenuti Bandcamp/YouTube restano da scegliere. Font, player e mappa richiedono Internet. La mappa usa il servizio pubblico Esri World Imagery con attribuzioni: la disponibilità e le condizioni dipendono dal fornitore; un eventuale passaggio a un servizio con chiave richiederà configurazione.

Per modifiche grafiche: `style.css`. Struttura: `index.html`. Tutti i contenuti ordinari: editor e `content.json`. Non aprire `index.html` con doppio clic per testare il sito: il caricamento dei dati richiede un server web; usa l’indirizzo Pages dopo il caricamento.