Skip to content
Yuva

Status pages

Tell customers what is down before they have to ask.

A Yuva status page shows whether your product works. It sits in your support inbox, so your chat widget and apps show an open incident, and one reply answers everyone who wrote about it.

The public page

Yuva renders it as plain HTML, complete without JavaScript, and answers are cached for 30 seconds so a CDN in front of your server can carry an outage's traffic.

  • Overall stateThe worst state among the components you show, in words and in colour.
  • ComponentsIn groups, each with its state, a bar for every day of up to 90 days and, if you like, its uptime.
  • IncidentsFrom investigating to resolved, with every update kept. A published update is corrected, never removed.
  • MaintenanceAnnounce planned work with a window. Yuva starts and completes it on time.
  • HistoryPast incidents and maintenance by month, each with its own page.
  • Response timesWhen you turn it on: the last 24 hours of each component with an HTTP or TCP check, with median and p95.
  • Feed, badge and JSONAn Atom feed that needs no subscription, a badge for your README, and the same page as JSON for your own site or app.
  • Your look and languageYour logo and accent colour. The page speaks English, Turkish and German; visitors see times in their own time zone.

A page stays private until you publish it, and your team previews it in the panel before that.

Checks keep it current

A check sets a component's state without anyone's hand, and Yuva tells your team when it goes down or up.

  • HeartbeatsYour cron job or server calls a URL on a schedule. When the calls stop, the component goes down.
  • Pushed statesSend a working or an outage state yourself. Alertmanager and Grafana alerts are accepted as they are.
  • HTTPYuva requests a URL on an interval and checks the status code, optionally a keyword and the certificate's expiry.
  • TCPYuva opens a connection to a host and port and checks that it answers.
  • Incidents drafted for youWhen a check goes down, Yuva can open a draft incident for you to review, publish one at once, or open none. When it recovers, Yuva resolves what it opened.
  • Your word firstYou choose how many failures in a row count, and a state your team set by hand is never overridden by a check.

E-mail subscribers

Visitors subscribe to notices about incidents and maintenance, for every component or only the ones they use. A subscription always starts with a confirmation mail.

  • Double opt-inThe answer is the same for every address, and nobody is subscribed without confirming.
  • Their choiceOne checkbox per component, and a link in every mail to change it or leave.
  • Plain noticesThe state in words, the affected components and the updates, with no images, tracking or promotion. In English, Turkish or German.
  • Held, then sentA notice waits 60 seconds so you can undo it, and notices about one incident keep their distance, so a long outage does not flood inboxes.

Notices go out through your inbox's own e-mail channel, from its address, and the people on the list are kept apart from your newsletters.

In the chat widget and the apps

While your page is published and an incident or maintenance is open, the web widget and the iOS and Android SDKs show a line above the conversations, with the state in words and a link to the incident.

  • Nothing to set upThe line appears and goes away with the incident.
  • DismissableA customer can dismiss it. It returns when the incident gets a new update.
  • Their languageThe widget and the apps show it in each language they speak.

Reply to linked

An outage brings the same question by e-mail, chat and in the apps. Link those conversations to the incident, write one answer, and send it to all of them.

  • Link conversations to the incident in the panel. The incident page lists them.
  • Write one reply. Review shows how many conversations get it, and you can close each one afterwards.
  • Yuva sends it as you to every linked conversation that is still open, through each one's own channel. It cannot be recalled once sent.

Your own domain

Serve the page at an address such as status.example.com. Add a CNAME record and a TXT record that shows the domain is yours, and Yuva checks them for you.

  • CertificatesIssued and renewed automatically, by an on-demand proxy such as Caddy or by Cloudflare custom hostnames.
  • Everything movesLinks, the feed, the badge, the JSON and e-mail notices all use your domain.
  • Only yoursOnly the page is served on your domain, never the API or the panel.

The band for your own site

Show your status in your site's footer: the state in words, a strip of the last 90 days with uptime, and a link to your page. It is one script and one element.

<script src="https://support.example.com/yuva-status.js" defer></script>
<yuva-status page="acme" theme="auto" components></yuva-status>
  • pageThe address of your status page.
  • themelight, dark or auto, which follows the visitor's colour scheme. The default is auto.
  • componentsAdd it for a second row with each component's state.
On a light site
On a dark site

For developers

Everything is in the API, with the scopes status:read and status:manage. Webhooks announce component, incident and monitor changes, and assistants connected over MCP can open drafts and resolve incidents.

Open the API reference →

Start with the guide.

Make a page, add your components and publish it. The guide is in English, Turkish and German.