WhiskeyFYI Embed
Zero Dependencies · ~12KB · Shadow DOM

Embed Whiskey Expressions
on Any Website

Add WhiskeyFYI recipe cards, comparison tables, glossary terms, FAQs, guides, and interactive tools to any website with a single line of HTML. No build tools. No dependencies. Live data from the WhiskeyFYI database.

HTML
<!-- 1. Place the widget div -->
<div data-whiskeyfyi="recipe" data-slug="example-slug"></div>

<!-- 2. Add the script once -->
<script src="https://cdn.jsdelivr.net/npm/whiskeyfyi-embed@1/dist/embed.min.js"></script>

Recipe Card Preview

Whiskey Expressions Live Data
CategoryClassic
ABV28%
GlassCoupe
TechniqueShake & Strain

Quick Start

Two lines of HTML. That's all it takes.

HTML
<!-- Step 1: Place widget divs anywhere on your page -->
<div data-whiskeyfyi="recipe" data-slug="example" data-theme="light"></div>
<div data-whiskeyfyi="compare" data-slug-a="type-a" data-slug-b="type-b"></div>
<div data-whiskeyfyi="search" data-placeholder="Search Whiskey Expressions..."></div>

<!-- Step 2: Load the embed script once, anywhere -->
<script src="https://cdn.jsdelivr.net/npm/whiskeyfyi-embed@1/dist/embed.min.js"></script>
Shadow DOM Isolation
No CSS conflicts with your site.
Zero Dependencies
No jQuery, React. ~12KB gzipped.
Live Beverage Data
From WhiskeyFYI's curated database.

Widget Types × 2 Styles × 3 Themes

Select a widget type to preview. Every widget includes Shadow DOM isolation and a "Powered by WhiskeyFYI" backlink.

Modern

Widget preview loads from live API

Classic

Widget preview loads from live API

Widget Options

Configure widgets with data-* attributes.

Attribute Values Default Description
data-whiskeyfyirecipe, compare, glossary, faq, guide, ingredient, pairing, searchrequiredWidget type to render
data-slugany slugEntity slug from the WhiskeyFYI database
data-themelight, dark, sepia, autolightVisual theme (auto follows OS preference)
data-stylemodern, classicmodernWidget design style
data-sizedefault, compact, largedefaultWidget size
data-slug-aany slugFirst entity for compare widget
data-slug-bany slugSecond entity for compare widget
data-placeholderany stringSearch...Search box placeholder text

Styles & Themes

2 design styles × 3 themes. Mix and match to fit your site.

modern

System-ui font, card-based layout, rounded corners. Ideal for product pages and marketing sites. Default style.

data-style="modern"
classic

Serif-accented, structured layout, traditional spacing. Ideal for editorial content and reference sites.

data-style="classic"
Light + Dark

Set explicitly or use auto to follow the visitor's OS preference (prefers-color-scheme).

data-theme="auto"
Sepia

Warm paper-tone background. Perfect for beverage blogs, recipe sites, and editorial content.

data-theme="sepia"

CDN Options

Multiple delivery options to fit your workflow.

jsDelivr CDN

Global CDN, auto-updates with npm. Recommended for most use cases.

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

npm Package

For Webpack, Vite, Rollup bundlers.

Shell
npm install whiskeyfyi-embed

// In your JS/TS:
import 'whiskeyfyi-embed';

Pinned Version

Lock to a specific version for production stability.

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

Beverage FYI Family

Part of FYIPedia — open-source developer tools for world beverages: cocktails, wine, beer, whiskey, sake, tea, and coffee.

SiteDomainPackage
CocktailFYIcocktailfyi.comnpm
VinoFYIvinofyi.comnpm
BeerFYIbeerfyi.comnpm
BrewFYIbrewfyi.comnpm
WhiskeyFYIwhiskeyfyi.comnpm
TeaFYIteafyi.comnpm
NihonshuFYInihonshufyi.comnpm