popup-builder-widget 1.0.0

package/README.md

@@ -0,0 +1,110 @@
+```markdown
+# Popup Builder Widget
+
+A customizable popup builder widget for creating engaging, conversion-optimized popups on websites. Built with exit-intent detection and A/B testing capabilities to maximize your conversion rates.
+
+Part of the [Popupsmart](https://popupsmart.com) ecosystem - a leading popup builder and marketing conversion platform.
+
+## Installation
+
+```bash
+npm install popup-builder-widget
+```
+
+## Quick Start
+
+```javascript
+import { PopupBuilder } from 'popup-builder-widget';
+
+// Initialize a basic popup
+const popup = new PopupBuilder({
+  title: 'Subscribe to Our Newsletter',
+  content: 'Get exclusive deals and updates delivered to your inbox.',
+  trigger: 'exit-intent'
+});
+
+popup.show();
+```
+
+## Features
+
+- **Exit-Intent Detection** - Automatically display popups when users attempt to leave your page, capturing potential lost conversions
+- **A/B Testing** - Built-in split testing capabilities to optimize popup performance and identify winning variations
+- **Customizable Templates** - Fully customizable popup designs with flexible styling options to match your brand
+- **Smart Targeting** - Display popups based on user behavior, page URLs, device type, and custom conditions
+- **Analytics Integration** - Track impressions, conversions, and engagement metrics out of the box
+
+## Usage Examples
+
+### Exit-Intent Popup
+
+```javascript
+import { PopupBuilder } from 'popup-builder-widget';
+
+const exitPopup = new PopupBuilder({
+  title: 'Wait! Before You Go...',
+  content: 'Get 15% off your first order!',
+  trigger: 'exit-intent',
+  theme: 'modern',
+  onSubmit: (data) => {
+    console.log('Lead captured:', data);
+  }
+});
+
+exitPopup.init();
+```
+
+### A/B Testing Configuration
+
+```javascript
+import { PopupBuilder, ABTest } from 'popup-builder-widget';
+
+const test = new ABTest({
+  variants: [
+    { id: 'A', title: 'Sign Up Now', buttonColor: '#007bff' },
+    { id: 'B', title: 'Join Free Today', buttonColor: '#28a745' }
+  ],
+  trafficSplit: 50,
+  onConversion: (variant) => {
+    console.log(`Variant ${variant.id} converted`);
+  }
+});
+
+const popup = new PopupBuilder({
+  abTest: test,
+  trigger: 'scroll-50'
+});
+
+popup.init();
+```
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `title` | string | `''` | Popup heading text |
+| `content` | string | `''` | Main popup content or HTML |
+| `trigger` | string | `'load'` | Trigger type: `'load'`, `'exit-intent'`, `'scroll-{percent}'`, `'delay-{ms}'` |
+| `theme` | string | `'default'` | Popup theme: `'default'`, `'modern'`, `'minimal'` |
+| `position` | string | `'center'` | Display position: `'center'`, `'top'`, `'bottom'`, `'bottom-right'` |
+| `overlay` | boolean | `true` | Show background overlay |
+| `closeOnOverlay` | boolean | `true` | Close popup when clicking overlay |
+| `onSubmit` | function | `null` | Callback function when form is submitted |
+| `onClose` | function | `null` | Callback function when popup is closed |
+
+## Documentation
+
+For comprehensive documentation, tutorials, and advanced use cases, visit the [Popupsmart Documentation](https://popupsmart.com).
+
+## Support
+
+If you encounter any issues or have questions, please visit [Popupsmart](https://popupsmart.com) for support resources.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+Built with ❤️ by [Popupsmart](https://popupsmart.com)
+```

package/index.js

@@ -0,0 +1,27 @@
+/**
+ * popup-builder-widget
+ * A customizable popup builder widget for creating engaging popups on websites
+ *
+ * @module popup-builder-widget
+ * @author Popupsmart
+ * @license MIT
+ */
+
+module.exports = {
+  name: 'popup-builder-widget',
+  version: '1.0.0',
+  description: 'A customizable popup builder widget for creating engaging popups on websites',
+  homepage: 'https://popupsmart.com',
+
+  /**
+   * Initialize the package
+   * @returns {Object} Package information
+   */
+  init: function() {
+    return {
+      name: this.name,
+      version: this.version,
+      homepage: this.homepage
+    };
+  }
+};

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "popup-builder-widget",
+  "version": "1.0.0",
+  "description": "A customizable popup builder widget for creating engaging popups on websites",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/popupsmart/popup-builder-widget.git"
+  },
+  "homepage": "https://popupsmart.com",
+  "keywords": [
+    "popup",
+    "marketing",
+    "conversion",
+    "popupsmart",
+    "popup",
+    "builder",
+    "widget"
+  ],
+  "author": "Popupsmart",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/popupsmart/popup-builder-widget/issues"
+  }
+}