crumb-widget
v1.6.3
Published
Embeddable NA meeting finder widget for BMLT root servers, with list and map views, filtering, geolocation, and i18n
Maintainers
Readme
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
- 14 built-in languages (English, Español, Português (Brasil), Français, Deutsch, Italiano, Svenska, Dansk, Polski, Ελληνικά, Русский, 日本語, Suomi, فارسی — 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 — or, with nothing configured, automatically uses the service body's update form from BMLT Server 4.2.9+ (docs) - Printer-friendly list view
Quick Start
What you'll need:
- 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. - (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?
- 🐛 Bug or feature request: open an issue on GitHub
- 📧 Email: [email protected]
- 💬 Community: the BMLT Facebook group
License
MIT
