- Can I use Slidewire in a Laravel app without Livewire? What’s the upgrade path?
- Slidewire requires Livewire as a hard dependency. If you’re not using Livewire yet, you’ll need to install it first (`composer require livewire/livewire`). The upgrade path is straightforward: start by migrating one or two components to Livewire, then adopt Slidewire. For Inertia.js users, Slidewire can coexist but may require custom logic to bridge state management.
- How do I install Slidewire in Laravel 10+? Are there breaking changes from older versions?
- Installation is simple: run `composer require wendelladriel/slidewire`. Slidewire targets Laravel 10+ and Livewire 3.x. If you’re using older versions (e.g., Livewire 2.x), you’ll need to upgrade first or risk compatibility issues. The package includes a `slidewire:install` Artisan command to set up configurations automatically.
- Does Slidewire support Markdown for slides? How about syntax highlighting for code blocks?
- Yes, Slidewire natively supports Markdown for slides, including code blocks with syntax highlighting via Phiki. It also integrates with Laravel’s Blade templating, so you can mix Markdown with dynamic Blade components. Themes can be customized to match your IDE’s syntax highlighting colors for consistency.
- Can I create dynamic presentations (e.g., user-specific dashboards) with Slidewire?
- Absolutely. Slidewire leverages Livewire’s reactivity, so you can bind slides to user data, real-time updates, or database queries. For complex dynamic content, use `wire:model` or `wire:ignore` to optimize performance. However, unbounded datasets may require server-side pagination or lazy-loading to avoid memory issues.
- How does Slidewire handle navigation? Does it support deep-linking to specific slides?
- Slidewire offers multiple navigation methods: keyboard arrows, click controls, swipe gestures, and hash-based deep-linking (e.g., `/presentation#slide-3`). It integrates with Laravel’s routing system, so you can generate slide URLs dynamically. Auto-slide timers are configurable per deck or slide for timed presentations.
- Will Slidewire work with my existing Tailwind/Bootstrap theme? How do I customize it?
- Slidewire extends Laravel’s config system for themes, so you can override defaults via `config/slidewire.php` or Blade directives. For Tailwind/Bootstrap, use `@stack` directives or CSS overrides to align with your design system. The package includes structured theme presets for typography, colors, and transitions.
- Does Slidewire support Playwright testing? How do I set it up in GitHub Actions?
- Yes, Slidewire uses Playwright for browser testing. To integrate with GitHub Actions, add Chromium binaries to your workflow and configure Playwright’s `playwright-test` task. If you’re using Pest or Laravel Dusk, you can reuse existing test infrastructure with minimal adjustments for Slidewire’s Livewire components.
- Are there performance concerns for large presentations (e.g., 100+ slides)?
- Slidewire can handle large decks, but memory usage may increase with complex Livewire components. Mitigate this by using `wire:ignore` for static slides or lazy-loading content. Blade preprocessing (e.g., syntax highlighting) adds CPU load, so optimize for high-traffic apps by caching compiled slides or using server-side rendering.
- Can Slidewire be used for public-facing documentation or SEO-sensitive content?
- Slidewire lacks built-in SEO meta tags or ARIA labels, so you’ll need to extend Blade templates manually for public content. For accessibility, add custom ARIA attributes or use Laravel’s Blade directives. Consider pairing it with Laravel’s SEO packages (e.g., `spatie/laravel-seo-toolkit`) for dynamic meta tags.
- What are the alternatives to Slidewire for Laravel presentations? When should I choose another?
- Alternatives include Reveal.js (static HTML/CSS) or custom Livewire components with Alpine.js. Choose Slidewire if you want a Livewire-first solution with Blade integration and minimal frontend setup. Opt for Reveal.js if you need broader browser support or offline PWA features, or use Alpine.js for lightweight interactivity without Livewire’s overhead.