BrewFYI Embed
Zero Dependencies · ~12KB · Shadow DOM

Embed Coffee Varieties
on Any Website

Add BrewFYI 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 BrewFYI database.

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

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

Recipe Card Preview

Coffee Varieties 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-brewfyi="recipe" data-slug="example" data-theme="light"></div>
<div data-brewfyi="compare" data-slug-a="type-a" data-slug-b="type-b"></div>
<div data-brewfyi="search" data-placeholder="Search Coffee Varieties..."></div>

<!-- Step 2: Load the embed script once, anywhere -->
<script src="https://cdn.jsdelivr.net/npm/brewfyi-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 BrewFYI'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 BrewFYI" 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-brewfyirecipe, compare, glossary, faq, guide, ingredient, pairing, searchrequiredWidget type to render
data-slugany slugEntity slug from the BrewFYI 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/brewfyi-embed@1/dist/embed.min.js"></script>

npm Package

For Webpack, Vite, Rollup bundlers.

Shell
npm install brewfyi-embed

// In your JS/TS:
import 'brewfyi-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