SMARTBLOCKS
Create custom and programmable templates 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 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-smartblocks-main");
if (!existing) {
var extension = document.createElement("script");
extension.src = "https://roamjs.com/smartblocks/main.js";
extension.id = "roamjs-smartblocks-main";
extension.async = true;
extension.type = "text/javascript";
document.getElementsByTagName("head")[0].appendChild(extension);
}Finally, click "Yes, I Know What I'm Doing".
Overview
SmartBlocks makes it easy to reuse text in a dynamic way in Roam. It can be compared to other snippet/template insertion tools like TextExpander and Alfred. However, SmartBlocks completely lives in your Roam graph and can smartly interact with your graph. All SmartBlocks workflows are defined in the graph and are performed in your graph. SmartBlocks are made of the following key components:
Workflows: These are the definitions of what the SmartBlock will do, it serves as a template for the SmartBlocks actions. These can be predefined or custom workflows.
Commands: Commands are instructions that make your SmartBlock workflow do amazing and dynamic things.
Trigger: The keystrokes you type so that the workflow is run. The default keystroke is
jj
Table of Contents
The following steps dive into all the features SmartBlocks has to offer in increasing complexity; from beginners to developer.
Demo
Migration
This extension was inspired by and acts as version 2 of the original smartblocks module in the Roam42 extension. It will soon replace the current smartblocks module in Roam42. For a list of all the non-backward compatible changes from V1 to V2, check out out Migration Guide.
Support
There is an active community at roamresearch.slack.com channels #roam42 and #roamjs discussing and building SmartBlocks. Stop by if you need help or want to share your ideas.
Next Up: Trigger Your Workflow
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:
Jorge Mir Alvarez
💵Rahul Matthan
💵
Montgomery Kosma
💵David W Plummer
💵
Duane D Rudy
💵
Terese Brewster
💵Mattheus Peereboom
💵Edwin Rooijakkers
💵Joey Harris
💵Eric Peterson
💵
Vincent Tam
💵Kenneth Bram
💵Alan Ogle
💵Paul Hacker
💵John Trainor
💵Steve Greene
💵
Alex Young
💵Kaushal Kashyap
💵Christopher Reath
💵
Brian Barry
💵Michael Ibara
💵Roy Temple
💵Michael Marino
💵Fadhilah Wahid
💵
Michael F. Byrne
💵
Nate Stell
💵Michael J D Ede
💵Ravi Mandliya
💵Joseph Goodson
💵Kara Monroe
💵Michael Brockbals
💵Margaret K Delano
💵Jacques Gautreau
💵
David R Schulman
💵Mike Judd
💵Jessica DeVita
💵Andreas Von Gunten
💵Solomon Weiler
💵Jessica Shieh
💵Ray Nestor
💵
Mark Bulling
💵William R Petro
💵MAGNUS HELGERUD SØRBY
💵Behrooz Bashokooh
💵Jacques Tardie
💵Jon Surrat
💵Matthew J Brockwell
💵JC Cangilla
💵Peter Rosso
💵Christoph Weniger
💵Benjamin D.
💵ANDREW C MACOMBER
💵Habib Sayah
💵Vaibhav Chadha
💵
Sabi Sika Boni Guessou
💵
TH.J.M. Koster
💵Tony Lembke
💵Christopher Boyer
💵Gallet
💵Michael Norrie
💵Adam Naudascher
💵Jack Montoya Jr.
💵Karaminder Ghuman
💵Dr S Hill
💵
Scott Ian Taylor
💵
TALI LERNER
💵Giovanni Faga
💵g.a. Epping
💵
Milan Stanojevic
💵RB Mulholland
💵David Wilson
💵Asaf Dafna
💵Billy Linder
💵S Venkatesan
💵Russell Pasetes
💵Cherry Sun
💵David Weiss
💵Larry Bernstein
💵Mridula Duggal
💵TSUKASA GOZAOKA
💵LE NGOC QUOC HUY
💵Sangmin Ahn
💵Merril Pious Jacob
💵Arlen Hooley
💵W M Tappin
💵Daniel helou rahal
💵Ashwin Siddarth
💵Joseph A Moody
💵Tsao Jian-hsiung
💵Nigel Rawlins
💵Scott Fry
💵Akhilender Singh
💵YU KUWANO
💵Matthew Mckinlay
💵Aleksey Tentler
💵SANTOSH ANGADI
💵Andre Foeken
💵John Gulledge
💵Jordan Burton
💵TsunKuo Kuo
💵Ami Pedahzur
💵ROAMJS DIGEST
Add your email below to stay up to date on all RoamJS features, fixes, and news!