An open API service indexing awesome lists of open source software.

https://github.com/cletqui/tide

Dive into Tide Clock: Catch the Wave of French Harbor Tides! ๐ŸŒŠ๐Ÿ•ฐ๏ธ
https://github.com/cletqui/tide

analog-clock clock cloudflare cloudflare-pages github-pages tide

Last synced: 26 days ago
JSON representation

Dive into Tide Clock: Catch the Wave of French Harbor Tides! ๐ŸŒŠ๐Ÿ•ฐ๏ธ

Awesome Lists containing this project

README

          

# Tide Clock

A minimalist tide clock for French harbours. The clock hand shows where you are in the current tidal cycle โ€” no numbers needed.

[![pages-build-deployment](https://github.com/cletqui/tide/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/cletqui/tide/actions/workflows/pages/pages-build-deployment)

**Live:** [cletqui.github.io/tide](https://cletqui.github.io/tide) ยท [tide.pages.dev](https://tide.pages.dev)

## How it works

The hand rotates between high tide (12 o'clock) and low tide (6 o'clock), showing elapsed time within the current tidal cycle. The info panel (toggle with โ„น๏ธ) reveals exact times and tidal coefficient.

Tide data is fetched from [data.cybai.re](https://github.com/cletqui/data) โ€” a personal Cloudflare Worker that scrapes [maree.info](https://maree.info) and caches results for 12 hours.

## Features

- Analog clock hand representing the tidal cycle
- Search any French harbour by name
- Dropdown suggestions for ambiguous searches
- PM / BM tide times and tidal coefficient (morte-eau โ†’ vive-eau exceptionnelle)
- Dark / light theme (persisted across sessions)
- Fullscreen mode
- Responsive layout

## Project structure

```
tide/
โ”œโ”€โ”€ css/style.css
โ”œโ”€โ”€ icons/
โ”œโ”€โ”€ js/script.js
โ””โ”€โ”€ index.html
```

## API

Tide data comes from `GET https://data.cybai.re/tide?id={harbourId}`.

Response includes `last_tide`, `next_tide`, `forecast` (full week), `coeff_label`, and a `cached` flag.

## License

MIT โ€” see [LICENSE](LICENSE).