Skip to content

bmlt-enabled/crumb-widget

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

367 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Crumb Widget logo

Crumb Widget

test codecov npm docs

🌐 English | Español | Português (Brasil) | Français | Deutsch | Italiano | Svenska | Dansk | Polski | Ελληνικά | Русский | 日本語 | فارسی

👉 Live demo: crumb.bmlt.app/meetings.html

Crumb Widget — list, map, and meeting detail views

An embeddable NA meeting finder widget. Built with Svelte 5, distributed as a single self-contained JavaScript file. Available as a WordPress plugin, Drupal module, Joomla extension, CDN script, or npm package.

Which version should I use?

Your site Use this
WordPress WordPress plugin
Drupal 10.3+ or 11 Drupal module
Joomla 4, 5, or 6 Joomla extension
Wix, Squarespace, Google Sites, or plain HTML Paste the CDN snippet into a code block
A JS/TS app (React, Svelte, Vue, Vite, etc.) npm install crumb-widget (docs)

Features

  • List and map views with real-time search and filters
  • Meeting detail with directions, virtual join link, and formats
  • Geolocation-based nearby search, plus typed location search by city, postal code, or address
  • Individual meeting links via built-in router
  • 13 built-in languages (English, Español, Português (Brasil), Français, Deutsch, Italiano, Svenska, Dansk, Polski, Ελληνικά, Русский, 日本語, فارسی — including RTL layout for Persian)
  • Configurable columns, map tiles, and custom markers
  • Optional "Update Meeting Info" link on each meeting detail — point at a bmlt-workflow form, any custom form, or a mailto: URL (docs)
  • Printer-friendly list view

Quick Start

What you'll need:

  1. Your BMLT server URL — usually something like https://bmlt.example.org/main_server/. Ask your service body's webservant if you don't have it.
  2. (Optional) A service body ID to filter to a specific area or region. How to find it →

Minimum viable embed (paste into any HTML page, Squarespace code block, Wix HTML embed, etc.):

<div id="crumb-widget" data-server="https://myserver.com/main_server/"></div>
<script type="module" src="https://cdn.aws.bmlt.app/crumb-widget.js"></script>

Filter to a single service body:

<div id="crumb-widget"
    data-server="https://myserver.com/main_server/"
    data-service-body="3"
></div>
<script type="module" src="https://cdn.aws.bmlt.app/crumb-widget.js"></script>

Documentation

Check out the full Crumb documentation — including configuration options, examples, and a getting started guide at crumb.bmlt.app.

Need help?

License

MIT

About

An embeddable NA meeting finder widget for any platform

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors