📚 Documentation

🚀 Quick Start Guide

Get your celebration effects up and running in under 5 minutes!

Step 1: Installation

1. Visit the Shopify App Store
2. Click "Add app" and authorize the app
3. You'll be automatically redirected to the CelebrationApp dashboard

Step 2: Choose a Template

Browse 35+ pre-designed templates organized by category:

• Universal: Classic celebration for any store
• Seasonal: Summer, Fall, Spring, Winter themes
• Holidays: Halloween, Valentine's, Easter, Christmas, etc.
• Business Types: Cannabis, Gaming, Luxury, Food, Fitness, Beauty, Fashion, and more
• Sale Events: Black Friday, Cyber Monday, Clearance

Step 3: Configure Triggers

Select when celebrations should appear:

• Add to Cart: When customer adds product to cart (Free plan)
• Checkout: When customer proceeds to checkout (Paid plans)
• Thank You Page: After successful purchase (Paid plans)
• First Visit: Customer's first visit to your store (Paid plans)
• Milestones: Cart reaches $25, $50, $100+ (Paid plans, customizable)
• Quick View: Product quick view opens (Paid plans)

Step 4: Customize (Optional)

Make it your own:

• Adjust colors to match your brand
• Change emojis and messages
• Modify animation speed and intensity
• Choose celebration position (9 positions available)
• Enable/disable sound effects
• Set device-specific settings (mobile vs desktop)

Step 5: Test & Launch

1. Use the live preview in the dashboard
2. Test on your store (add to cart to trigger)
3. Adjust settings as needed
4. Celebrate!

🔧 Installation Methods

Method 1: Theme Extension (Recommended)

For Shopify 2.0 themes (most modern themes):

• Automatic installation via app blocks
• No code changes required
• Easy to enable/disable from Theme Editor
• Works with all Shopify 2.0 themes

Method 2: Automatic Script Tag

For older themes (pre-2.0):

• CelebrationApp automatically injects scripts
• No manual installation needed
• Works with all themes

🎨 Customization Options

Visual Settings

• Delay: 0-5000ms before celebration starts
• Duration: 1-10 seconds celebration length
• Intensity: 0-100% (number of confetti pieces)
• Position: Top-left, top-center, top-right, middle-left, center, middle-right, bottom-left, bottom-center, bottom-right

Audio Settings

• Sounds: Chime, Powerup, Party, Achievement, Milestone
• Volume: 0-100%
• Respect User Preferences: Auto-mute if user has muted their device

Custom Templates (Professional Plan)

Create unlimited custom templates with:

• Custom emojis (any emoji)
• Custom colors (unlimited palette)
• Custom messages (unlimited)
• 25+ animation styles
• Save and reuse across your store

📊 Analytics & A/B Testing

Available on Starter Plan and above

• Celebration Count: Track total celebrations fired
• Conversion Rate: Measure impact on purchases
• Revenue Attribution: See revenue generated from celebrations
• Template Performance: Compare different templates
• A/B Testing: Test variations and see statistical winners

Setting Up A/B Tests

1. Go to Analytics → A/B Tests
2. Create new test
3. Choose variants (Template A vs Template B)
4. Set traffic split (50/50 recommended)
5. Launch test
6. Wait for statistical significance
7. Implement winning variant

🔌 API Access (Professional & Unlimited Plans)

API Endpoints

Access our REST API for custom integrations:

GET /api/settings/:shop
POST /api/celebrations/trigger
GET /api/analytics/:shop
POST /api/templates/custom

Authentication

API requests require your API key from the dashboard Settings page.

🔍 Troubleshooting

Celebrations not appearing?

• Check that the app is enabled in your dashboard
• Verify you haven't exceeded your monthly limit
• Clear your browser cache
• Check browser console for JavaScript errors
• Ensure ad blockers aren't interfering

Performance issues?

• Lower intensity setting (50-60% recommended)
• Reduce duration (2-3 seconds optimal)
• Enable "Disable on slow devices" setting
• Use mobile-optimized settings

Need more help?

Contact us at info@celebrationapp.pro
Professional & Unlimited plans get priority 24/7 support!

✨ Best Practices

Trigger Selection

• E-commerce stores: Add-to-cart + Thank You Page
• High-ticket items: Checkout + Milestones
• First-time buyers: First Visit + Purchase
• Flash sales: Use Black Friday or Clearance templates

Template Selection

• Match template to your brand and industry
• Use seasonal templates during relevant periods
• A/B test 2-3 templates to find what resonates
• Keep it fun but not overwhelming

Customization Tips

• Use brand colors for consistency
• Keep messages short and exciting (3-5 words)
• Lower mobile intensity (50% vs 75% desktop)
• Test on actual devices before launching