Skip to content
negus1069Public

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🪁 Kite Forecast

Web app that shows a Windfinder-style marine & wind forecast table for any location, with direct access to the raw data from open APIs (no scraping).

Live demo: https://negus1069.github.io/cokite/

Data sources (all free, no API key)

  • Weather (wind, gusts, temperature, pressure, cloud cover, precipitation, WMO code): Open-Meteo Forecast API
  • Marine (wave height/direction/period, sea level): Open-Meteo Marine API
  • Geocoding (city search): Open-Meteo Geocoding API
  • Tides & coefficient: derived client-side from sea_level_height_msl (local extrema + daily-range approximation calibrated against each spot's mean spring-tide range).
  • Live wind stations:

The bottom of the page always exposes the raw JSON payload from each API for transparency.

Local development

npm install
npm run dev
# open http://localhost:5173

Local dev uses Vite reverse proxies (/weameter/*, /mlr/*) to bypass CORS on the live-station endpoints.

Build

npm run build
npm run preview

Deployment (GitHub Pages)

Any push to main triggers .github/workflows/deploy.yml, which builds the app and publishes dist/ to GitHub Pages.

First-time setup on the repo:

  1. Go to Settings → Pages → Build and deployment
  2. Set Source = GitHub Actions

The site will be served at https://negus1069.github.io/cokite/.

In production the live-station endpoints go through a chain of public CORS proxies (corsproxy.io, api.allorigins.win, api.codetabs.com) — first success wins.

Adding a spot

Edit src/data/spots.ts — add an entry with slug, name, lat, lon, and springRange (mean spring-tide range in meters for the reference port). Optional liveWind field connects a station feed (type: 'weameter' or type: 'clientraw').

Roadmap

  • GitHub Pages deployment
  • Live weather-station badges (5 s polling)
  • Trailing 1-hour average wind
  • Shareable URLs via HashRouter
  • Unit toggles (kts ↔ km/h, m ↔ ft)
  • SHOM-accurate French tidal coefficients (daily cron via GitHub Actions)
  • Kite-friendliness score (green/orange/red) with per-user wind range

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages