Vento, onda e marea da sorgenti open data, su un globo interattivo. Niente login, niente database, niente API key obbligatorie — gira out-of-the-box.
Coste reali, atmosfera Fresnel, pin con snapshot live e cicloni come spirali rotanti. Ruota il mondo e trova lo spot.
Forecast 72h da Open-Meteo, osservazioni real-time dalle boe NOAA, maree da Stormglass dove serve.
Per ogni ora: ON / MARGINAL / OFF e la misura di kite consigliata, calcolata sui dati reali dello spot.
Ogni sorgente passa per withResilience: timeout, fallback, 5 stati. Niente pagine bianche, niente loading infiniti.
Toggle persistito su cookie. In demo i dati sono mock deterministici — provala senza chiavi né rate limit.
UI e pagina sorgenti dati in italiano e inglese, cookie-based, senza ricaricare.
La shell renderizza subito; ogni sorgente ha la sua <Suspense> e appare appena pronta. Un provider lento non blocca gli altri — condizioni, stato del mare e forecast arrivano in parallelo.
La pagina /data-sources (bilingue) descrive ogni provider: cosa fornisce, come viene usato, env vars, licenza e gli spot che lo consumano. Il badge dice subito se è live, in demo o se serve una key.
È un progetto personale, ma le decisioni sono documentate. Ecco quelle che non si vedono dal README.
Ogni sorgente esterna implementa la stessa interfaccia e passa SEMPRE
per un wrapper unico: timeout via AbortController, errori
catturati, sempre uno di 5 stati. La UI si adatta allo stato — non al
caso.
I fetcher sono memoizzati per-request con cache(): più
<Suspense> boundary che chiedono lo stesso dato
pagano una sola fetch. Streaming per-sezione, dedupe gratis.
La mode vive su cookie (idratazione server-side, zero flash) con localStorage di fallback. Atterri in demo: forecast deterministico, nessuna fetch, nessuna chiave. Il toggle salva la preferenza.
Terra triangolata con earcut (gestione antimeridiano), coste reali da world-atlas, atmosfera Fresnel. Estetica "carta sketchy": filtro SVG turbulence, font hand-drawn, palette carta.
| Provider | Categoria | Key | Free tier |
|---|---|---|---|
| Open-Meteo | vento, onda, SST | no | illimitato |
| NOAA NDBC | osservazioni real-time (boe) | no | illimitato |
| NHC | cicloni tropicali attivi | no | illimitato |
| Wikipedia | summary enciclopedico | no | illimitato |
| Stormglass | maree | sì | 10 req/giorno |
L'app gira al 100% senza API key: i provider che ne richiedono una mostrano un badge "API key required" finché non la aggiungi. Stormglass si attiva solo sugli spot dove la marea vale il budget.
Clona il fork in locale: pnpm install e pnpm dev. Funziona subito, senza chiavi.
L'app usa streaming SSR, quindi serve un runtime Node. Vercel è il target raccomandato — un click col bottone qui sotto.
Vuoi le maree? Aggiungi STORMGLASS_API_KEY nelle env di Vercel e abilita il flag sugli spot che ti interessano.
Questo sito statico (website/) si pubblica da solo su GitHub Pages a ogni push — ospita la vetrina, non l'app.
Deploy with Vercel → Apri la demo live Ogni passo è documentato nel README della repo.