widetorah-embed

Embed WideTorah scripture widgets on any website. Zero dependencies, Shadow DOM style isolation, 3 built-in themes (light, dark, sepia), and automatic daily verse updates. Each widget includes a "Powered by WideTorah" backlink.

Try the interactive widget builder at widget.widetorah.com

Quick Start

<!-- Place widget div where you want it to appear -->
<div data-widetorah="verse" data-ref="Genesis 1:1" data-theme="light"></div>

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

That's it. The widget will load, fetch the verse from the WideTorah API, and render it with full style isolation.

Widget Types

Type	Usage
Verse Card	<div data-widetorah="verse" data-ref="..." data-theme="light"></div>
Chapter Card	<div data-widetorah="chapter" data-ref="..."></div>
Comparison Card	<div data-widetorah="compare" data-a="..." data-b="..."></div>
Verse of the Day	<div data-widetorah="votd" data-theme="light"></div>
Search Box	<div data-widetorah="search" data-placeholder="..."></div>

Widget Options

Attribute	Values	Default	Description
data-widetorah	verse, chapter, person, compare, votd, search	required	Widget type
data-ref	"2:255"	—	Verse/chapter reference
data-slug	"moses", "paul"	—	Person slug (person widget only)
data-a	verse ref	—	First verse for comparison
data-b	verse ref	—	Second verse for comparison
data-theme	light, dark, sepia	light	Visual theme
data-size	default, compact	default	Widget size
data-translation	jps, etc.	jps	Translation code
data-show-original	true, false	false	Show original language text
data-placeholder	any string	"Search Torah…"	Search box placeholder

Themes

<!-- Light (default) -->
<div data-widetorah="votd" data-theme="light"></div>

<!-- Dark -->
<div data-widetorah="votd" data-theme="dark"></div>

<!-- Sepia (warm, book-like) -->
<div data-widetorah="votd" data-theme="sepia"></div>

CDN Options

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

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

R2 CDN (widetorah.com hosted)

<script src="https://cdn.widetorah.com/embed.min.js"></script>

npm (for bundlers)

npm install widetorah-embed

import 'widetorah-embed';

Examples

Verse of the Day

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

Verse with Original Language

<div data-widetorah="verse"
  data-ref="1:1"
  data-show-original="true"
  data-theme="sepia">
</div>
<script src="https://cdn.jsdelivr.net/npm/widetorah-embed@1/dist/embed.min.js"></script>

Compact Verse of the Day (sidebar use)

<div data-widetorah="votd" data-theme="light" data-size="compact"></div>
<script src="https://cdn.jsdelivr.net/npm/widetorah-embed@1/dist/embed.min.js"></script>

Search Box

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

Technical Details

• Shadow DOM: Complete style isolation — no CSS conflicts with your site
• Zero dependencies: No jQuery, React, or any external library
• System fonts: No Google Fonts request — loads instantly
• CORS: WideTorah API has CORS enabled for all origins
• Caching: Verse of the Day cached in localStorage (refreshes daily)
• MutationObserver: Works with dynamically added elements (SPAs)
• Bundle size: ~5KB gzipped

Learn More About Torah

Visit widetorah.com — WideTorah is a comprehensive Torah reference with full text, translations, and study tools.

• API docs: widetorah.com/developers/
• Widget builder: widget.widetorah.com
• npm package: npmjs.com/package/widetorah-embed

WideHoly Scripture Family

Part of WideHoly — Scripture for everyone.

Site	Domain	Scripture
WideBible	widebible.com	Bible verses, chapters, people
WideQuran	widequran.com	Quran verses, surahs
WideTorah	widetorah.com	Torah verses, portions
WideGita	widegita.com	Bhagavad Gita verses
WideSutra	widesutra.com	Buddhist sutras, teachings
WideHoly	wideholy.com	Multi-religion scripture hub

License

MIT — see LICENSE.

Built with ❤️ by WideHoly.