ALERT

Schedule alerts to appear while working in Roam

Installation

You could use the Copy Extension button below to individually install this extension. To install, just paste anywhere in your Roam graph and click "Yes, I Know What I'm Doing".

Manual Installation

If the extension doesn't work after using the copy extension button above, try installing manually using the instructions below.

First create a block with the text {{[[roam/js]]}} on any page in your Roam DB. Then, create a single child of this block type three back ticks. A code block should appear. Copy this code and paste it into the child code block in your graph:

var existing = document.getElementById("roamjs-alert");
if (!existing) {
  var extension = document.createElement("script");
  extension.src = "https://roamjs.com/alert.js";
  extension.id = "roamjs-alert";
  extension.async = true;
  extension.type = "text/javascript";
  document.getElementsByTagName("head")[0].appendChild(extension);
}

Finally, click "Yes, I Know What I'm Doing".


Usage

Type {{alert}} into a block. A popover will appear with "When" and "Message" fields. Enter when you want the alert to trigger in natural language like "In 5 minutes" or "In 2 hours" in the "When" field. Enter what message you want the alert to say in the "Message" field. A confirmation modal will appear, clearing the {{alert}} text upon confirmation. After the specified amount of time, an alert will appear in Roam with the message you specified!

Additionally, the popover has an "Allow Notification" checkbox. When checked, the alert will instead use a notification for the alert instead of the standard browser alert. You will need to enable browser notifications from Roam to use this.

The Alert used is Blueprint's Alert component. Additionally, there is a roamjs-window-alert class name on the component to allow for custom styling in your Roam themes.

At any time, you could hit the ALT+SHIFT+A keyboard shortcut to view the Alerts Dashboard. Here, you'll see a list of all of your live extensions. Clicking the trash icon will remove the alert.

Demo


Contributors

This extension is brought to you by RoamJS! If you are facing any issues reach out to support@roamjs.com or click on the chat button on the bottom right.

If you get value from using this extension, consider sponsoring RoamJS by clicking on the button below!

A special thanks to those who's contributions also helped make this extension possible:

Scott Kahan
Scott Kahan
💵

Other Extensions