skydialv0.4.1 A place on your website
  1. skydial
  2. Components
  3. A place on your website

A place on your website

Four small windows into the sky. Explore each widget below, try its three sizes, and copy the component into your website. Use the header to switch between textured 3D and duotone LCD, choose colours and change appearance. Every view responds to the moment you choose.

One moment. Every view.

Every example below shows the same moment. Change the date, time or city to explore.

Compact components

Small enough for everyday UI.

A date, a time, a year, or any combination. Choose the format and bodies in the settings; the component itself stays a clean, read-only display. The header switches both styles and colours.

01 / Earth clock

Earth clock

Local time, the date and daylight at your chosen city. The globe stays on that place while the real day–night boundary moves across it.

Loading the earth clock…

Component settings
Size
368 × 176 px

Choose a city in the preview toolbar. The time changes to that city’s local time; the shared moment stays the same.

EarthWidget · React, Vue, Svelte & vanilla

import { EarthWidget } from 'skydial/react'
import 'skydial/style.css'

<EarthWidget
  size="medium"
  variant="celestial"
  theme="dark"
  date={new Date('2026-03-26T12:00:00.000Z')}
  place={{"name":"Greenwich","latitude":51.4769,"longitude":0.0005,"timeZone":"Europe/London","source":"city"}}
/>
02 / Moon phase

Moon phase

The correct lunar phase and illumination for the observer, shown as a 3D sphere or a flat LCD diagram. The percentage tells you how much of its visible face is lit.

Loading the moon phase…

Component settings
Size
368 × 176 px

A new Moon is almost dark. Change the date to watch the crescent grow, rather than expecting the same bright image every day.

MoonWidget · React, Vue, Svelte & vanilla

import { MoonWidget } from 'skydial/react'
import 'skydial/style.css'

<MoonWidget
  size="medium"
  variant="celestial"
  theme="dark"
  date={new Date('2026-03-26T12:00:00.000Z')}
  place={{"name":"Greenwich","latitude":51.4769,"longitude":0.0005,"timeZone":"Europe/London","source":"city"}}
/>
03 / Planetary year

Planetary year

A rotating planet pairs the calendar year with its orbital period. Choose Jupiter, Saturn, Uranus or Neptune in the component settings.

Loading the planetary year…

Component settings
Size
368 × 176 px
Year hand planet

The large number is the Earth calendar year. The period below it is the number of Earth years that planet takes to travel once around the Sun.

YearWidget · React, Vue, Svelte & vanilla

import { YearWidget } from 'skydial/react'
import 'skydial/style.css'

<YearWidget
  size="medium"
  variant="celestial"
  theme="dark"
  date={new Date('2026-03-26T12:00:00.000Z')}
  planet="jupiter"
  place={{"name":"Greenwich","latitude":51.4769,"longitude":0.0005,"timeZone":"Europe/London","source":"city"}}
/>
04 / Solar system

Solar system

Eight planets, the Sun and their real orbital positions, composed in 3D or a flat LCD display. The green hand follows Earth; the gold hand follows your selected year planet.

Loading the solar system…

Component settings
Size
368 × 368 px
Year hand planet

Positions are calculated for the preview moment. Planet sizes and orbital distances are compressed for readability. Use the large card when the orbits are the focus.

OrreryWidget · React, Vue, Svelte & vanilla

import { OrreryWidget } from 'skydial/react'
import 'skydial/style.css'

<OrreryWidget
  size="large"
  variant="celestial"
  theme="dark"
  date={new Date('2026-03-26T12:00:00.000Z')}
  planet="jupiter"
  place={{"name":"Greenwich","latitude":51.4769,"longitude":0.0005,"timeZone":"Europe/London","source":"city"}}
/>

Three sizes. The same sky.

Small is a glance, medium adds context, large gives the scene room. Cards shrink to fit their container.

Small 176 × 176 px
Medium 368 × 176 px
Large 368 × 368 px

Convenience exports include EarthWidget, MoonWidget, YearWidget and OrreryWidget. Full telemetry panels remain available as EarthClock and MoonClock. Configure the year planet through props; cards contain no dropdown. CelestialDisplay, CelestialDateDisplay, CelestialTimeDisplay and CelestialBody provide smaller building blocks with configurable formats and bodies. Paused scenes redraw on changes; live scenes stop continuous drawing while offscreen.

Parameters

SettingDefaultValues
kindearthearth, moon, year or orrery
sizesmall176×176, 368×176 or 368×368; constrained by the container width.
date / defaultDateliveControlled or initially paused time.
clockindependentExplicit SimClock for synchronization.
planetjupiterYear-hand planet, set through component settings.
styles / classNames—Customize every named widget part.
dateFormat / timeFormatIntl optionsCompact displays accept any Intl date/time format, or false to hide a reading.
bodiesearth, moonCompact displays accept any planets and the Moon in display order.
className / style—Container customization.