Filament Tinyeditor Laravel Package

Product Decisions This Supports

• Enhancing Content Management Workflows:

  • Enable rich-text editing for admin panels (e.g., blog posts, CMS pages, or product descriptions) without requiring external tools like WordPress or dedicated CMS platforms.
  • Replace or augment existing textarea fields with a user-friendly, feature-rich editor (e.g., for marketing teams, editors, or non-technical stakeholders).

• Roadmap Priorities:

  • Phase 1: Integrate into core admin panels for content-heavy models (e.g., Post, Page, FAQ).
  • Phase 2: Extend to user-generated content (e.g., forum posts, comments) if the app supports community features.
  • Phase 3: Customize editor profiles for role-based access (e.g., "Basic" for users, "Advanced" for admins).

• Build vs. Buy:

  • Buy: Avoid reinventing TinyMCE integration for Filament (saves ~3–6 weeks of dev time). The package handles:
    • Asset publishing (JS/CSS).
    • File uploads (images/media).
    • RTL/LTR support.
    • Preconfigured toolbars (reduces frontend dev effort).
  • Build: Only if needing highly specialized TinyMCE features (e.g., custom plugins) not covered by the package’s profiles.

• Use Cases:

  • Internal Tools: Admin dashboards where content formatting is critical (e.g., newsletters, documentation).
  • Customer-Facing Apps: If your product includes a "rich-text" requirement (e.g., SaaS platforms with customizable templates).
  • Localization: RTL support for Arabic/Hebrew content without manual CSS hacks.

When to Consider This Package

Adopt If:

• Your tech stack includes:
  • Laravel 10+ (or 11/12 for v5.x).
  • Filament 3.x–5.x (version-compatible).
  • PHP 8.1+ (8.2+ for v4.x/5.x).
• You need TinyMCE’s features but want to avoid:
  • Manual TinyMCE setup (CDN/JS config).
  • Conflicts with Filament’s modal system.
  • Reinventing file uploads/media handling.
• Your content editors require:
  • Tables, emojis, code blocks, or advanced formatting.
  • Mobile-friendly editing (TinyMCE’s responsive design).
• You’re already using Filament and want consistency in the admin UI.

Look Elsewhere If:

• You need real-time collaboration (TinyMCE’s free tier lacks this; consider Tiny Cloud or CKEditor).
• Your app requires offline editing (TinyMCE’s cloud dependency may block this).
• You’re on Filament v2 or Laravel <10 (no support).
• You need custom TinyMCE plugins beyond the package’s external_plugins feature (may require forking).
• Cost is a blocker: TinyMCE’s free license has usage limits (e.g., 20M page views/month). For higher volumes, purchase a commercial license.
• You prefer Markdown over WYSIWYG (consider Filament Markdown or Laravel Markdown).

How to Pitch It (Stakeholders)

For Executives:

*"This package lets us embed a professional-grade rich-text editor (TinyMCE) into our Filament admin panels with minimal dev effort. For example, our marketing team can now format blog posts directly in the dashboard—no more exporting to WordPress or dealing with clunky textareas. It’s a drop-in solution that:

• Saves time: Avoids 3–6 weeks of custom TinyMCE integration.
• Improves UX: Gives non-technical users tables, emojis, and media uploads.
• Scales: Supports RTL languages and role-based editor profiles.
• Cost-effective: Uses TinyMCE’s free tier (unless we hit usage limits, which we won’t for [X] users). Ask: Approve a 1-hour spike to test integration with our Post model. If successful, we’ll roll it out to [Y] content-heavy features by [date]."*

For Engineering:

*"This is a Filament-native TinyMCE wrapper that handles:

• Asset management: Publishes TinyMCE JS/CSS automatically.
• File uploads: Configurable disk/directory for media (e.g., public/uploads).
• Toolbars: Predefined profiles (simple, full, minimal) or custom configs.
• RTL/LTR: Built-in support for Arabic/Hebrew content. Why use it?
• No TinyMCE setup: Just composer require and php artisan vendor:publish.
• Filament-compatible: Works with Livewire 3 and Filament’s modal system.
• Extensible: Add custom plugins via external_plugins config. Trade-offs:
• TinyMCE’s free license has usage limits (track [X]).
• No real-time collaboration (but we can upgrade to Tiny Cloud later). Proposal: Test in a Post resource this sprint. If stable, prioritize for [Y] models next."*

For Design/UX:

*"This replaces basic textareas with a modern, mobile-friendly editor that:

• Matches Filament’s UI (no jarring visual breaks).
• Includes emojis, tables, and media uploads out of the box.
• Supports RTL languages without extra CSS. Example: Instead of this: Users get this: Ask: Review the editor’s toolbar profiles (simple/full) to align with our content guidelines."*