citycode

L'app civica di Vigevano.city, libera per qualsiasi città.

English: citycode is the open-source template behind Vigevano.city, a civic PWA for an Italian town of 60,000 people: waste calendar, citizen reports with public map, events, on-duty pharmacies, live traffic, trains, tourist guide and more — built by one person in conversation with AI, and released here so any city can adapt it. Docs are in Italian (the target is Italian municipalities), but the code speaks for itself.

Cos'è

Vigevano.city è un'app web (PWA installabile) per i cittadini di Vigevano: calendario rifiuti personalizzato per via, segnalazioni con bacheca pubblica, eventi, farmacie di turno, traffico in tempo reale, treni, guida turistica, numeri utili e altro. Gratuita, senza pubblicità, senza tracciamento.

L'ha costruita una persona sola, senza un team di sviluppo, lavorando in dialogo con l'AI (Claude). Questa repo è il suo codice, ripulito e reso adattabile: se l'ho fatto io per la mia città, puoi farlo tu per la tua.

• 🔗 Implementazione reale di riferimento: www.vigevano.city/app
• 📦 In questa repo i dati di Vigevano sono sostituiti da una città fittizia, Esempiopoli: tutto compila e gira, ma ogni file di dati è marcato DATI D'ESEMPIO e va riempito con i dati della tua città.

Così appare l'app appena clonata, con i dati d'esempio di Esempiopoli:

Home	Guida turistica

Cosa c'è dentro

Area	Sezioni
Servizi quotidiani	🗑️ Rifiuti (calendario per zona + "dove lo butto?" + promemoria push) · 💊 Farmacie di turno · ☎️ Numeri utili · 🌦️ Meteo
Partecipazione	📍 Segnalazioni con moderazione via bot Telegram e bacheca pubblica · 🐾 Animali (adozioni/smarriti) · 💬 Feedback
Mobilità	🚦 Traffico in tempo reale (TomTom) con notifiche per fascia oraria · 🚆 Treni · 🚌 Autobus · 🔌 Colonnine EV · ⛽ Prezzi carburanti
Vivere la città	🎉 Eventi (proposte cittadine + aggregazione automatica) · 📰 News (aggregatore multi-fonte con dedup) · 🍽️ Ristoranti · 🎬 Cinema · 🏀 Sport · 🤝 Comunità
Cultura	🏛️ Guida turistica con POI e audioguida · 📜 Storia · 📚 Rassegne
Infrastruttura	👤 Account (Google), notifiche push, 8 lingue (IT/EN + AR/ZH/ES/RO/SQ/UK, RTL incluso), dark mode, offline, ricerca globale

Stack

• Frontend: React + Vite, PWA (service worker, installabile), TypeScript. Nessun framework CSS: tema custom.
• Backend: Supabase — Postgres + RLS, Edge Functions (Deno), Storage, Auth (Google), cron pg_cron.
• Moderazione: bot Telegram — ogni contenuto proposto dai cittadini passa da un umano prima di essere pubblico.
• Deploy: GitHub Actions → build → FTP su hosting qualsiasi. Il piano gratuito di Supabase basta per una città di 60.000 abitanti.
• Costi vivi di Vigevano.city: dominio + hosting (~50 €/anno). Tutte le API usate hanno un piano gratuito sufficiente.

Quick start

npm install
cp .env.example .env.local   # e compila URL + anon key del tuo progetto Supabase
npm run dev

Per il backend: crea un progetto Supabase, esegui supabase/schema.sql

• supabase/storage.sql (oppure le migration in ordine), deploya le Edge Functions che ti servono e schedula i cron di supabase/cron/. Guida completa in docs/SETUP.md.

Adattare alla tua città

La guida è docs/ADATTARE.md. In sintesi, le sezioni sono divise in tre livelli:

• Tier 1 — funzionano subito: meccanismi generici (segnalazioni, animali, sport, comunità) o API mondiali/nazionali (TomTom, Open-Meteo, Open Charge Map, MIMIT, Google Places). Servono solo le tue chiavi e le tue coordinate.
• Tier 2 — stessa UI, fonte da sostituire: rifiuti (il calendario del tuo gestore), farmacie (il sistema della tua provincia), autobus, news/eventi (i feed RSS locali), guida turistica (il contenuto editoriale è il vero lavoro umano del fork).
• Tier 3 — solo Lombardia: le integrazioni con l'ecosistema regionale E015 (allerte di protezione civile, treni Trenord, qualità dell'aria). Fuori Lombardia si rimuovono o si sostituiscono.

I punti da personalizzare sono marcati nel codice con PERSONALIZZA e DATI D'ESEMPIO.

Cosa NON c'è (di proposito)

• Nessun dato reale di Vigevano: contatti, orari, POI e testi editoriali sono sostituiti da esempi fittizi. I dati della tua città li conosci tu.
• Nessun logo o asset di terzi (Trenord, E015, Regione Lombardia…): le convenzioni d'uso vanno chieste da ogni città per sé.
• Nessuna chiave o segreto: tutti i servizi esterni si configurano via secret (elenco completo in docs/SETUP.md).

Filosofia

1. Moderazione umana: l'AI aiuta a costruire, ma ogni contenuto pubblico passa da una persona.
2. Niente pubblicità, niente profilazione: un servizio civico, non un prodotto.
3. Fonti dichiarate: ogni sezione dice da dove vengono i dati.
4. Costi ridicoli: tutto è progettato per stare nei piani gratuiti.

Licenza e crediti

Codice sotto licenza MIT. Creato da Matteo Ornati per Vigevano; se lo adatti alla tua città, un link a questa repo fa piacere (e fammi sapere: la lista delle città che lo usano vive qui sotto).

Città che usano citycode: Vigevano (l'originale) — la tua?