Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

locatime

locatime is the graphical time-and-place layer for ipt.startstar.ir.

It turns the visitor's current public-IP geolocation into a live visual composition containing:

  • local time and date
  • IANA time zone and UTC offset
  • approximate latitude/longitude
  • country, region and city
  • ASN / network organization
  • public IP
  • a global interactive map centered on the IP-derived location
  • animated location marker and atmospheric visual treatment

Architecture

The site is intentionally static and GitHub Pages compatible.

Browser
  │
  ├── https://ipapi.co/json/
  │      └── public IP → approximate location + time zone
  │
  ├── Intl.DateTimeFormat()
  │      └── live local clock from the returned IANA time zone
  │
  └── Leaflet + OpenStreetMap
         └── global map + location visualization

No application server is required.

Deployment

The repository contains:

  • CNAMEipt.startstar.ir
  • .github/workflows/pages.yml → GitHub Pages deployment
  • .nojekyll → static-site marker
  • index.html, styles.css, app.js → application

In GitHub, enable Settings → Pages → GitHub Actions as the Pages source.

For the custom hostname, create a DNS record for:

ipt.startstar.ir

pointing to GitHub Pages according to the Pages settings GitHub provides for the repository.

Data and privacy

The page uses IP-based geolocation. The resolved position is approximate and should never be presented as the visitor's exact physical location.

The browser directly requests https://ipapi.co/json/. The API documentation states that this endpoint can be used client-side and returns the public IP location, city/region/country, latitude/longitude, time zone, UTC offset, ASN and organization. See:

https://ipapi.co/api/

The map is rendered with Leaflet and OpenStreetMap tiles.

Design direction

locatime deliberately avoids a conventional dashboard. The location data is used as material for one large composition: typography, clock geometry, map layers, grid, pulse marker and network metadata.

The intended host is:

https://ipt.startstar.ir

About

A visual time & geolocation experience that transforms your IP-based location into a live graphical composition of time, place, coordinates, and the world map.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages