strapi-content-sync-pro 1.0.1 → 1.0.3

package/README.md

@@ -1,4 +1,8 @@
-# Content Sync Pro Plugin for Strapi
+# Content Sync Pro Plugin for Strapi
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/logo-horizontal.svg" alt="Content Sync Pro" width="720" />
+</p>
 
 A powerful Strapi v5 plugin to copy, migrate, and live-sync content, media, and data between multiple Strapi environments.
 
@@ -10,7 +14,7 @@ A powerful Strapi v5 plugin to copy, migrate, and live-sync content, media, and
 Plugin intro: https://youtu.be/hr3dD6dLgLQ
 
 <a href="https://youtu.be/hr3dD6dLgLQ" target="_blank" rel="noopener noreferrer">
-  <img src="docs/Screenshot%202026-04-20%20160506.png" alt="Content Sync Pro — watch the intro video" width="100%" />
+  <img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20160506.png" alt="Content Sync Pro — watch the intro video" width="100%" />
 </a>
 
 ## Screenshots
@@ -22,41 +26,44 @@ Plugin intro: https://youtu.be/hr3dD6dLgLQ
 
   <table>
     <tr>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20160506.png" alt="Content Sync Pro - screenshot 1" width="100%" /></td>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20160558.png" alt="Content Sync Pro - screenshot 2" width="100%" /></td>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20175903.png" alt="Content Sync Pro - screenshot 3" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20160506.png" alt="Content Sync Pro - screenshot 1" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20160558.png" alt="Content Sync Pro - screenshot 2" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20175903.png" alt="Content Sync Pro - screenshot 3" width="100%" /></td>
     </tr>
     <tr>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20175931.png" alt="Content Sync Pro - screenshot 4" width="100%" /></td>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20180001.png" alt="Content Sync Pro - screenshot 5" width="100%" /></td>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20180041.png" alt="Content Sync Pro - screenshot 6" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20175931.png" alt="Content Sync Pro - screenshot 4" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20180001.png" alt="Content Sync Pro - screenshot 5" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20180041.png" alt="Content Sync Pro - screenshot 6" width="100%" /></td>
     </tr>
     <tr>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20180116.png" alt="Content Sync Pro - screenshot 7" width="100%" /></td>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20180135.png" alt="Content Sync Pro - screenshot 8" width="100%" /></td>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20180202.png" alt="Content Sync Pro - screenshot 9" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20180116.png" alt="Content Sync Pro - screenshot 7" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20180135.png" alt="Content Sync Pro - screenshot 8" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20180202.png" alt="Content Sync Pro - screenshot 9" width="100%" /></td>
     </tr>
     <tr>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20180228.png" alt="Content Sync Pro - screenshot 10" width="100%" /></td>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20180251.png" alt="Content Sync Pro - screenshot 11" width="100%" /></td>
-      <td width="33%"><img src="docs/Screenshot%202026-04-20%20180301.png" alt="Content Sync Pro - screenshot 12" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20180228.png" alt="Content Sync Pro - screenshot 10" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20180251.png" alt="Content Sync Pro - screenshot 11" width="100%" /></td>
+      <td width="33%"><img src="https://raw.githubusercontent.com/eharain/strapi-content-sync-pro/master/docs/Screenshot%202026-04-20%20180301.png" alt="Content Sync Pro - screenshot 12" width="100%" /></td>
     </tr>
   </table>
 </details>
 
 ## Features
 
-- **Bi-directional Content Sync** - Push, pull, or sync both ways (Local wins, Remote wins, or Latest wins).
+- **Deployment Modes** - Paired mode (plugin on both servers) or Single-side mode (plugin only on local server).
+- **Bi-directional Content Sync** - Push, pull, or sync both ways (Local wins, Remote wins, or Latest wins) in paired mode.
 - **Media Sync** - Full media synchronization via HTTP (URL-based) or host-level file copy (`rsync`). Includes MIME type filtering and concurrency controls.
 - **Sync Profiles** - Define WHAT to sync with field-level control (Advanced mode) or preset modes.
