# A place on your website

*skydial · Components*

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.

Date (UTC)
Time (UTC)
Observer cityGreenwichSingaporeNew YorkParisTokyoSydney

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

| Setting | Default | Values |
|---|---|---|
| `kind` | earth | earth, moon, year or orrery |
| `size` | small | 176×176, 368×176 or 368×368; constrained by the container width. |
| `date / defaultDate` | live | Controlled or initially paused time. |
| `clock` | independent | Explicit SimClock for synchronization. |
| `planet` | jupiter | Year-hand planet, set through component settings. |
| `styles / classNames` | — | Customize every named widget part. |
| `dateFormat / timeFormat` | Intl options | Compact displays accept any Intl date/time format, or false to hide a reading. |
| `bodies` | earth, moon | Compact displays accept any planets and the Moon in display order. |
| `className / style` | — | Container customization. |

---
https://tbudin.github.io/skydial/widgets/ · skydial 0.4.1 · MIT
