Skip to content

bmlt-enabled/crumb-widget

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

373 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

1 star

Watchers

0 watching

Forks

Contributors