-- **Execution Modes** - On-demand, Scheduled (interval, timeout, cron, or external scheduler), or Live (real-time) sync.
+- **Execution Modes** - On-demand, Scheduled (interval, timeout, cron, or external scheduler), Live (real-time), with per-profile execution controls.
 - **Pagination & Large Dataset Support** - Built-in pagination ensures stable memory usage even when syncing thousands of records.
 - **Dependency Analytics** - Automatically detects and syncs related entities and components in the correct order.
 - **Enforcement Checks** - Pre-sync schema compatibility validation, version checks, and server time drift checks.
 - **Alerts & Logging** - Detailed sync logs. Receive success/failure alerts via Email (using Strapi's email provider) or Webhooks.
+- **Stats & Run Reports** - Local/remote counts and newest timestamps per content type, with before/after snapshots for each sync run.
+- **Retention Controls** - Manual clear and automatic retention limits for logs and run reports.
 - **Secure Communication** - API token authentication combined with HMAC-SHA256 request signing using a shared secret.
 
-## Installation
+## Prerequisites
 
 - Strapi v5.0.0 or higher
 - Node.js 20.0.0 or higher
@@ -100,20 +107,29 @@ npm run develop
 2. Go to **Configuration** tab
 3. Enter your remote server details:
    - **Base URL**: The remote Strapi instance URL (e.g., `https://api.example.com`)
-   - **API Token**: Generate from remote Strapi's Settings → API Tokens
+   - **API Token**: Generate from remote Strapi's Settings ? API Tokens
    - **Instance ID**: Unique identifier for this instance
    - **Shared Secret**: Same secret on both instances for HMAC signing
 
 ## Quick Start
 
-### Step 1: Configure Connection
-In the **Configuration** tab, set up the remote server connection.
+### Step 1: Choose Deployment Mode and Configure Connection
+In **Configuration**, choose one mode:
+- **Paired**: install and enable plugin on both local and remote servers.
+- **Single-side**: install plugin only on local server (remote plugin routes not required).
+
+Then configure Base URL, API Token, Instance ID, and Shared Secret.
 
 ### Step 2: Enable Content Types
 In the **Content Types** tab, toggle on the content types you want to sync. Default profiles are auto-generated.
 
-### Step 3: Run Sync
-In the **Sync** tab, click "Sync All Active Profiles" or run individual profiles.
+### Step 3: Align Sync Settings on Both Servers
+In **Content Types**, enable matching content types on both servers.
+In **Sync Profiles**, set compatible direction/conflict strategy.
+Then in **Sync**, configure execution mode and global page size.
+
+### Step 4: Run Sync
+In the **Sync** tab, click **Sync All Active Profiles** or run individual profiles.
 
 ## Sync Profiles
 
@@ -131,6 +147,20 @@ Configure individual field policies:
 - **Pull** - Field only pulls from remote
 - **Exclude** - Field is never synced
 
+## Deployment Modes
+
+### Paired mode
+- Plugin installed on both local and remote servers.
+- Supports push, pull, and bidirectional profiles.
+- Supports on-demand, scheduled, and live execution modes.
+- Connection test validates remote plugin endpoints.
+
+### Single-side mode
+- Plugin installed on local server only.
+- Pull-only profiles are enforced.
+- Live execution is disabled (use on-demand or scheduled).
+- Connection test validates remote reachability and API token access without requiring remote plugin routes.
+
 ## Execution Modes
 
 Configure **when** sync runs in the Sync tab:
@@ -158,6 +188,7 @@ Full media synchronization between Strapi instances:
 - **rsync Strategy** — Host-level file copy using the `rsync` binary. Fastest for local-provider setups with SSH access.
 - **Profile-based** — Create media sync profiles with direction, conflict strategy, MIME filters, filename patterns, and execution settings.
 - **DB + File Sync** — Syncs both the `plugin::upload.file` database rows and the actual file bytes.
+- **Morph Link Remapping** — Syncs `files_related_morphs` links by mapping file + related entities through documentId, then remapping to local numeric ids before insert.
 
 ## Enforcement
 
@@ -211,6 +242,24 @@ Sync products from a central catalog to multiple storefronts:
    - Create "Full Pull" profile for `api::product.product`
    - Set execution mode to "Scheduled" (every 5 minutes)
 
+## Stats & Data Management
+
+The **Stats** tab is split into two sub-tabs:
+
+**Current Snapshot** — live local vs remote state per content type:
+- Local vs remote record count
+- Media files and media morph stats (local, plus remote where available)
+- Newest record timestamp on each side and which side is newest (local, remote, equal)
+- Search by UID, filter by type (content / media / media morph) or newest side, and paginate large result sets
+
+**Run Reports** — before/after snapshots captured for each sync run:
+- Filter by status (all / success / failed) and paginate server-side
+- Expand any report to see the before and after row tables
+
+A top action row (shared by both sub-tabs) provides:
+- **Refresh Stats**, **Clear Logs**, **Clear Stats Reports**
+- **Max Logs** / **Max Reports** retention limits with **Save & Apply Retention** (also enforced automatically after each sync run)
+
 ## Troubleshooting
 
 ### Common Issues
@@ -218,8 +267,10 @@ Sync products from a central catalog to multiple storefronts:
 | Error | Solution |
 |-------|----------|
 | "Remote server not configured" | Add Base URL and API Token in Configuration |
-| "401 Unauthorized" | Regenerate API token on remote server |
-| "HMAC verification failed" | Ensure shared secret matches on both instances |
+| "401 Unauthorized / 403 Forbidden" | Regenerate API token and verify required permissions for synced content types (and Upload permissions for media) |
+| "HMAC verification failed" | Ensure shared secret matches on both instances in paired mode |
+| "Content type endpoint not found" | In paired mode, ensure matching content-type definitions and enabled API routes on both instances |
+| "Live mode not available" | Switch to paired mode, or use on-demand/scheduled in single-side mode |
 | "Schema mismatch" | Sync content type schemas or set enforcement to "compatible" |
 
 ### Viewing Logs
@@ -230,6 +281,14 @@ Check the **Logs** tab for detailed sync history including:
 - Direction (push/pull)
 - Status and error messages
 
+## Security & Privacy
+
+- **No usage tracking.** This plugin does not collect, transmit, or store any analytics or telemetry data.
+- **Credential handling.** The optional "Generate Token" feature lets you authenticate to **your own** remote Strapi server to create an API token. Credentials are sent directly from your browser to your server via the plugin's backend proxy, used once, and **never stored** on disk, in the database, or in memory after the request completes.
+- **API Tokens** are encrypted at rest using Strapi's built-in store.
+- **HMAC-SHA256** signatures protect all inter-instance requests from tampering.
+- **Masked secrets** — API tokens and shared secrets are masked (`••••••••`) in all API responses.
+
 ## Contributing
 
 Contributions are welcome! Please open an issue or submit a pull request.
@@ -242,4 +301,4 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 **Ejaz Husain Arain**
 - GitHub: [@eharain](https://github.com/eharain)
-- Email: eharain@yahoo.com
+- Email: eharain@yahoo.com

package/admin/src/components/ConfigTab.jsx

@@ -30,6 +30,7 @@ const ConfigTab = () => {
         apiToken: '',
         instanceId: '',
         sharedSecret: '',
+        syncMode: 'paired',
     });
 
     // Login modal state
@@ -131,6 +132,7 @@ const ConfigTab = () => {
             if (config.apiToken && config.apiToken !== '••••••••') payload.apiToken = config.apiToken;
             if (config.instanceId) payload.instanceId = config.instanceId;
             if (config.sharedSecret && config.sharedSecret !== '••••••••') payload.sharedSecret = config.sharedSecret;
+            if (config.syncMode) payload.syncMode = config.syncMode;
 
             await post(`/${PLUGIN_ID}/config`, payload);
             setMessage({ type: 'success', text: 'Connection configuration saved' });
@@ -349,6 +351,11 @@ const ConfigTab = () => {
                     {/* Connection Tab */}
                     <Tabs.Content value="connection">
                         <Box>
+                            <Box paddingBottom={4}>
+                                <Alert variant="info" title="Deployment mode">
+                                    In <strong>Paired</strong> mode, install Content Sync Pro on both local and remote servers. In <strong>Single-side</strong> mode, install on local only; remote plugin routes are not required. Connection test behavior and allowed sync/execution options follow the selected mode.
+                                </Alert>
+                            </Box>
                             <Flex gap={6}>
                                 {/* LEFT COLUMN: Remote Server */}
                                 <Box flex="1">
@@ -362,7 +369,7 @@ const ConfigTab = () => {
                                                 value={config.baseUrl}
                                                 onChange={(e) => setConfig((p) => ({ ...p, baseUrl: e.target.value }))}
                                             />
-                                            <Field.Hint>URL of the Strapi server to sync with</Field.Hint>
+                                            <Field.Hint>URL of the remote Strapi server where this plugin is also installed</Field.Hint>
                                         </Field.Root>
 
                                         <Field.Root>
@@ -378,7 +385,7 @@ const ConfigTab = () => {
                                                 </Box>
 
                                             </Flex>
-                                            <Field.Hint>Full Access token from the remote server</Field.Hint>
+                                            <Field.Hint>Remote API token with permissions for this plugin routes and synced content types</Field.Hint>
                                         </Field.Root>
                                         <Field.Root>
                                             <Button
@@ -404,7 +411,7 @@ const ConfigTab = () => {
                                                 value={config.instanceId}
                                                 onChange={(e) => setConfig((p) => ({ ...p, instanceId: e.target.value }))}
                                             />
-                                            <Field.Hint>Name to identify this server in logs</Field.Hint>
+                                            <Field.Hint>Unique local instance name used in logs and sync traceability</Field.Hint>
                                         </Field.Root>
 
                                         <Field.Root>
@@ -415,7 +422,21 @@ const ConfigTab = () => {
                                                 value={config.sharedSecret}
                                                 onChange={(e) => setConfig((p) => ({ ...p, sharedSecret: e.target.value }))}
                                             />
-                                            <Field.Hint>Must match on both servers</Field.Hint>
+                                            <Field.Hint>Must match exactly on both local and remote plugin configurations</Field.Hint>
+                                        </Field.Root>
+
+                                        <Field.Root>
+                                            <Field.Label>Sync Mode</Field.Label>
+                                            <SingleSelect
+                                                value={config.syncMode || 'paired'}
+                                                onChange={(value) => setConfig((p) => ({ ...p, syncMode: value }))}
+                                            >
+                                                <SingleSelectOption value="paired">Paired (plugin on both servers)</SingleSelectOption>
+                                                <SingleSelectOption value="single_side">Single-side (plugin only on local)</SingleSelectOption>
+                                            </SingleSelect>
+                                            <Field.Hint>
+                                                Paired mode supports push/pull/bidirectional and remote plugin validation. Single-side mode is pull-focused and does not require plugin routes on remote.
+                                            </Field.Hint>
                                         </Field.Root>
                                     </Flex>
                                 </Box>
@@ -476,9 +497,11 @@ const ConfigTab = () => {
                                         <Modal.Title>Generate API Token</Modal.Title>
                                     </Modal.Header>
                                     <Modal.Body>
-                                        <Typography variant="omega" textColor="neutral600" paddingBottom={4}>
+                                        <Typography variant="omega" textColor="neutral600" paddingBottom={2}>
                                             Log in to <strong>{config.baseUrl}</strong> to automatically create an API token.
-                                            Your credentials are not stored.
+                                        </Typography>
+                                        <Typography variant="pi" textColor="neutral500" paddingBottom={4}>
+                                            Your credentials are sent directly to your remote server, used once to create a token, and never stored on disk, in the database, or in memory.
                                         </Typography>
 
                                         <Flex direction="column" gap={4}>

package/admin/src/components/HelpTab.jsx

@@ -1,7 +1,7 @@
 import { Box, Typography, Tabs, Divider } from '@strapi/design-system';
 
-const INTRO_VIDEO_URL = 'https://youtu.be/hr3dD6dLgLQ';
-const INTRO_VIDEO_EMBED_URL = 'https://www.youtube.com/embed/hr3dD6dLgLQ';
+const INTRO_VIDEO_URL = 'https://www.youtube.com/watch?v=hr3dD6dLgLQ';
+const INTRO_VIDEO_THUMBNAIL = 'https://img.youtube.com/vi/hr3dD6dLgLQ/hqdefault.jpg';
 
 const HelpSection = ({ title, children }) => (
   <Box paddingBottom={6}>
@@ -38,7 +38,7 @@ export const HelpTab = () => {
       <Box paddingBottom={4}>
         <Typography variant="beta" tag="h2">Plugin Documentation</Typography>
         <Typography variant="omega" textColor="neutral600">
-          Complete guide for configuring and using the Content Sync Pro plugin.
+          End-to-end guide for configuring, securing, and operating Content Sync Pro across Strapi environments.
         </Typography>
       </Box>
 
@@ -50,6 +50,7 @@ export const HelpTab = () => {
           <Tabs.Trigger value="sync-profiles">Sync Profiles</Tabs.Trigger>
           <Tabs.Trigger value="execution">Sync Execution</Tabs.Trigger>
           <Tabs.Trigger value="media">Media</Tabs.Trigger>
+          <Tabs.Trigger value="stats">Stats</Tabs.Trigger>
           <Tabs.Trigger value="enforcement">Enforcement</Tabs.Trigger>
           <Tabs.Trigger value="alerts">Alerts</Tabs.Trigger>
           <Tabs.Trigger value="troubleshooting">Troubleshooting</Tabs.Trigger>
@@ -60,9 +61,7 @@ export const HelpTab = () => {
           <Box paddingTop={4}>
             <HelpSection title="Video walkthrough">
               <Typography variant="omega" paddingBottom={3}>
-                Watch the plugin intro video:
-                {' '}
-                <DocLink href={INTRO_VIDEO_URL}>YouTube</DocLink>
+                Watch the help video to get started:
               </Typography>
 
               <Box
@@ -71,22 +70,46 @@ export const HelpTab = () => {
                 padding={3}
                 style={{ maxWidth: '960px' }}
               >
-                <Box style={{ position: 'relative', paddingTop: '56.25%' }}>
-                  <Box
-                    tag="iframe"
-                    src={INTRO_VIDEO_EMBED_URL}
-                    title="Content Sync Pro — plugin intro"
-                    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
-                    allowFullScreen
-                    style={{
-                      position: 'absolute',
-                      top: 0,
-                      left: 0,
-                      width: '100%',
-                      height: '100%',
-                      border: 0,
-                    }}
-                  />
+                <a href={INTRO_VIDEO_URL} target="_blank" rel="noopener noreferrer" style={{ display: 'block', textDecoration: 'none' }}>
+                  <Box style={{ position: 'relative', paddingTop: '56.25%', overflow: 'hidden', borderRadius: '4px' }}>
+                    <img
+                      src={INTRO_VIDEO_THUMBNAIL}
+                      alt="Content Sync Pro — plugin intro"
+                      style={{
+                        position: 'absolute',
+                        top: 0,
+                        left: 0,
+                        width: '100%',
+                        height: '100%',
+                        objectFit: 'cover',
+                      }}
+                    />
+                    <Box
+                      style={{
+                        position: 'absolute',
+                        top: '50%',
+                        left: '50%',
+                        transform: 'translate(-50%, -50%)',
+                        width: '68px',
+                        height: '48px',
+                        backgroundColor: 'rgba(255,0,0,0.85)',
+                        borderRadius: '12px',
+                        display: 'flex',
+                        alignItems: 'center',
+                        justifyContent: 'center',
+                      }}
+                    >
+                      <svg width="24" height="24" viewBox="0 0 24 24" fill="white">
+                        <polygon points="8,5 20,12 8,19" />
+                      </svg>
+                    </Box>
+                  </Box>
+                </a>
+                <Box paddingTop={2}>
+                  <Typography variant="pi" textColor="neutral500">
+                    ▶ Watch the help video on{' '}
+                    <DocLink href={INTRO_VIDEO_URL}>YouTube</DocLink>
+                  </Typography>
                 </Box>
               </Box>
             </HelpSection>
@@ -102,9 +125,10 @@ export const HelpTab = () => {
               <ul style={{ paddingLeft: '20px', marginTop: '8px', lineHeight: '1.8' }}>
                 <li><Typography variant="omega">Bi-directional sync (push, pull, or both)</Typography></li>
                 <li><Typography variant="omega">Sync Profiles for defining WHAT to sync</Typography></li>
-                <li><Typography variant="omega">Execution modes: On-demand, Scheduled, or Live (real-time)</Typography></li>
+                <li><Typography variant="omega">Execution modes: On-demand, Scheduled, Live, or External scheduler</Typography></li>
                 <li><Typography variant="omega">Field-level sync policies (Advanced mode)</Typography></li>
                 <li><Typography variant="omega">Conflict resolution strategies (Latest, Local, Remote wins)</Typography></li>
+                <li><Typography variant="omega">Pagination support for large datasets with bounded memory usage</Typography></li>
                 <li><Typography variant="omega">Dependency resolution - sync related entities automatically</Typography></li>
                 <li><Typography variant="omega">Enforcement checks - schema, version, and time validation</Typography></li>
                 <li><Typography variant="omega">Configurable alerts via email, webhook, or Strapi logs</Typography></li>
@@ -126,10 +150,10 @@ export const HelpTab = () => {
 
             <HelpSection title="Quick Start">
               <ol style={{ paddingLeft: '20px', lineHeight: '2' }}>
-                <li><Typography variant="omega"><strong>Configuration Tab</strong> - Set up remote server URL, API token, and shared secret</Typography></li>
+                <li><Typography variant="omega"><strong>Configuration Tab</strong> - Set up remote server URL, API token, instance ID, and shared secret</Typography></li>
                 <li><Typography variant="omega"><strong>Content Types Tab</strong> - Enable content types for sync (auto-generates default profiles)</Typography></li>
                 <li><Typography variant="omega"><strong>Sync Profiles Tab</strong> - Customize sync behavior or use defaults</Typography></li>
-                <li><Typography variant="omega"><strong>Sync Tab</strong> - Configure execution settings and run sync operations</Typography></li>
+                <li><Typography variant="omega"><strong>Sync Execution Tab</strong> - Configure execution settings, page size, and run sync operations</Typography></li>
               </ol>
             </HelpSection>
 
@@ -148,6 +172,14 @@ export const HelpTab = () => {
               <Typography variant="omega" paddingBottom={2}>
                 Configure the connection to the remote Strapi instance in the <strong>Connection</strong> sub-tab.
               </Typography>
+              <Typography variant="omega" paddingBottom={2}>
+                <strong>Deployment modes:</strong> Use <strong>Paired</strong> mode when the plugin is installed on both servers,
+                or <strong>Single-side</strong> mode when the plugin is installed only on local server.
+              </Typography>
+              <Typography variant="omega" paddingBottom={2}>
+                In paired mode, connection test validates remote plugin reachability and token access. In single-side mode,
+                test validates remote reachability and content API token access without requiring remote plugin endpoints.
+              </Typography>
 
               <Box background="neutral100" padding={4} hasRadius marginBottom={4}>
                 <Typography variant="sigma" textColor="neutral800">Base URL</Typography>
@@ -273,6 +305,9 @@ http://localhost:1337</CodeBlock>
                 Sync Profiles define <strong>WHAT</strong> to sync and <strong>HOW</strong> conflicts are resolved.
                 They do NOT control when sync runs - that's configured in the Sync tab (Execution).
               </Typography>
+              <Typography variant="omega" paddingTop={2}>
+                In <strong>Single-side</strong> mode, profiles are automatically restricted to <strong>Pull Only</strong>.
+              </Typography>
               <Typography variant="omega" paddingTop={2}>
                 Each profile specifies:
               </Typography>
@@ -503,7 +538,7 @@ http://localhost:1337</CodeBlock>
                   Uses lifecycle hooks to detect changes.
                 </Typography>
                 <Typography variant="pi" textColor="warning600" paddingTop={2}>
-                  Note: Increases server load. Use for critical content only.
+                  Note: Increases server load. Use for critical content only. Live mode is available in paired mode and disabled in single-side mode.
                 </Typography>
               </Box>
             </HelpSection>
@@ -610,6 +645,10 @@ http://localhost:1337</CodeBlock>
               <Typography variant="omega">
                 Each profile can sync two distinct aspects of media:
               </Typography>
+              <Typography variant="omega" paddingTop={2}>
+                For entity-linked media consistency, this plugin also syncs media morph links using <strong>documentId-based remapping</strong>
+                (file documentId and related entity documentId are resolved to local numeric ids before insert).
+              </Typography>
               <Box background="neutral100" padding={4} hasRadius marginTop={2} marginBottom={2}>
                 <Typography variant="sigma" textColor="neutral800">DB Rows (Metadata)</Typography>
                 <Typography variant="omega" paddingTop={1}>
@@ -630,6 +669,11 @@ http://localhost:1337</CodeBlock>
                 If you only need metadata references (e.g., both sides use the same S3 bucket), you can
                 sync DB rows only.
               </Typography>
+              <Typography variant="pi" textColor="neutral600" paddingTop={2}>
+                Note: Strapi components, repeatable components, and dynamic zones are already tracked by
+                document service sync using stable documentIds, so they do not require id-to-documentId remapping
+                like upload morph tables do.
+              </Typography>
             </HelpSection>
 
             <HelpSection title="URL strategy (HTTP)">
@@ -698,6 +742,61 @@ http://localhost:1337</CodeBlock>
           </Box>
         </Tabs.Content>
 
+        {/* Stats Tab */}
+        <Tabs.Content value="stats">
+          <Box paddingTop={4}>
+            <HelpSection title="Database Stats Overview">
+              <Typography variant="omega">
+                The Stats tab compares local and remote data state per content type, including content
+                entries, media files, and media morph (relation) links. The view is split into two
+                sub-tabs: <strong>Current Snapshot</strong> and <strong>Run Reports</strong>.
+              </Typography>
+            </HelpSection>
+
+            <HelpSection title="Current Snapshot Tab">
+              <Typography variant="omega">
+                Shows the latest live counts and newest timestamps per content type, with the newest
+                side (local / remote / equal) highlighted. Use the controls above the table to drill in:
+              </Typography>
+              <ul style={{ paddingLeft: '20px', marginTop: '8px', lineHeight: '1.8' }}>
+                <li><Typography variant="omega"><strong>Search</strong> - Filter rows by UID substring.</Typography></li>
+                <li><Typography variant="omega"><strong>Type</strong> - Filter by Content, Media, or Media Morph.</Typography></li>
+                <li><Typography variant="omega"><strong>Newest side</strong> - Show only rows where local, remote, or both are newest.</Typography></li>
+                <li><Typography variant="omega"><strong>Page size / pagination</strong> - Browse large snapshots without scrolling.</Typography></li>
+              </ul>
+            </HelpSection>
+
+            <HelpSection title="Run Reports Tab (Before vs After)">
+              <Typography variant="omega">
+                Before every sync run, the plugin captures a pre-run snapshot. After the run completes,
+                it captures a post-run snapshot and stores both in a report so you can review sync impact
+                and trends over time.
+              </Typography>
+              <ul style={{ paddingLeft: '20px', marginTop: '8px', lineHeight: '1.8' }}>
+                <li><Typography variant="omega"><strong>Status filter</strong> - Show all runs, or only success / failed.</Typography></li>
+                <li><Typography variant="omega"><strong>Page size / pagination</strong> - Reports are paginated server-side.</Typography></li>
+                <li><Typography variant="omega"><strong>Show details</strong> - Expand a report card to see the before/after row tables (first {25} rows per side).</Typography></li>
+              </ul>
+            </HelpSection>
+
+            <HelpSection title="Top Action Row: Refresh, Clear & Retention">
+              <Typography variant="omega">
+                The top of the Stats tab exposes the controls that apply to both sub-tabs:
+              </Typography>
+              <ul style={{ paddingLeft: '20px', marginTop: '8px', lineHeight: '1.8' }}>
+                <li><Typography variant="omega"><strong>Refresh Stats</strong> - Reload the snapshot and reports.</Typography></li>
+                <li><Typography variant="omega"><strong>Clear Logs</strong> - Remove stored sync logs.</Typography></li>
+                <li><Typography variant="omega"><strong>Clear Stats Reports</strong> - Remove all before/after run reports.</Typography></li>
+                <li><Typography variant="omega"><strong>Max Logs / Max Reports</strong> - Retention limits; older entries are pruned when exceeded.</Typography></li>
+                <li><Typography variant="omega"><strong>Save &amp; Apply Retention</strong> - Persists the limits and immediately prunes old data.</Typography></li>
+              </ul>
+              <Typography variant="pi" textColor="neutral600" paddingTop={2}>
+                Retention is also enforced automatically after each sync run.
+              </Typography>
+            </HelpSection>
+          </Box>
+        </Tabs.Content>
+
         {/* Enforcement Tab */}
         <Tabs.Content value="enforcement">
           <Box paddingTop={4}>
@@ -875,10 +974,10 @@ http://localhost:1337</CodeBlock>
               </Box>
 
               <Box background="danger100" padding={4} hasRadius marginBottom={4}>
-                <Typography variant="sigma" textColor="danger700">401 Unauthorized</Typography>
+                <Typography variant="sigma" textColor="danger700">401 Unauthorized / 403 Forbidden</Typography>
                 <Typography variant="omega" paddingTop={1}>
-                  The API token is invalid or expired. Generate a new token on the remote server and update
-                  Configuration → Connection → API Token.
+                  The API token is invalid, expired, or missing required permissions. Generate a new token on the remote
+                  server and ensure it can access the synced content types (and Upload permissions for media sync).
                 </Typography>
               </Box>
 
@@ -891,10 +990,10 @@ http://localhost:1337</CodeBlock>
               </Box>
 
               <Box background="danger100" padding={4} hasRadius marginBottom={4}>
-                <Typography variant="sigma" textColor="danger700">Content type not found on remote</Typography>
+                <Typography variant="sigma" textColor="danger700">Content type endpoint not found on remote</Typography>
                 <Typography variant="omega" paddingTop={1}>
-                  The content type exists locally but not on the remote server. Ensure both instances
-                  have matching content type definitions.
+                  The content type exists locally but the remote REST endpoint is missing or named differently.
+                  Ensure both instances have matching content type definitions and API routes are enabled.
                 </Typography>
               </Box>
 

package/admin/src/components/MediaTab.jsx

@@ -400,6 +400,13 @@ const MediaTab = () => {
             {status?.lastResult && (
               <Box paddingTop={3} background="neutral0" padding={4} hasRadius shadow="tableShadow">
                 <Typography variant="sigma">Last Run Result</Typography>
+                {(status.lastResult.morphLinksApplied !== undefined || status.lastResult.morphLinksSkipped !== undefined) && (
+                  <Box paddingTop={2} paddingBottom={2}>
+                    <Typography variant="omega" textColor="neutral700">
+                      Morph links synced: applied {status.lastResult.morphLinksApplied || 0}, skipped {status.lastResult.morphLinksSkipped || 0}
+                    </Typography>
+                  </Box>
+                )}
                 <Typography variant="pi" style={{ fontFamily: 'monospace', whiteSpace: 'pre-wrap' }}>
                   {JSON.stringify(status.lastResult, null, 2)}
                 </Typography>