MARKETPLACE

Browse and install extensions from the RoamJS marketplace directly from within 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 instead you prefer to manually install, first create a block with the text {{[[roam/js]]}} on any page in your Roam DB. Then, copy and paste this code block as a child of the block.

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

Usage

Open the Roam Command Palette by hitting CTRL+p on Windows or CMD+p on Mac. Search for Open Marketplace and hit enter.

A sidebar will appear, showing all the extensions that are currently available through RoamJS. You could install it directly into your graph from this sidebar, as well as manage all of your currently enabled extensions.

Syncing

When the extension is first installed in your graph, it will do its best to try to detect which extensions are currently installed in your graph, and then move them to the [[roam/js/marketplace]] page. Your previous installations will now be stored under a block that says "extensions". If there is a block moved there by mistake, simply move it back or delete it from there. If there is an extension that wasn't moved to that page that you expected to be moved, reach out to support@roamjs.com for assistance.

Auto Enable

By default, the marketplace extension simply adds the code blocks necessary to run the extension to your graph. It does not automatically enable it. To enable, simply click the "Yes, I know what I'm doing" button when it appears on your sidebar.

To automatically enable each extension upon installing, go to your [[roam/js/marketplace]] page and check on the auto enable flag in your install settings. Warning: it is in general risky to run code you can't read or trust in your graph because it has access to your data. If you don't trust RoamJS to audit the extensions made available in its marketplace, or if you don't trust RoamJS in general, you should not have this flag enabled.

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:

David Plummer
David Plummer
💵

ROAMJS DIGEST

Add your email below to stay up to date on all RoamJS features, fixes, and news!

Other Extensions

Coming Soon...