crumb-widget
v1.5.1
Published
<p align="center"> <img src="docs/crumb-logo.svg" alt="Crumb Widget logo" width="128" height="128"> </p>
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
- 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:
- 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
