RoamJS Extension Base

Stock base for RoamJS Roam Research extensions. Fork this repo to start a new extension.

What's included

• roamjs-components — shared utilities, DOM helpers, queries, writes, and UI components
• Samepage build — samepage build produces the Roam Depot–ready bundle
• Settings panel — example extensionAPI.settings.panel.create with an Enable switch
• TypeScript — tsconfig extending @samepage/scripts
• CI — GitHub Actions to build on push/PR (uses RoamJS secrets for publish)

After forking

1. Rename the repo and update package.json:

   • name: your extension slug (e.g. my-extension)
   • description: one line describing the extension

2. Implement in src/index.ts:

   • Keep or replace the settings panel
   • Add your logic using roamjs-components (e.g. createHTMLObserver, createBlock, renderToast)
   • Return { unload } to clean up on unload

3. Optional: Add React components under src/components/ (see autocomplete, giphy for examples).

4. Secrets (for publish) — in the forked repo, configure:

   • ROAMJS_RELEASE_TOKEN, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY
   • AWS_REGION, ROAMJS_PROXY (vars)

Scripts

• npm start — samepage dev (local development)
• npm run build:roam — build for Roam (dry run; CI runs npx samepage build)

License

MIT