Calendar Links Laravel Package

Product Decisions This Supports

• Feature Development: Enable seamless calendar integrations for event-based products (e.g., scheduling tools, booking systems, or event management platforms). Reduces friction for users adding events to their calendars (Google, Outlook, iCal, etc.).
• Roadmap Prioritization: Justifies investment in calendar-related features if user adoption of scheduling tools is a priority. Aligns with trends toward embedded workflows (e.g., "Add to Calendar" buttons in SaaS products).
• Build vs. Buy: Eliminates the need to build custom calendar link generators, saving engineering time. The package is lightweight, well-maintained, and supports multiple providers out-of-the-box.
• Use Cases:
  • Event Platforms: Automatically generate calendar links for conferences, webinars, or classes.
  • Booking Systems: Let users block time in their calendars for appointments (e.g., healthcare, salons).
  • E-commerce: Add "Buy + Schedule" flows (e.g., booking a product delivery or service).
  • Marketing Campaigns: Embed calendar links in emails or landing pages for promotions (e.g., "Add this webinar to your calendar").
  • Internal Tools: Streamline internal scheduling (e.g., team meetings, HR events).

When to Consider This Package

Adopt this package if:

• Your product requires one-click calendar integration for events, and you need support for Google, Outlook (web/Office365), Yahoo, and iCal.
• You want to avoid reinventing the wheel—the package handles edge cases (timezones, all-day events, special characters, RFC 5545 compliance for ICS).
• Your team lacks bandwidth to maintain a custom solution, or you prioritize speed of implementation over full control.
• You need lightweight dependencies (no heavy external services; works purely in PHP).
• Your users are B2B or B2C and expect calendar integrations (e.g., SaaS, e-commerce, or event-driven platforms).

Look elsewhere if:

• You need deep customization beyond standard calendar providers (e.g., proprietary calendar systems).
• Your events require complex recurring patterns not natively supported (though the package allows custom generators).
• You’re building a mobile app where deep-linking to native calendar apps is preferred (this package generates web links).
• Your stack doesn’t use PHP/Laravel, or you need multi-language support (the package is PHP-first).
• You require real-time sync with calendars (this generates static links/ICS files, not live updates).

How to Pitch It (Stakeholders)

For Executives: "This package lets us add ‘Add to Calendar’ functionality to our product with minimal engineering effort. For example, if we’re launching a booking system or event platform, users can instantly save events to their Google/Outlook calendars with a single click—reducing no-shows and improving conversions. It’s a lightweight, battle-tested solution used by 1,000+ other projects, with support for all major calendar providers. The cost? Zero—it’s open-source and MIT-licensed. The benefit? A seamless user experience that competitors may lack."

Key Metrics to Highlight:

• User Engagement: Fewer dropped events due to manual calendar entry.
• Conversion Lift: Higher sign-ups/bookings when scheduling is frictionless.
• Developer Velocity: Days/weeks saved vs. building a custom solution.

For Engineering: *"This is a drop-in Laravel package that generates compliant calendar links for Google, Outlook (web/Office365), Yahoo, and iCal. It handles edge cases like timezones, all-day events, and special characters automatically. Here’s how we’d use it:

1. Install: composer require spatie/calendar-links.
2. Generate Links: Create events with start/end times, then call methods like $link->google() or $link->ics().
3. Embed: Add links to buttons or emails (e.g., ‘Add to Google Calendar’).

• Pros: No external APIs, fast, supports custom generators, and is actively maintained (PHP 8.3+).
• Cons: Limited to web links (not native app deep links), but covers 90% of use cases.
• Alternatives: Building this in-house would take 2–4 weeks; this takes hours. Other packages either lack provider support or are abandoned."*

For Design/Product: *"This enables us to add ‘Add to Calendar’ buttons without relying on third-party widgets (e.g., Google’s official button, which has tracking/branding constraints). We can style it to match our UI and ensure it works offline (via ICS files). For example:

• Webinars: Users can block time in their calendars before signing up.
• Appointments: Reduce no-shows by letting users confirm slots instantly.
• Events: Increase attendance by making RSVPing effortless. The package even supports custom reminders and descriptions, so we can tailor the experience."*