fractalsvelte mascot fractalsvelte fractalsvelte

Svelte 5 component · machines-ui · Graphs

GraphUptime

A calendar-like grid of daily uptime statuses with date bounds and an overall uptime percentage.

Install

GraphUptime is a Svelte 5 ASCII uptime chart component in @fractaldesign/machines-ui. It works in SvelteKit and in any Svelte 5 app.

pnpm add @fractaldesign/machines-ui

Import

import
import '@fractaldesign/machines-ui/style.css';
import { GraphUptime } from '@fractaldesign/machines-ui';

Usage

Example
<GraphUptime
  title="API"
  from="Jun 1"
  to="Aug 29"
  days={Array.from({ length: 90 }, (_, i) =>
    i === 41 || i === 42 ? 'down' : i === 18 || i === 60 ? 'degraded' : 'ok'
  )}
/>

Props

NameTypeDefault
title string Caption drawn on the top edge as `[ TITLE ]`. Uppercase, 1–2 words.—
days UptimeStatus[] Daily statuses in chronological order, using ok, degraded, down, or empty.—
from string Optional label for the beginning of the displayed date range.—
to string Optional label for the end of the displayed date range.—
columns number Number of day cells displayed on each row.30
glyphs Glyphs Characters that draw the graph: a preset name (`shade`, `ascii`, `hash`, `bar`) or your own array, lightest to heaviest.—
palette GraphPalette How many accent colours the graph uses: `mono` one, `duo` two, `multi` three.—
corner string Character drawn at each corner of the frame.—
class string ''