mountainfyi-embed

Embed MountainFYI widgets — mountains, glossary terms, interactive tools, and inline elements — on any website. 6 widget types, zero dependencies, Shadow DOM style isolation, 4 built-in themes (light, dark, sepia, auto), 2 styles (modern, clean), and live data from the MountainFYI database.

Every widget includes a "Powered by MountainFYI" backlink directing readers to the full reference.

Try the interactive widget builder at widget.mountainfyi.com

Quick Start

<!-- Place widget div where you want it to appear -->
<div data-mountainfyi="entity" data-slug="mountains" data-theme="light"></div>

<!-- Load the embed script once, anywhere on the page -->
<script src="https://cdn.jsdelivr.net/npm/mountainfyi-embed@1/dist/embed.min.js"></script>

That's it. The widget fetches data from the MountainFYI API and renders with full style isolation.

Widget Types

| Type | Usage | Description | |------|-------|-------------| | entity | <div data-mountainfyi="entity" data-slug="..."></div> | Entity detail card — city, mountain, earthquake, or postal code | | glossary | <div data-mountainfyi="glossary" data-slug="..."></div> | Glossary term definition with cross-references | | faq | <div data-mountainfyi="faq" data-slug="..."></div> | FAQ accordion with expand/collapse | | search | <div data-mountainfyi="search" data-slug="..."></div> | Search box linking to the full database | | elevation-badge | <div data-mountainfyi="elevation-badge" data-slug="..."></div> | Inline elevation badge with altitude display | | difficulty-badge | <div data-mountainfyi="difficulty-badge" data-slug="..."></div> | Inline climbing difficulty grade badge |

Widget Options

| Attribute | Values | Default | Description | |-----------|--------|---------|-------------| | data-mountainfyi | entity, glossary, faq, search, [tools] | required | Widget type | | data-slug | e.g. "mountains" | — | Entity slug from the MountainFYI database | | data-theme | light, dark, sepia, auto | light | Visual theme (auto follows OS preference) | | data-style | modern, clean | modern | Widget design style | | data-size | default, compact, large | default | Widget size | | data-placeholder | any string | "Search Mountains..." | Search box placeholder |

Themes

<!-- Light (default) -->
<div data-mountainfyi="entity" data-slug="mountains" data-theme="light"></div>

<!-- Dark -->
<div data-mountainfyi="entity" data-slug="mountains" data-theme="dark"></div>

<!-- Sepia -->
<div data-mountainfyi="entity" data-slug="mountains" data-theme="sepia"></div>

<!-- Auto — follows OS dark/light preference -->
<div data-mountainfyi="entity" data-slug="mountains" data-theme="auto"></div>

Styles

<!-- Modern (default) — clean lines, rounded corners, accent gradients -->
<div data-mountainfyi="entity" data-slug="mountains" data-style="modern"></div>

<!-- Clean — minimal borders, utility-focused, data-first aesthetic -->
<div data-mountainfyi="entity" data-slug="mountains" data-style="clean"></div>

Web Components (Custom Elements)

As an alternative to data-* attributes, you can use native HTML custom elements:

<!-- Custom element form -->
<mountainfyi-entity slug="mountains" theme="light"></mountainfyi-entity>
<mountainfyi-search placeholder="Search Mountains..."></mountainfyi-search>

<script src="https://cdn.jsdelivr.net/npm/mountainfyi-embed@1/dist/embed.min.js"></script>

Use style-variant (not style) to avoid conflicts with the HTML reserved style attribute.

Examples

Entity Card

<div data-mountainfyi="entity" data-slug="mountains" data-theme="light"></div>
<script src="https://cdn.jsdelivr.net/npm/mountainfyi-embed@1/dist/embed.min.js"></script>

Search Box

<div data-mountainfyi="search" data-placeholder="Search Mountains..."></div>
<script src="https://cdn.jsdelivr.net/npm/mountainfyi-embed@1/dist/embed.min.js"></script>

Glossary Term

<div data-mountainfyi="glossary" data-slug="example-term" data-theme="light"></div>
<script src="https://cdn.jsdelivr.net/npm/mountainfyi-embed@1/dist/embed.min.js"></script>

CDN Options

jsDelivr (recommended — global CDN, auto-updates with npm)

<script src="https://cdn.jsdelivr.net/npm/mountainfyi-embed@1/dist/embed.min.js"></script>

Specific version (production stability)

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/embed.min.js"></script>

npm (for bundlers)

npm install mountainfyi-embed

import 'mountainfyi-embed';

Technical Details

• Shadow DOM: Complete style isolation — no CSS conflicts with your site
• Zero dependencies: No jQuery, React, or any external library
• 2 styles: Modern (accent gradients) and Clean (minimal, data-first)
• 4 themes: Light, Dark, Sepia, Auto (OS preference detection)
• CORS: MountainFYI API has CORS enabled for all origins
• MutationObserver: Works with dynamically added elements (SPAs)
• IntersectionObserver: Lazy loading — widgets only fetch when entering viewport (200px margin)
• Rich Snippets: DefinedTerm JSON-LD injected for glossary widgets
• Bundle size: Tree-shaken per site — only includes tools available on MountainFYI

Learn More About Mountains

Visit mountainfyi.com — MountainFYI is a comprehensive mountains reference with interactive tools, guides, and developer resources.

• API docs: mountainfyi.com/developers/
• Widget builder: widget.mountainfyi.com
• npm package: npmjs.com/package/mountainfyi-embed
• GitHub: github.com/fyipedia/mountainfyi-embed

Geo FYI Family

Part of FYIPedia — open-source developer tools ecosystem. Geo FYI covers distance, mountains, earthquakes, and postal codes. Hub: earthfyi.com.

| Site | Domain | Focus | Package | |------|--------|-------|---------| | DistanceFYI | distancefyi.com | 33,336 cities, Haversine distance, travel times | npm | | MountainFYI | mountainfyi.com | 2,000 mountains, elevation, difficulty grades | npm | | QuakeFYI | quakefyi.com | 20,702 earthquakes, magnitude scale, USGS alerts | npm | | ZipFYI | zipfyi.com | 41,488 postal codes, demographics, median income | npm |

FYIPedia Developer Tools

| Package | PyPI | npm | Description | |---------|------|-----|-------------| | colorfyi | PyPI | npm | Color conversion, WCAG contrast, harmonies — colorfyi.com | | emojifyi | PyPI | npm | Emoji encoding & metadata for 3,953 emojis — emojifyi.com | | unitfyi | PyPI | npm | Unit conversion, 220 units — unitfyi.com | | timefyi | PyPI | npm | Timezone ops & business hours — timefyi.com | | holidayfyi | PyPI | npm | Holiday dates & Easter calculation — holidayfyi.com | | namefyi | PyPI | npm | Korean romanization & Five Elements — namefyi.com | | distancefyi | PyPI | npm | Haversine distance & travel times — distancefyi.com | | fyipedia | PyPI | — | Unified CLI for all FYI tools — fyipedia.com |

License

MIT — see LICENSE.

Built with care by FYIPedia.