🎯 Perfect for jQuery Sites - If you're already using jQuery, jAlert integrates seamlessly without adding bulky dependencies. No need to learn new frameworks or rewrite existing code.
⚡ Zero Config - Include JS/CSS and add a modal immediately, no complicated setup.
🎨 Beautiful by Default - 12 built-in themes with smooth animations. Your modals will look professional out of the box.
📱 Responsive Design - Works perfectly on desktop, tablet, and mobile with touch-friendly controls and swipe gestures.
♿ Basic Accessibility - Keyboard navigation, screen reader support, and ARIA attributes for better usability.
Minimum browser versions that should fully support this plugin:
Note: IE10 and below are not fully supported due to missing ES5 features and MutationObserver.
npm install jalert
<!-- Include jQuery first -->
<script src="https://code.jquery.com/jquery-3.7.0.min.js"></script>
<!-- Include jAlert -->
<link rel="stylesheet" href="node_modules/jalert/dist/jAlert.min.css">
<script src="node_modules/jalert/dist/jAlert.min.js"></script>
// Simple alert
$.jAlert({
title: 'Success!',
content: 'Your action was completed successfully.',
theme: 'green'
});
// Image lightbox
$.jAlert({
image: 'path/to/image.jpg',
});
// Video lightbox
$.jAlert({
video: 'https://embed.youtube.com/my-video',
});
// Slideshow gallery
$.jAlert({
slideshow: ['image1.jpg', 'image2.jpg', 'image3.jpg'],
slideshowOptions: {
autoAdvance: true,
showArrows: true,
showCounter: 'dots'
}
});
14 built-in themes: default, green, red, blue, yellow, orange, brown, gray, black, and dark variants (dark_green, dark_red, dark_blue, dark_gray, dark_orange).
🎮 Live Demo: View Interactive Examples
📚 Full Documentation: Complete API Reference
🔄 Changelog: Version History
⬆️ Upgrade Guide: Migration Instructions
git clone https://github.com/HTMLGuyLLC/jAlert.git
cd jAlert
npm install
# Build commands
npm run build # Production build (minified)
npm run dev # Development build with watch mode
# Test commands
npm test # Run unit tests only (fastest)
npm run test:unit # Run unit tests only (alias)
npm run test:e2e # Run end-to-end tests with Puppeteer
npm run test:all # Run unit + e2e tests (full test suite)npm
📋 Test Coverage:
🧪 Test Requirements:
--no-sandbox flagWe welcome contributions! See our Contributing Guide for details.
Quick Start:
MIT License - see LICENSE file for details.
If jAlert has been helpful to you, consider buying me a coffee! Your support helps maintain and improve this project.
Made with ❤️ by HTMLGuy, LLC
[6.0.0] - 2025-07-03
jAlert 6.0.0 represents a massive expansion with a complete slideshow system, enhanced video support, and comprehensive media handling capabilities. This release introduces significant new features while maintaining backward compatibility where possible.
🎠 Complete Slideshow System: Revolutionary slideshow functionality with advanced features
onSlideChange, onBeforeSlideChange, onSlideshowEnd, onSlideshowLoop, onContentLoad🎥 Enhanced Video Support: Comprehensive HTML5 video and iframe handling
createHTML5Video(), createVideoContainer(), setupVideoEventHandlers()🖼️ Improved Media Handling: Enhanced image and iframe support
buttons alias for btns option - now both buttons and btns work identically
buttons: [...] gets converted to btns: [...] internallysize: 'auto''default' instead of falsenoPadContent: true (no padding around content)embedType property ('iframe' for YouTube/Vimeo, 'html5' for direct video files). If not set, jAlert will auto-detect based on the video URL. If you set the wrong type, it will use what you specify.orange (bright, readable on light backgrounds) and dark_orange (deep orange, white text) themes for alerts and buttons. The warningAlert shortcut now uses the orange theme by default. If you want the old yellow warning, use theme: 'yellow'.FAQs
Simple jQuery (Modal | Popup | Lightbox | Alert) Plugin - ES5 compatible
The npm package jAlert receives a total of 99 weekly downloads. As such, jAlert popularity was classified as not popular.
We found that jAlert demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
The EU Cyber Resilience Act is prompting compliance requests that open source maintainers may not be obligated or equipped to handle.
Security News
Crates.io adds Trusted Publishing support, enabling secure GitHub Actions-based crate releases without long-lived API tokens.
Research
/Security News
Undocumented protestware found in 28 npm packages disrupts UI for Russian-language users visiting Russian and Belarusian domains.