Filament Tour Laravel Package

Product Decisions This Supports

• Onboarding & User Adoption: Accelerate feature discovery for complex admin panels (Filament) by integrating guided tours, reducing friction for new users and power users alike.
• Self-Service Documentation: Replace static docs or in-app tooltips with interactive walkthroughs, lowering support burden for internal tools or SaaS products.
• A/B Testing & Feature Rollouts: Use tours to highlight new features (e.g., "Try our new analytics dashboard!") without disrupting existing workflows.
• Build vs. Buy: Avoid custom development of tour systems (e.g., combining DriverJS + Filament hooks) by leveraging a battle-tested, low-maintenance package.
• Compliance & Training: Guide users through mandatory workflows (e.g., "Complete this setup tour to enable billing").
• Roadmap Prioritization: Justify investment in Filament-based admin panels by demonstrating how tours can improve usability metrics (e.g., task completion rates).

When to Consider This Package

• Adopt When:

  • Your Filament admin panel has critical user flows that require guided discovery (e.g., onboarding, feature highlights).
  • You need low-code tour creation without deep frontend expertise (DriverJS integration abstracted via PHP).
  • Your team prioritizes user experience over custom UI development for tours.
  • You’re using Filament v2/v3/v4 and want version-specific compatibility.
  • You need localStorage persistence to track tour completion per user (configurable via PHP).

• Look Elsewhere If:

  • You require highly customized animations (DriverJS is opinionated; this package wraps it tightly).
  • Your tours need multi-step conditional logic (e.g., "Show Step 2 only if user X clicked Button A").
  • You’re not using Filament (package is tightly coupled to Filament panels).
  • You need analytics tracking for tour interactions (would require custom integration).
  • Your users expect mobile-first tours (DriverJS has limited mobile support; test responsiveness).

How to Pitch It (Stakeholders)

For Executives:

*"This package lets us add interactive, guided tours to our Filament admin panel with minimal dev effort—think of it as a ‘Clippy for modern admin UIs.’ For $0 in custom development, we can:

• Reduce onboarding time by 30%+ with step-by-step walkthroughs (e.g., ‘How to create your first report’).
• Drive feature adoption by highlighting new tools (e.g., ‘Discover our AI assistant’).
• Cut support costs by replacing ‘How do I…?’ tickets with self-service guides. It’s like adding a ‘tour mode’ to our admin panel with one line of PHP code. We’ve seen tools like this improve user activation by 20% in similar products."*

For Engineering:

*"This is a lightweight wrapper for DriverJS that plugs into Filament panels. Key benefits:

• Zero frontend work: Configure tours entirely in PHP (e.g., FilamentTourPlugin::make()).
• Filament-native: Works seamlessly with Filament’s panel system (no iframe hacks or iframes).
• Configurable: Toggle only_visible_once, customize selectors, and control production behavior via PHP.
• MIT licensed: No legal risk; easy to fork if needed. Tradeoff: Limited to DriverJS’s capabilities (e.g., no advanced branching logic), but saves ~10–20 hours of custom dev time. Ideal for MVP tours or quick feature rollouts."*

For Design/Product:

*"This solves a common pain point: users ignore tooltips but engage with guided tours. With this, we can:

• Highlight key actions (e.g., ‘Click here to export your data’) without cluttering the UI.
• Test new flows (e.g., ‘Try our beta feature’) without permanent UI changes.
• A/B test tour paths (e.g., ‘Show Path A to 50% of users’). Example use case: A 3-step tour for new hires to set up their profile, connect integrations, and run their first report—all triggered on first login."*