rails_tipjar 0.2.2 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd4604e05718d8a32b4384bd139441e1b2e46bf3716fc2daa2247a28755308ad
-  data.tar.gz: 386776445d6478db9a2b871cf4fd67f2d999699092eb001d0f875d83717650b3
+  metadata.gz: 7f5dec9fdb53e29e9d8cd8a8265faad3fbb11d2aa01e29ace84f630400379f2c
+  data.tar.gz: ce6ac3c9a93e85d5839da4dd757490ae4b0dab9026ad46acd4dfff7643db3b66
 SHA512:
-  metadata.gz: 22b84d3ed5cd38428af7ef20f7405a3d45e963ccb7f0400f8356e99aa8aff17c17f8165ea716c08d2a4cc31a8c3171109cdebd58c249020dcb85c7c00bb0b81c
-  data.tar.gz: ea37e3133dd9190777f33aac89d36b90193c895475e2e5474f36dc9f36c05cd6411aa3ef4b26fd4ac259d488d83ca84ef3cce396288543e487885ea23f2eac08
+  metadata.gz: b4c4ea41cd2857f19736af2e337558f5a250bdcc426998888c5b7f6e17eb449fffd0b7ae640b315b9b3c10f20942acec33676f57e46227020c2aaff4539e4ed3
+  data.tar.gz: 015757b7e6d7991c95d7f5a0c91391e06713bdd1bd5bef600e06d5fccdf3ddc922c45300e684bc1052c7a8e5bd0e45e2a1f72c78508c30e52b2e22e81d3b5650

data/README.md

@@ -1,76 +1,121 @@
 # RailsTipjar
 
-A reusable, customizable tip jar feature for Rails applications using Stripe Payment Links. Add a beautiful tip jar to any Rails app with just a few lines of code!
+A reusable, customizable tip jar feature for Rails applications. Add a beautiful tip jar to any Rails app with just a few lines of code! Works with any payment provider - Stripe, PayPal, Buy Me a Coffee, Ko-fi, or any custom payment link.
 
 ## Features
 
-- 🎨 Customizable floating button with multiple icon options
-- 💳 Stripe Payment Links integration (no backend payment processing needed)
-- 📱 Fully responsive design
-- 🎯 Multiple positioning options
-- 🌙 Light/Dark theme support
+- 🎨 Customizable floating button with multiple icon options (coffee, heart, star, dollar, jar)
+- 🎨 Custom color theming with configurable background and text colors
+- 💫 Optional pulsing animation effect
+- 💳 Works with any payment provider (Stripe, PayPal, Ko-fi, Buy Me a Coffee, etc.)
+- 📱 Fully responsive design with inline styles (no CSS dependencies)
+- 🎯 Multiple positioning options (bottom-right, bottom-left, top-right, top-left)
+- 🌙 Light/Dark theme support for modal
 - 📊 Built-in analytics tracking
 - ⚡ Stimulus.js powered interactions
 - 🔧 Zero configuration to get started
+- 🚀 Simple mode: Direct link without modal
+- ✨ Fully self-contained (v0.2.0+)
 
-## Why Stripe Payment Links?
+## Why Use Payment Links?
 
 - **No payment code** in your Rails apps
-- **PCI compliant** automatically  
-- **No monthly fees** - pay only 2.9% + 30¢ per transaction
-- **International support** with multi-currency
-- **Professional checkout** experience
-- **Automatic receipts** and tax handling
+- **No PCI compliance concerns** - handled by your payment provider
+- **Multiple provider options** - use Stripe, PayPal, Ko-fi, Buy Me a Coffee, or any service
+- **International support** - most providers support multiple currencies
+- **Professional checkout** experience managed by the provider
+- **Automatic receipts** and tax handling by the payment provider
 
 ## Installation
 
 Add this gem to your Rails application's Gemfile:
 
 ```ruby
-# From GitHub (recommended during development)
-gem 'rails_tipjar', git: 'https://github.com/justinpaulson/rails_tipjar'
-
-# Or from RubyGems (when published)
+# From RubyGems
 gem 'rails_tipjar'
+
+# Or from GitHub for latest features
+gem 'rails_tipjar', git: 'https://github.com/justinpaulson/rails_tipjar'
 ```
 
 Then execute:
 
 ```bash
 bundle install
+```
+
+Optionally run the generator (only needed for backwards compatibility with v0.3.0 and earlier):
+```bash
 rails generate tipjar:install
 ```
 
 ## Quick Start
 
-### 1. Create Stripe Payment Links
+### 1. Create Payment Links
 
