MagicDX

Theme

Getting Started with MagicDX ​

Welcome to MagicDX! This guide will help you get started with our premium Strapi v5 plugins.

What is MagicDX? ​

MagicDX is a collection of premium Strapi v5 plugins designed to solve common challenges in modern web applications:

PluginPurpose
📧 Magic-MailProfessional email management with multi-provider support
🔗 Magic-LinkPasswordless authentication with MFA support
🔐 Magic-SessionmanagerUser session tracking and control
✏️ Magic-Editor-XBlock-based rich text editor with real-time collaboration
🔖 Magic-MarkQuery bookmarking for Content Manager

📋 Requirements ​

Before installing any MagicDX plugin, ensure you have:

  • ✅ Node.js 18.x - 22.x
  • ✅ Strapi v5 (v5.0.0 or higher)
  • ✅ npm or yarn package manager
  • ✅ Database (SQLite, PostgreSQL, MySQL, or MariaDB)

Quick Start ​

Step 1: Install a Plugin ​

Choose and install the plugin you need:

bash
npm install strapi-plugin-magic-mail
bash
npm install strapi-plugin-magic-link-v5
bash
npm install strapi-plugin-magic-sessionmanager
bash
npm install magic-editor-x
bash
npm install strapi-plugin-magic-mark

Step 2: Enable in Config ​

Add to your config/plugins.ts (or plugins.js):

typescript
export default () => ({
  // Enable the plugins you need
  'magic-mail': {
    enabled: true,
  },
  'magic-link': {
    enabled: true,
  },
  'magic-sessionmanager': {
    enabled: true,
  },
  'magic-editor-x': {
    enabled: true,
  },
  'magic-mark': {
    enabled: true,
  },
});

Step 3: Rebuild & Start ​

bash
# Rebuild the admin panel
npm run build

# Start in development mode
npm run develop

Step 4: Activate License ​

  1. Open your Strapi admin panel
  2. Navigate to the plugin in the sidebar
  3. Click "Activate License"
  4. Enter your details or license key
  5. Done! 🎉

FREE ACTIVATION

Free tier activation is completely free and requires no payment. It helps us track installations and provide support.

📦 Installing Multiple Plugins ​

MagicDX plugins work perfectly together. Install all of them for a complete solution:

bash
# Install all MagicDX plugins
npm install strapi-plugin-magic-mail strapi-plugin-magic-link-v5 strapi-plugin-magic-sessionmanager magic-editor-x strapi-plugin-magic-mark

Configure in config/plugins.ts:

typescript
export default () => ({
  // Email management - handles all email sending
  'magic-mail': {
    enabled: true,
  },
  
  // Passwordless auth - uses Magic-Mail for sending
  'magic-link': {
    enabled: true,
  },
  
  // Session tracking - monitors authenticated users
  'magic-sessionmanager': {
    enabled: true,
  },
  
  // Block-based rich text editor with collaboration
  'magic-editor-x': {
    enabled: true,
  },
  
  // Query bookmarks - organizes your workflow
  'magic-mark': {
    enabled: true,
  },
});

🔑 License Activation ​

All MagicDX plugins require license activation to function. This is a simple, one-time process.

Activation Options ​

  1. Auto-Create License (Recommended)

    • Enter your name and email
    • License is created automatically
    • Works for Free tier

  2. Enter License Key

    • Use a key from your store account
    • Required for Premium and Advanced tiers

  3. Existing Key

    • Reuse a key from another installation
    • Same organization only

Activation Process ​

  1. Navigate to the plugin in Strapi admin
  2. You'll see the License Activation modal
  3. Choose your activation method
  4. Enter required information
  5. Click "Activate"
  6. Plugin features are now unlocked!

IMPORTANT

The license validation system must remain intact. Tampering with license validation violates our Terms of Service.

🌍 Supported Languages ​

All MagicDX plugins support 5 languages:

  • 🇬🇧 English (default)
  • 🇩🇪 Deutsch (German)
  • 🇫🇷 Français (French)
  • 🇪🇸 Español (Spanish)
  • 🇵🇹 Português (Portuguese)

The language follows your Strapi admin interface setting.

📖 Next Steps ​

Now that you're set up, explore each plugin:

🆘 Need Help? ​