A BeNomad Tiles map paints a tiny bundled fallback instantly, then swaps in the live cartographic charte published on the worker, so the map you author in BeMaputnik reaches every application without a single redeploy.
The bundled style is not the source of truth.bemap.fallbackStyle exists only to fill the canvas during the first few hundred milliseconds and to survive an offline start. The real style is fetched from the worker after login (/api/default-style → /styles/<name>). Change the charte server-side and every app picks it up on its next load, no library rebuild, no client release.
## At a glance
Four shapes of the style option: omitted / 'default', a bare name, a full URL, an inline object.
All four flow through bemap.TilesStyle.fetch() → resolvePlaceholders() → hardenSymbolCollisions() before MapLibre sees them.
bemap.fallbackStyle: "BeMap Fallback (charte 2026, no fonts)": fill/line only, no symbol layers, no glyphs, so it never requests a font.
Two placeholders: TILES_SOURCE (rewritten to pmtiles://<tilesHost>/<tilesFile>) and __BILINGUAL_PLACE__ (a MapLibre format expression).
Localized names are name_fr / name_en: underscore, not the name:fr OpenMapTiles convention.
The library ships no fonts. A root-relative glyphs is absolutised against the tiles host; override with ctx.glyphsUrl.
setStyle() is overlay-preserving: bemap.TilesOverlayCatalog replays your shapes, including on the 401 → refresh → reload path.
Styles are authored in BeMaputnik, the BeNomad style editor at https://bemaputnik.benomad.net.
## Usage
The default path: pin nothing, and the map tracks whatever the worker publishes:
```js
var ctx = new bemap.Context({
login: 'YOUR_LOGIN',
password: 'YOUR_PASSWORD',
secure: true,
host: 'bemap.benomad.com',
tilesHost: 'mptiles-api.benomad.net'
});
// No `style` option → tiny fallback now, live server charte right after login.
var map = new bemap.MapLibreMap(ctx, 'map').move(2.35, 48.85, 12);
// Style-load failures are reported in the browser console - 2.0.2 has no
// public error subscription. See "Map errors" on the Events page.
```
List what the worker allows for your account, then swap at runtime:
```js
map.fetchAvailableStyles().then(function (cfg) {
// cfg.styles → ['openfreemap_graylevel', 'charte_2026', …]
// cfg.defaultStyle → the name applied when you pin none
cfg.styles.forEach(function (name) { console.log(name, name === cfg.defaultStyle); });
});
map.setStyle('openfreemap_graylevel'); // bare name → /styles/openfreemap_graylevel
```
Pin a style explicitly when you do *not* want the server default: a name, a URL on your tiles host, or an inline object:
```js
new bemap.MapLibreMap(ctx, 'map', { style: 'openfreemap_graylevel' });
new bemap.MapLibreMap(ctx, 'map', { style: 'https://mptiles-api.benomad.net/styles/charte_2026.json' });
new bemap.MapLibreMap(ctx, 'map', {
style: {
version: 8,
metadata: { source_placeholder: 'TILES_SOURCE' },
sources: { 'TILES_SOURCE': { type: 'vector', url: '' } },
layers: [ { id: 'bg', type: 'background', paint: { 'background-color': '#f4f1ea' } } ]
}
});
```
Point the font server somewhere other than the tiles host: this overrides every style's `glyphs`:
```js
var ctx = new bemap.Context({
tilesHost: 'mptiles-api.benomad.net',
glyphsUrl: 'https://my-host.example.com/fonts/{fontstack}/{range}.pbf'
});
```
## Reference
### Style resolution precedence
| `style` option | Resolution |
| --- | --- |
| *omitted* or `'default'` | `bemap.fallbackStyle` paints **immediately** (no network, no fonts), then (once login completes) `GET /api/default-style` names the live style and `GET /styles/` loads it through an overlay-preserving `setStyle()`. A failure is swallowed: the fallback simply stays, never a blank canvas. |
| `''` | Fallback first, then `/styles/`. A value already carrying a path (`'styles/foo.json'`, as returned by `/api/styles`) resolves against the host root instead of being re-nested. |
| `''` | Fetched as-is. Auth is injected only when the URL contains `ctx.tilesHost`: session cookie by default, `X-Session-Token` header or `?token=` per `tilesAuth`. Other origins get a plain `fetch`, so nothing leaks cross-origin. |
| `{ …json… }` | Deep-cloned and used as-is. Placeholders are still resolved, so an inline style can carry `TILES_SOURCE`. |
### Map methods
| Member | Returns | Behaviour |
| --- | --- | --- |
| `fetchAvailableStyles()` | `Promise