-1. Go to [Stripe Dashboard](https://dashboard.stripe.com/payment-links)
-2. Create payment links for different tip amounts
-3. Set them to "Donation" mode
-4. Copy the generated URLs
+Choose your preferred payment provider and create payment links:
 
-### 2. Configure the Gem
+**Popular Options:**
+- **Stripe**: [dashboard.stripe.com/payment-links](https://dashboard.stripe.com/payment-links)
+- **PayPal**: [paypal.com/paypalme](https://paypal.com/paypalme)
+- **Ko-fi**: [ko-fi.com](https://ko-fi.com)
+- **Buy Me a Coffee**: [buymeacoffee.com](https://buymeacoffee.com)
+- **GitHub Sponsors**: [github.com/sponsors](https://github.com/sponsors)
 
-Edit `config/initializers/tipjar.rb`:
+Create links for different amounts or use a single link that accepts custom amounts.
 
-```ruby
-RailsTipjar.configure do |config|
-  config.payment_links = {
-    small: "https://buy.stripe.com/your-5-dollar-link",
-    medium: "https://buy.stripe.com/your-10-dollar-link",
-    large: "https://buy.stripe.com/your-25-dollar-link"
-  }
-  
-  config.position = :bottom_right
-  config.icon = :coffee
-  config.button_text = "Buy me a coffee"
-end
+### 2. Add to Your Views
+
+No configuration file needed! Simply use the helper in your views with all options:
+
+#### Simple Button (Direct Link)
+
+Add directly to any view:
+
+```erb
+<!-- Basic usage with default coffee icon -->
+<%= tip_jar payment_link: 'https://your.payment.link' %>
+
+<!-- With all customization options -->
+<%= tip_jar payment_link: 'https://your.payment.link',
+            message: 'Support This Project',     # Text shown on hover
+            icon: :heart,                        # :coffee, :heart, :star, :dollar, :jar, or custom SVG
+            position: :bottom_right,              # :bottom_right, :bottom_left, :top_right, :top_left
+            color: '#8b5cf6',                    # Button background color
+            text_color: '#ffffff',               # Button text color
+            pulse: true,                         # Enable pulsing animation
+            z_index: 1000,                       # Stack order
+            class: 'my-custom-class' %>          # Additional CSS classes
+```
+
+#### Modal Mode (Multiple Payment Options)
+
+```erb
+<!-- Modal with multiple payment amounts -->
+<%= tip_jar payment_links: {
+              small: 'https://your-provider.com/tip-5',
+              medium: 'https://your-provider.com/tip-10',
+              large: 'https://your-provider.com/tip-25'
+            },
+            modal_title: 'Support my work',
+            modal_description: 'Your support helps me continue creating.',
+            custom_amounts: [
+              { amount: 5, label: '$5', default: false },
+              { amount: 10, label: '$10', default: true },
+              { amount: 25, label: '$25', default: false }
+            ],
+            theme: :light,                       # :light, :dark, :auto
+            analytics_enabled: true %>
+
+<!-- Force modal mode with single link -->
+<%= tip_jar payment_link: 'https://your.payment.link',
+            use_modal: true,
+            modal_title: 'Choose your support amount' %>
 ```
 
-### 3. Add to Your Layout
+#### In Layouts
 
-In `app/views/layouts/application.html.erb`:
+Add to `app/views/layouts/application.html.erb`:
 
 ```erb
 <!DOCTYPE html>
@@ -81,81 +126,61 @@ In `app/views/layouts/application.html.erb`:
   <body>
     <%= yield %>
     
-    <!-- Add tip jar button -->
-    <%= tipjar_button %>
+    <!-- Add floating tip jar button -->
+    <%= tip_jar payment_link: 'https://your.payment.link',
+                position: :bottom_right %>
   </body>
 </html>
 ```
 
 That's it! You now have a working tip jar on your site.
 
-## Configuration Options
+## Helper Options
 
-```ruby
-RailsTipjar.configure do |config|
-  # Payment Links (required)
-  config.payment_links = {
-    small: "...",
-    medium: "...",
-    large: "...",
-    custom: "..."  # Optional: for custom amounts
-  }
-  
-  # Button position
-  # Options: :bottom_right, :bottom_left, :top_right, :top_left
-  config.position = :bottom_right
-  
-  # Button icon
-  # Options: :coffee, :heart, :star, :dollar, or custom SVG string
-  config.icon = :coffee
-  
-  # Theme
-  # Options: :light, :dark, :auto
-  config.theme = :light
-  
-  # Button text (shown on hover)
-  config.button_text = "Buy me a coffee"
-  
-  # Modal customization
-  config.modal_title = "Support my work"
-  config.modal_description = "Your support helps me continue creating."
-  
-  # Tip amounts shown in modal
-  config.custom_amounts = [
-    { amount: 5, label: "$5", default: false },
-    { amount: 10, label: "$10", default: true },
-    { amount: 25, label: "$25", default: false },
-    { amount: 50, label: "$50", default: false }
-  ]
-  
-  # Additional styling
-  config.button_class = "custom-class"
-  config.z_index = 1000
-  
-  # Analytics
-  config.analytics_enabled = true  # Works with GA4 and Plausible
-end
-```
+All configuration is done directly in the view helper:
 
-## Usage
+### Common Options
 
-### Basic Button
+| Option | Description | Default | Values |
+|--------|-------------|---------|--------|
+| `payment_link` | Single payment URL for simple mode | - | URL string |
+| `payment_links` | Hash of payment URLs for modal mode | - | Hash with keys like `:small`, `:medium`, `:large` |
+| `message` / `button_text` | Text shown on button (on hover) | `"Buy me a coffee"` | String |
+| `icon` | Button icon | `:coffee` | `:coffee`, `:heart`, `:star`, `:dollar`, `:jar`, or custom SVG |
+| `position` | Button position on screen | `:bottom_right` | `:bottom_right`, `:bottom_left`, `:top_right`, `:top_left` |
+| `color` | Button background color | `"#3b82f6"` | Hex color string |
+| `text_color` | Button text color | `"#ffffff"` | Hex color string |
+| `pulse` | Enable pulsing animation | `false` | `true` / `false` |
+| `z_index` | CSS z-index for stacking | `1000` | Integer |
+| `class` | Additional CSS classes | `""` | String |
+| `use_modal` | Force modal mode | `false` | `true` / `false` |
 
-```erb
-<!-- Default button with all config options -->
-<%= tipjar_button %>
+### Modal-Specific Options
 
-<!-- Override position for specific button -->
-<%= tipjar_button position: :top_left %>
+| Option | Description | Default |
+|--------|-------------|----------|
+| `modal_title` | Modal header text | `"Support my work"` |
+| `modal_description` | Modal description text | `"Your support helps..."` |
+| `theme` | Modal color theme | `:light` |
+| `custom_amounts` | Array of amount options | See example below |
+| `analytics_enabled` | Track user interactions | `false` |
 
-<!-- Add custom CSS classes -->
-<%= tipjar_button class: "my-custom-class" %>
-```
+### Custom Amounts Example
+
+```ruby
+custom_amounts: [
+  { amount: 5, label: "$5", default: false },
+  { amount: 10, label: "$10", default: true },  # This will be pre-selected
+  { amount: 25, label: "$25", default: false },
+  { amount: 50, label: "$50", default: false }
+]
 
-### Custom Links
+## Additional Helpers
+
+### Custom Tip Links
 
 ```erb
-<!-- Create a custom tip link -->
+<!-- Create a custom tip link (requires initializer config) -->
 <%= tipjar_link "Support this project", amount: :large %>
 
 <!-- With custom styling -->
@@ -169,10 +194,33 @@ end
 <%= tipjar_modal %>
 ```
 
+## Backwards Compatibility
+
+If you're upgrading from v0.3.0 or earlier and want to keep using the initializer-based configuration:
+
+```erb
+<!-- Use the deprecated tipjar_button helper -->
+<%= tipjar_button %>
+```
+
+This requires having a `config/initializers/tipjar.rb` file. We recommend migrating to the new `tip_jar` helper with inline options for easier customization.
+
 ## Styling
 
-The gem includes default styles that work with most Rails applications. You can override styles by targeting these CSS classes:
+As of v0.2.0, the gem is fully self-contained with inline styles - no external CSS required! The button works out of the box without any app-side styling.
+
+### Customization Options
+
+1. **Via Helper Options** (Recommended):
+```erb
+<%= tip_jar payment_link: 'https://your.link',
+            color: '#10b981',       # Green background
+            text_color: '#000000',  # Black text
+            pulse: true,            # Enable pulsing animation
+            class: 'custom' %>      # Add custom CSS classes
+```
 
+2. **Via CSS Classes** (for modal mode):
 ```css
 /* Button */
 .tipjar-button { }
@@ -217,6 +265,26 @@ To test in a Rails app, add to your Gemfile:
 gem 'rails_tipjar', path: '../path/to/rails_tipjar'
 ```
 
+## Icon Options
+
+The gem includes 5 built-in icons:
+- `:coffee` - Coffee cup (default)
+- `:heart` - Heart shape
+- `:star` - Star
+- `:dollar` - Dollar sign in circle
+- `:jar` - Tip jar with animated coin
+
+You can also provide a custom SVG string for complete customization.
+
+## Version History
+
+- **v1.0.0** - Stable release with all configuration in view helper options (no initializer needed!)
+- **v0.3.0** - Made payment provider agnostic (works with any payment link service)
+- **v0.2.2** - Added color customization and pulse animation control
+- **v0.2.1** - Fixed button circular shape when icon only displayed
+- **v0.2.0** - Made gem fully self-contained with inline styles
+- **v0.1.0** - Initial release
+
 ## Troubleshooting
 
 ### Button not appearing
@@ -225,15 +293,15 @@ gem 'rails_tipjar', path: '../path/to/rails_tipjar'
 2. Verify Stimulus is working in your app
 3. Check browser console for JavaScript errors
 
-### Modal not opening
+### Modal not opening (modal mode only)
 
 1. Ensure Stimulus controller is registered
-2. Check that tipjar.css is being loaded
-3. Verify no z-index conflicts with your existing styles
+2. Verify no z-index conflicts with your existing styles
+3. Make sure `use_modal = true` if using single payment_link
 
 ### Payment links not working
 
-1. Ensure your Stripe Payment Links are active
+1. Ensure your payment links are active with your provider
 2. Check that URLs are correctly configured in initializer
 3. Test links directly in browser
 

data/app/helpers/tipjar_helper.rb

@@ -1,95 +1,184 @@
 module TipjarHelper
-  def tipjar_button(options = {})
-    config = RailsTipjar.config
+  def tip_jar(options = {})
+    # Extract all options with sensible defaults
+    payment_link = options[:payment_link] || options[:link]
+    payment_links = options[:payment_links]
+    use_modal = options[:use_modal] || false
+    
+    # Button configuration
+    message = options[:message] || options[:button_text] || "Buy me a coffee"
+    icon = options[:icon] || :coffee
+    position = options[:position] || :bottom_right
+    color = options[:color] || "#3b82f6"
+    text_color = options[:text_color] || "#ffffff"
+    pulse = options[:pulse] || false
+    z_index = options[:z_index] || 1000
+    custom_class = options[:class] || ""
     
-    position = options[:position] || config.position
-    custom_class = options[:class] || config.button_class
-    z_index = options[:z_index] || config.z_index
+    # Modal configuration (if using modal)
+    modal_title = options[:modal_title] || "Support my work"
+    modal_description = options[:modal_description] || "Your support helps me continue creating and maintaining this project."
+    theme = options[:theme] || :light
+    custom_amounts = options[:custom_amounts] || [
+      { amount: 5, label: "$5", default: false },
+      { amount: 10, label: "$10", default: true },
+      { amount: 25, label: "$25", default: false },
+      { amount: 50, label: "$50", default: false }
+    ]
+    analytics_enabled = options[:analytics_enabled] || false
     
-    # Inject CSS styles into the page once
-    tipjar_styles + tipjar_button_html(config, position, custom_class, z_index)
+    # Ensure color has # prefix
+    color = "##{color}" unless color.start_with?('#')
+    text_color = "##{text_color}" unless text_color.start_with?('#')
+    
+    # If payment_links is provided or use_modal is true, use modal mode
+    if payment_links || use_modal
+      # Modal mode
+      tipjar_modal_button(
+        payment_links: payment_links || { default: payment_link },
+        position: position,
+        icon: icon,
+        theme: theme,
+        button_text: message,
+        modal_title: modal_title,
+        modal_description: modal_description,
+        custom_amounts: custom_amounts,
+        button_class: custom_class,
+        z_index: z_index,
+        analytics_enabled: analytics_enabled,
+        color: color,
+        text_color: text_color,
+        pulse: pulse
+      )
+    elsif payment_link
+      # Simple direct link mode
+      tipjar_simple_button(
+        payment_link: payment_link,
+        message: message,
+        icon: icon,
+        position: position,
+        color: color,
+        text_color: text_color,
+        pulse: pulse,
+        z_index: z_index,
+        custom_class: custom_class
+      )
+    else
+      # No payment method specified
+      raise ArgumentError, "You must provide either :payment_link or :payment_links option to tip_jar helper"
+    end
   end
   
-  private
-  
-  def tipjar_button_html(config, position, custom_class, z_index)
-    # Simple direct link mode when payment_link is set
-    if config.payment_link && !config.use_modal
-      position_style = position_inline_styles(position)
-      button_style = "#{position_style} z-index: #{z_index}; display: flex; align-items: center; padding: 0.75rem 1rem; background-color: #3b82f6; color: white; border-radius: 9999px; box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1); transition: all 0.3s ease; cursor: pointer; border: none; font-size: 0.875rem; font-weight: 500; text-decoration: none; animation: tipjar-pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;"
-      
-      link_to config.payment_link,
-              target: "_blank",
-              rel: "noopener",
-              class: "tipjar-button #{custom_class}",
-              style: button_style,
-              onmouseover: "this.style.backgroundColor='#2563eb'; this.style.transform='scale(1.05)'; this.querySelector('.tipjar-button-text').style.maxWidth='200px'; this.querySelector('.tipjar-button-text').style.marginLeft='0.5rem';",
-              onmouseout: "this.style.backgroundColor='#3b82f6'; this.style.transform='scale(1)'; this.querySelector('.tipjar-button-text').style.maxWidth='0'; this.querySelector('.tipjar-button-text').style.marginLeft='0';" do
-        content_tag(:span, style: "display: flex; align-items: center; justify-content: center; width: 1.5rem; height: 1.5rem;") do
-          raw config.icon_svg
-        end +
-        content_tag(:span, config.button_text, class: "tipjar-button-text", style: "white-space: nowrap; max-width: 0; overflow: hidden; transition: all 0.3s ease; margin-left: 0;")
-      end
+  # Deprecated - kept for backwards compatibility
+  def tipjar_button(options = {})
+    config = RailsTipjar.config if defined?(RailsTipjar)
+    
+    if config && (config.payment_link || config.payment_links.any?)
+      # Use config from initializer for backwards compatibility
+      tip_jar(
+        payment_link: config.payment_link,
+        payment_links: config.payment_links.any? ? config.payment_links : nil,
+        use_modal: config.use_modal,
+        position: options[:position] || config.position,
+        icon: config.icon,
+        button_text: config.button_text,
+        color: config.color,
+        text_color: config.text_color,
+        pulse: config.pulse,
+        z_index: options[:z_index] || config.z_index,
+        class: options[:class] || config.button_class,
+        modal_title: config.modal_title,
+        modal_description: config.modal_description,
+        custom_amounts: config.custom_amounts,
+        theme: config.theme,
+        analytics_enabled: config.analytics_enabled
+      )
     else
-      # Original modal mode - would need more work to be fully inline
-      content_tag :div, 
-                  class: "tipjar-container",
-                  data: { 
-                    controller: "tipjar",
-                    tipjar_payment_links_value: config.payment_links.to_json,
-                    tipjar_theme_value: config.theme,
-                    tipjar_modal_title_value: config.modal_title,
-                    tipjar_modal_description_value: config.modal_description,
-                    tipjar_custom_amounts_value: config.custom_amounts.to_json,
-                    tipjar_analytics_enabled_value: config.analytics_enabled
-                  } do
-        render partial: "tipjar/button", locals: {
-          position: position,
-          custom_class: custom_class,
-          z_index: z_index,
-          config: config
-        }
-      end
+      raise ArgumentError, "tipjar_button requires configuration. Use tip_jar helper with options instead."
+    end
+  end
+
+  private
+
+  def tipjar_simple_button(options = {})
+    payment_link = options[:payment_link]
+    message = options[:message]
+    icon = options[:icon]
+    position = options[:position]
+    color = options[:color]
+    text_color = options[:text_color]
+    pulse = options[:pulse]
+    z_index = options[:z_index]
+    custom_class = options[:custom_class]
+    
+    position_style = position_inline_styles(position)
+    animation_style = pulse ? "animation: tipjar-pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;" : ""
+    
+    # Default to collapsed (icon-only) that expands on hover - 48x48px total
+    button_style = "#{position_style} z-index: #{z_index}; display: inline-flex; align-items: center; justify-content: center; padding: 12px; background-color: #{color}; color: #{text_color}; border-radius: 9999px; box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1); transition: all 0.3s ease; cursor: pointer; border: none; font-size: 0.875rem; font-weight: 500; text-decoration: none; box-sizing: border-box; #{animation_style}"
+    
+    hover_color = darken_color(color)
+    
+    # Inject styles if needed
+    styles = tipjar_styles
+    
+    # Create the link with inline styles - collapsed by default, expands on hover
+    link_html = link_to payment_link,
+                       target: "_blank",
+                       rel: "noopener",
+                       class: "tipjar-button #{custom_class}",
+                       style: button_style,
+                       onmouseover: "this.style.backgroundColor='#{hover_color}'; this.style.transform='scale(1.05)'; this.style.padding='12px 20px'; this.querySelector('.tipjar-text').style.maxWidth='200px'; this.querySelector('.tipjar-text').style.marginLeft='0.5rem';",
+                       onmouseout: "this.style.backgroundColor='#{color}'; this.style.transform='scale(1)'; this.style.padding='12px'; this.querySelector('.tipjar-text').style.maxWidth='0'; this.querySelector('.tipjar-text').style.marginLeft='0';" do
+      content_tag(:span, style: "display: inline-flex; align-items: center; justify-content: center; width: 1.5rem; height: 1.5rem;") do
+        raw icon_svg(icon)
+      end +
+      content_tag(:span, message, class: "tipjar-text", style: "white-space: nowrap; max-width: 0; overflow: hidden; transition: all 0.3s ease; margin-left: 0;")
     end
+    
+    styles + link_html
   end
   
+  def tipjar_modal_button(options = {})
+    # Modal mode - renders button with modal
+    content_tag :div,
+                class: "tipjar-container",
+                data: {
+                  controller: "tipjar",
+                  tipjar_payment_links_value: options[:payment_links].to_json,
+                  tipjar_theme_value: options[:theme],
+                  tipjar_modal_title_value: options[:modal_title],
+                  tipjar_modal_description_value: options[:modal_description],
+                  tipjar_custom_amounts_value: options[:custom_amounts].to_json,
+                  tipjar_analytics_enabled_value: options[:analytics_enabled]
+                } do
+      render partial: "tipjar/button", locals: {
+        position: options[:position],
+        custom_class: options[:button_class],
+        z_index: options[:z_index],
+        icon: options[:icon],
+        button_text: options[:button_text],
+        color: options[:color],
+        text_color: options[:text_color],
+        pulse: options[:pulse]
+      }
+    end
+  end
+
   def tipjar_styles
     return "" if @tipjar_styles_injected
     @tipjar_styles_injected = true
-    
+
     content_tag :style do
       <<~CSS.html_safe
         @keyframes tipjar-pulse {
           0%, 100% { opacity: 1; }
           50% { opacity: 0.8; }
         }
-        
-        @keyframes tipjar-coin-drop {
-          0% {
-            transform: translateY(0) rotate(0deg);
-            opacity: 0;
-          }
-          20% {
-            opacity: 1;
-          }
-          80% {
-            transform: translateY(7px) rotate(180deg);
-            opacity: 1;
-          }
-          100% {
-            transform: translateY(9px) rotate(180deg);
-            opacity: 0;
-          }
-        }
-        
-        .tipjar-coin-animation {
-          animation: tipjar-coin-drop 2s ease-in-out infinite;
-          transform-origin: center;
-        }
       CSS
     end
   end
-  
+
   def position_inline_styles(position)
     case position
     when :bottom_right
@@ -104,18 +193,18 @@ module TipjarHelper
       "position: fixed; bottom: 1rem; right: 1rem;"
     end
   end
-  
+
   def tipjar_link(text = nil, options = {})
     config = RailsTipjar.config
     text ||= config.button_text
     amount = options[:amount] || :medium
-    
+
     link_url = if amount.is_a?(Symbol)
       config.payment_links[amount]
     else
       config.payment_links[:custom] || config.payment_links[:medium]
     end
-    
+
     link_options = {
       target: "_blank",
       rel: "noopener",
@@ -125,19 +214,19 @@ module TipjarHelper
         tipjar_analytics: config.analytics_enabled
       }
     }
-    
+
     link_to text, link_url, link_options.merge(options.except(:amount, :class))
   end
-  
+
   def tipjar_modal(options = {})
     config = RailsTipjar.config
-    
+
     render partial: "tipjar/modal", locals: {
       config: config,
       options: options
     }
   end
-  
+
   def config_position_classes(position)
     case position
     when :bottom_right
@@ -152,4 +241,144 @@ module TipjarHelper
       "fixed bottom-4 right-4"
     end
   end
-end
+
+  def icon_svg(icon)
+    case icon
+    when :coffee
+      '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="w-6 h-6">
+        <defs>
+          <style>
+            @keyframes steam1 {
+              0% { opacity: 0; transform: translateY(0) translateX(0); }
+              20% { opacity: 0.8; }
+              50% { opacity: 0.6; transform: translateY(-3px) translateX(1px); }
+              80% { opacity: 0.3; }
+              100% { opacity: 0; transform: translateY(-8px) translateX(-1px); }
+            }
+            @keyframes steam2 {
+              0% { opacity: 0; transform: translateY(0) translateX(0); }
+              15% { opacity: 0.7; }
+              45% { opacity: 0.5; transform: translateY(-4px) translateX(-1px); }
+              75% { opacity: 0.2; }
+              100% { opacity: 0; transform: translateY(-9px) translateX(1px); }
+            }
+            @keyframes steam3 {
+              0% { opacity: 0; transform: translateY(0) translateX(0); }
+              25% { opacity: 0.6; }
+              55% { opacity: 0.4; transform: translateY(-3px) translateX(0.5px); }
+              85% { opacity: 0.1; }
+              100% { opacity: 0; transform: translateY(-7px) translateX(-0.5px); }
+            }
+            .steam1 { animation: steam1 3s ease-out infinite; }
+            .steam2 { animation: steam2 3s ease-out infinite 0.5s; }
+            .steam3 { animation: steam3 3s ease-out infinite 1s; }
+          </style>
+        </defs>
+        <!-- Steam wisps with wavy paths -->
+        <path class="steam1" d="M8 9c0.5-0.5 0.5-1 0-1.5s-0.5-1 0-1.5s0.5-1 0-1.5" stroke-linecap="round" fill="none" opacity="0"/>
+        <path class="steam2" d="M12 8.5c-0.3-0.4 -0.3-0.8 0-1.2s0.3-0.8 0-1.2s-0.3-0.8 0-1.2" stroke-linecap="round" fill="none" opacity="0"/>
+        <path class="steam3" d="M15.5 9c0.4-0.3 0.4-0.7 0-1s-0.4-0.7 0-1s0.4-0.7 0-1" stroke-linecap="round" fill="none" opacity="0"/>
+        <!-- Coffee cup body -->
+        <path stroke-linecap="round" stroke-linejoin="round" d="M6 10h12v7a3 3 0 01-3 3H9a3 3 0 01-3-3v-7z"/>
+        <!-- Cup handle -->
+        <path stroke-linecap="round" stroke-linejoin="round" d="M18 10h1.5a2.5 2.5 0 010 5H18"/>
+        <!-- Saucer -->
+        <path stroke-linecap="round" stroke-linejoin="round" d="M4 20h16"/>
+        <!-- Coffee surface detail -->
+        <path stroke-linecap="round" stroke-linejoin="round" d="M8 12h8" opacity="0.3"/>
+      </svg>'
+    when :heart
+      '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="w-6 h-6">
+        <path stroke-linecap="round" stroke-linejoin="round" d="M21 8.5c0-2.485-2.099-4.5-4.688-4.5-1.935 0-3.597 1.126-4.312 2.733-.715-1.607-2.377-2.733-4.313-2.733C5.1 4 3 6.015 3 8.5c0 7.5 9 11.5 9 11.5s9-4 9-11.5z" />
+      </svg>'
+    when :star
+      '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="w-6 h-6">
+        <path stroke-linecap="round" stroke-linejoin="round" d="M11.48 3.499a.562.562 0 011.04 0l2.125 5.111a.563.563 0 00.475.345l5.518.442c.499.04.701.663.321.988l-4.204 3.602a.563.563 0 00-.182.557l1.285 5.385a.562.562 0 01-.84.61l-4.725-2.885a.563.563 0 00-.586 0L6.982 20.54a.562.562 0 01-.84-.61l1.285-5.386a.562.562 0 00-.182-.557l-4.204-3.602a.563.563 0 01.321-.988l5.518-.442a.563.563 0 00.475-.345L11.48 3.5z" />
+      </svg>'
+    when :dollar
+      '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="w-6 h-6">
+        <path stroke-linecap="round" stroke-linejoin="round" d="M12 6v12m-3-2.818l.879.659c1.171.879 3.07.879 4.242 0 1.172-.879 1.172-2.303 0-3.182C13.536 12.219 12.768 12 12 12c-.725 0-1.45-.22-2.003-.659-1.106-.879-1.106-2.303 0-3.182s2.9-.879 4.006 0l.415.33M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+      </svg>'
+    when :jar
+      '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="w-6 h-6">
+        <defs>
+          <style>
+            @keyframes tipjar-coin-drop-new {
+              0% {
+                transform: translateY(0px);
+                opacity: 0;
+              }
+              10% {
+                opacity: 1;
+                transform: translateY(2px);
+              }
+              30% {
+                transform: translateY(6px);
+              }
+              50% {
+                transform: translateY(10px);
+                opacity: 1;
+              }
+              70% {
+                transform: translateY(15.5px);
+                opacity: 1;
+              }
+              75% {
+                transform: translateY(16.3px);
+                opacity: 1;
+              }
+              80% {
+                transform: translateY(15.8px);
+                opacity: 0.8;
+              }
+              100% {
+                transform: translateY(16.3px);
+                opacity: 0;
+              }
+            }
+            .tipjar-coin-drop-new {
+              animation: tipjar-coin-drop-new 2.5s ease-in-out infinite;
+            }
+          </style>
+        </defs>
+        <!-- Jar lid -->
+        <rect x="9.5" y="3" width="5" height="1" rx="0.25" stroke-linecap="round" stroke-linejoin="round"/>
+        <!-- Jar threads/neck -->
+        <path stroke-linecap="round" stroke-linejoin="round" d="M10 4v0.8M14 4v0.8"/>
+        <!-- Jar body - much fatter with short taper -->
+        <path stroke-linecap="round" stroke-linejoin="round" d="M10 4.8h4M9 5.5c-1 0 -2 0.5 -2 1v12.5a2 2 0 002 2h6a2 2 0 002-2V6.5c0-0.5 -1-1 -2-1"/>
+        <!-- Coins at bottom - pile -->
+        <ellipse cx="10.5" cy="18.5" rx="1.5" ry="0.5" stroke-linecap="round"/>
+        <ellipse cx="13.5" cy="18.3" rx="1.5" ry="0.5" stroke-linecap="round"/>
+        <ellipse cx="12" cy="17.8" rx="1.5" ry="0.5" stroke-linecap="round"/>
+        <ellipse cx="11" cy="19" rx="1.3" ry="0.4" stroke-linecap="round"/>
+        <ellipse cx="13" cy="19" rx="1.3" ry="0.4" stroke-linecap="round"/>
+        <!-- Falling coin - starts above jar outside -->
+        <g class="tipjar-coin-drop-new">
+          <ellipse cx="12" cy="1.5" rx="1.5" ry="0.5" stroke-linecap="round"/>
+        </g>
+      </svg>'
+    else
+      # Allow custom SVG string
+      icon.to_s
+    end
+  end
+  
+  def darken_color(hex_color)
+    # Remove # if present
+    hex = hex_color.gsub('#', '')
+
+    # Convert to RGB
+    r = hex[0..1].to_i(16)
+    g = hex[2..3].to_i(16)
+    b = hex[4..5].to_i(16)
+
+    # Darken by 20%
+    r = (r * 0.8).to_i
+    g = (g * 0.8).to_i
+    b = (b * 0.8).to_i
+
+    # Convert back to hex
+    "#%02x%02x%02x" % [r, g, b]
+  end
+end

data/app/views/tipjar/_button.html.erb

@@ -2,15 +2,15 @@
   data-tipjar-target="button"
   data-action="click->tipjar#openModal"
   class="tipjar-button <%= config_position_classes(position) %> <%= custom_class %>"
-  style="z-index: <%= z_index %>;"
-  aria-label="<%= config.button_text %>"
+  style="z-index: <%= z_index %>; background-color: <%= color %>; color: <%= text_color %>; <%= pulse ? 'animation: tipjar-pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;' : '' %>"
+  aria-label="<%= button_text %>"
 >
   <span class="tipjar-button-icon">
-    <%= raw config.icon_svg %>
+    <%= raw icon_svg(icon) %>
   </span>
   <span class="tipjar-button-text">
-    <%= config.button_text %>
+    <%= button_text %>
   </span>
 </button>
 
-<%= render "tipjar/modal", config: config %>
+<%= render "tipjar/modal", locals: local_assigns.except(:position, :custom_class, :z_index, :icon, :button_text, :color, :text_color, :pulse) %>

data/app/views/tipjar/_modal.html.erb

@@ -63,10 +63,10 @@
         Continue to Payment
       </button>
 
-      <!-- Powered by Stripe -->
+      <!-- Footer -->
       <div class="tipjar-modal-footer mt-4 text-center">
         <p class="text-xs text-gray-500">
-          Secure payment powered by Stripe
+          Secure payment processing
         </p>
       </div>
     </div>

data/lib/generators/tipjar/install/install_generator.rb

@@ -5,10 +5,12 @@ module Tipjar
     class InstallGenerator < Rails::Generators::Base
       source_root File.expand_path("templates", __dir__)
       
-      desc "Creates a RailsTipjar initializer and copies necessary files"
+      desc "Creates an optional RailsTipjar initializer for backwards compatibility"
       
       def copy_initializer
-        template "tipjar.rb", "config/initializers/tipjar.rb"
+        if yes?("Do you want to create an initializer file for backwards compatibility? (not recommended - use view helper options instead) [y/N]")
+          template "tipjar.rb", "config/initializers/tipjar.rb"
+        end
       end
       
       def add_stimulus_controller
@@ -68,23 +70,32 @@ module Tipjar
         say "RailsTipjar has been successfully installed!", :green
         say "\n"
         say "Next steps:", :yellow
-        say "1. Create Stripe Payment Links at https://dashboard.stripe.com/payment-links", :yellow
-        say "2. Configure your payment links in config/initializers/tipjar.rb", :yellow
-        say "3. Add <%= tipjar_button %> to your layout file", :yellow
+        say "1. Create payment links with your preferred provider (Stripe, PayPal, Ko-fi, etc.)", :yellow
+        say "2. Add the tip jar to your views using the helper", :yellow
         say "\n"
-        say "Example configuration:", :cyan
-        say <<~CONFIG
-          RailsTipjar.configure do |config|
-            config.payment_links = {
-              small: "https://buy.stripe.com/your-link-1",
-              medium: "https://buy.stripe.com/your-link-2",
-              large: "https://buy.stripe.com/your-link-3"
-            }
-            config.position = :bottom_right
-            config.icon = :coffee
-            config.theme = :light
-          end
-        CONFIG
+        say "Example usage in your views:", :cyan
+        say <<~USAGE
+          <!-- Simple button with direct link -->
+          <%= tip_jar payment_link: 'https://your.payment.link' %>
+          
+          <!-- With custom options -->
+          <%= tip_jar payment_link: 'https://your.payment.link',
+                      message: 'Support This Project',
+                      icon: :heart,
+                      color: '#8b5cf6',
+                      pulse: true %>
+          
+          <!-- Modal with multiple payment amounts -->
+          <%= tip_jar payment_links: {
+                        small: 'https://link-5',
+                        medium: 'https://link-10',
+                        large: 'https://link-25'
+                      },
+                      modal_title: 'Support my work',
+                      position: :bottom_left %>
+        USAGE
+        say "\n"
+        say "For more options, see the README: https://github.com/justinpaulson/rails_tipjar", :cyan
         say "\n"
       end
     end

data/lib/generators/tipjar/install/templates/tipjar.rb

@@ -1,16 +1,18 @@
 # frozen_string_literal: true
 
 RailsTipjar.configure do |config|
-  # Configure your Stripe Payment Links
-  # Create payment links at: https://dashboard.stripe.com/payment-links
+  # Configure your payment links
+  # Works with any payment provider: Stripe, PayPal, Ko-fi, Buy Me a Coffee, etc.
   # 
-  # You can create different links for different amounts, or use a single
-  # link that allows custom amounts
+  # Simple mode - just one payment link:
+  # config.payment_link = "https://your-payment-provider.com/your-link"
+  #
+  # Modal mode - multiple payment links for different amounts:
   config.payment_links = {
-    small: "https://buy.stripe.com/test_REPLACE_WITH_YOUR_LINK",
-    medium: "https://buy.stripe.com/test_REPLACE_WITH_YOUR_LINK",
-    large: "https://buy.stripe.com/test_REPLACE_WITH_YOUR_LINK",
-    custom: "https://buy.stripe.com/test_REPLACE_WITH_YOUR_LINK"
+    small: "https://REPLACE_WITH_YOUR_PAYMENT_LINK",
+    medium: "https://REPLACE_WITH_YOUR_PAYMENT_LINK",
+    large: "https://REPLACE_WITH_YOUR_PAYMENT_LINK",
+    custom: "https://REPLACE_WITH_YOUR_PAYMENT_LINK"
   }
   
   # Position of the tip jar button
@@ -50,4 +52,13 @@ RailsTipjar.configure do |config|
   # Tracks: button clicks, modal opens, amount selections, and successful tips
   # Works with Google Analytics 4 and Plausible out of the box
   config.analytics_enabled = false
+  
+  # Customize button colors (hex values)
+  # Default: blue background (#3b82f6) with white text (#ffffff)
+  # config.color = "#3b82f6"
+  # config.text_color = "#ffffff"
+  
+  # Enable pulsing animation on the button
+  # Default: false (no animation)
+  # config.pulse = true
 end

data/lib/rails_tipjar/configuration.rb

@@ -3,7 +3,7 @@ module RailsTipjar
     attr_accessor :payment_links, :position, :icon, :theme, :button_text,
                   :modal_title, :modal_description, :custom_amounts,
                   :button_class, :z_index, :analytics_enabled, :payment_link,
-                  :use_modal
+                  :use_modal, :color, :text_color, :pulse
     
     def initialize
       # Simple mode - just one link
@@ -27,6 +27,9 @@ module RailsTipjar
       @button_class = ""
       @z_index = 1000
       @analytics_enabled = false
+      @color = "#3b82f6" # Default blue color
+      @text_color = "#ffffff" # Default white text color
+      @pulse = false # Default no pulsing animation
     end
     
     def position_classes
@@ -48,7 +51,46 @@ module RailsTipjar
       case @icon
       when :coffee
         '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="w-6 h-6">
-          <path stroke-linecap="round" stroke-linejoin="round" d="M21 8.25c0-2.485-2.099-4.5-4.688-4.5-1.935 0-3.597 1.126-4.312 2.733-.715-1.607-2.377-2.733-4.313-2.733C5.1 3.75 3 5.765 3 8.25v7.5c0 2.485 2.099 4.5 4.688 4.5 1.935 0 3.597-1.126 4.313-2.733.715 1.607 2.377 2.733 4.313 2.733 2.588 0 4.687-2.015 4.687-4.5v-7.5z" />
+          <defs>
+            <style>
+              @keyframes steam1 {
+                0% { opacity: 0; transform: translateY(0) translateX(0); }
+                20% { opacity: 0.8; }
+                50% { opacity: 0.6; transform: translateY(-3px) translateX(1px); }
+                80% { opacity: 0.3; }
+                100% { opacity: 0; transform: translateY(-8px) translateX(-1px); }
+              }
+              @keyframes steam2 {
+                0% { opacity: 0; transform: translateY(0) translateX(0); }
+                15% { opacity: 0.7; }
+                45% { opacity: 0.5; transform: translateY(-4px) translateX(-1px); }
+                75% { opacity: 0.2; }
+                100% { opacity: 0; transform: translateY(-9px) translateX(1px); }
+              }
+              @keyframes steam3 {
+                0% { opacity: 0; transform: translateY(0) translateX(0); }
+                25% { opacity: 0.6; }
+                55% { opacity: 0.4; transform: translateY(-3px) translateX(0.5px); }
+                85% { opacity: 0.1; }
+                100% { opacity: 0; transform: translateY(-7px) translateX(-0.5px); }
+              }
+              .steam1 { animation: steam1 3s ease-out infinite; }
+              .steam2 { animation: steam2 3s ease-out infinite 0.5s; }
+              .steam3 { animation: steam3 3s ease-out infinite 1s; }
+            </style>
+          </defs>
+          <!-- Steam wisps with wavy paths -->
+          <path class="steam1" d="M8 9c0.5-0.5 0.5-1 0-1.5s-0.5-1 0-1.5s0.5-1 0-1.5" stroke-linecap="round" fill="none" opacity="0"/>
+          <path class="steam2" d="M12 8.5c-0.3-0.4 -0.3-0.8 0-1.2s0.3-0.8 0-1.2s-0.3-0.8 0-1.2" stroke-linecap="round" fill="none" opacity="0"/>
+          <path class="steam3" d="M15.5 9c0.4-0.3 0.4-0.7 0-1s-0.4-0.7 0-1s0.4-0.7 0-1" stroke-linecap="round" fill="none" opacity="0"/>
+          <!-- Coffee cup body -->
+          <path stroke-linecap="round" stroke-linejoin="round" d="M6 10h12v7a3 3 0 01-3 3H9a3 3 0 01-3-3v-7z"/>
+          <!-- Cup handle -->
+          <path stroke-linecap="round" stroke-linejoin="round" d="M18 10h1.5a2.5 2.5 0 010 5H18"/>
+          <!-- Saucer -->
+          <path stroke-linecap="round" stroke-linejoin="round" d="M4 20h16"/>
+          <!-- Coffee surface detail -->
+          <path stroke-linecap="round" stroke-linejoin="round" d="M8 12h8" opacity="0.3"/>
         </svg>'
       when :heart
         '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="w-6 h-6">
@@ -64,20 +106,61 @@ module RailsTipjar
         </svg>'
       when :jar
         '<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" class="w-6 h-6">
+          <defs>
+            <style>
+              @keyframes tipjar-coin-drop-new {
+                0% {
+                  transform: translateY(0px);
+                  opacity: 0;
+                }
+                10% {
+                  opacity: 1;
+                  transform: translateY(2px);
+                }
+                30% {
+                  transform: translateY(6px);
+                }
+                50% {
+                  transform: translateY(10px);
+                  opacity: 1;
+                }
+                70% {
+                  transform: translateY(15.5px);
+                  opacity: 1;
+                }
+                75% {
+                  transform: translateY(16.3px);
+                  opacity: 1;
+                }
+                80% {
+                  transform: translateY(15.8px);
+                  opacity: 0.8;
+                }
+                100% {
+                  transform: translateY(16.3px);
+                  opacity: 0;
+                }
+              }
+              .tipjar-coin-drop-new {
+                animation: tipjar-coin-drop-new 2.5s ease-in-out infinite;
+              }
+            </style>
+          </defs>
           <!-- Jar lid -->
-          <rect x="8.5" y="3" width="7" height="1.5" rx="0.25" stroke-linecap="round" stroke-linejoin="round"/>
+          <rect x="9.5" y="3" width="5" height="1" rx="0.25" stroke-linecap="round" stroke-linejoin="round"/>
           <!-- Jar threads/neck -->
-          <path stroke-linecap="round" stroke-linejoin="round" d="M9 4.5v1.5M15 4.5v1.5"/>
-          <!-- Jar body with taper -->
-          <path stroke-linecap="round" stroke-linejoin="round" d="M9 6c0 0 -1 0.5 -1 1.5v11.5a2 2 0 002 2h4a2 2 0 002-2V7.5c0-1 -1-1.5 -1-1.5"/>
-          <!-- Coins at bottom -->
+          <path stroke-linecap="round" stroke-linejoin="round" d="M10 4v0.8M14 4v0.8"/>
+          <!-- Jar body - much fatter with short taper -->
+          <path stroke-linecap="round" stroke-linejoin="round" d="M10 4.8h4M9 5.5c-1 0 -2 0.5 -2 1v12.5a2 2 0 002 2h6a2 2 0 002-2V6.5c0-0.5 -1-1 -2-1"/>
+          <!-- Coins at bottom - pile -->
           <ellipse cx="10.5" cy="18.5" rx="1.5" ry="0.5" stroke-linecap="round"/>
-          <ellipse cx="14" cy="18" rx="1.5" ry="0.5" stroke-linecap="round"/>
-          <ellipse cx="12" cy="17.5" rx="1.5" ry="0.5" stroke-linecap="round"/>
-          <!-- Falling coin -->
-          <g class="tipjar-coin-animation">
-            <ellipse cx="12" cy="10" rx="1.5" ry="0.5" stroke-linecap="round"/>
-            <path stroke-linecap="round" d="M12 10v1.5"/>
+          <ellipse cx="13.5" cy="18.3" rx="1.5" ry="0.5" stroke-linecap="round"/>
+          <ellipse cx="12" cy="17.8" rx="1.5" ry="0.5" stroke-linecap="round"/>
+          <ellipse cx="11" cy="19" rx="1.3" ry="0.4" stroke-linecap="round"/>
+          <ellipse cx="13" cy="19" rx="1.3" ry="0.4" stroke-linecap="round"/>
+          <!-- Falling coin - starts above jar outside -->
+          <g class="tipjar-coin-drop-new">
+            <ellipse cx="12" cy="1.5" rx="1.5" ry="0.5" stroke-linecap="round"/>
           </g>
         </svg>'
       else

data/lib/rails_tipjar/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsTipjar
-  VERSION = "0.2.2"
+  VERSION = "1.0.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_tipjar
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 1.0.0
 platform: ruby
 authors:
 - Justin Paulson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-11 00:00:00.000000000 Z
+date: 2025-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -38,8 +38,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.0'
-description: Easily add a customizable tip jar to any Rails application using Stripe
-  Payment Links
+description: Easily add a customizable tip jar to any Rails application. Works with
+  any payment provider.
 email:
 - justinapaulson@gmail.com
 executables: []