smart preview
A Smart Preview plugin for Strapi v4/v5 that injects a configurable preview button into the Content Manager edit view
Strapi Plugin: Smart Preview
A production-ready plugin for Strapi v4 / v5 that injects a "Smart Preview" button directly into the Content Manager's edit view. It dynamically uses the current content type and entry ID to build a configurable preview URL, allowing content editors to easily preview their work on your frontend.
✨ Features
- Dynamic Preview URLs — Constructs
<basePreviewUrl>?type=<contentType>&id=<id>automatically. - Works for ANY Content Type — Automatically identifies the current Collection Type or Single Type UID.
- Save-Aware — The button is disabled until the entry is saved (an ID is generated). Tooltips inform the user.
- Configurable — Set the base preview URL via Strapi plugin config or environment variables.
- Token Support — Optionally pass a
tokenquery parameter for secure preview endpoints. - Zero Dependencies — Uses only Strapi's built-in design system and React.
📦 Installation
npm install strapi-plugin-smart-preview
# or
yarn add strapi-plugin-smart-preview⚙️ Configuration
Enable the plugin in your config/plugins.js (or .ts):
module.exports = ({ env }) => ({
'smart-preview': {
enabled: true,
config: {
previewBaseUrl: env('PREVIEW_BASE_URL', 'http://localhost:3000/preview'),
previewToken: env('PREVIEW_TOKEN', null),
},
},
});Environment Variables
| Variable | Description | Default |
|---|---|---|
PREVIEW_BASE_URL | Base URL for the preview endpoint | http://localhost:3000/preview |
PREVIEW_TOKEN | Optional token for secure previews | null |
🚀 Usage
- Install the plugin and configure it as shown above.
- Start your Strapi server (
npm run develop). - Navigate to Content Manager.
- Open an existing entry or create a new one.
- Save the entry if it's new.
- Click the Smart Preview button located on the right side of the edit view.
The button opens a new tab with:
<previewBaseUrl>?type=<content-type-uid>&id=<entry-id>&token=<optional-token>🔧 How It Works
The plugin:
1. Registers itself with Strapi's plugin system during register().
2. Injects a PreviewButton React component into the Content Manager's edit view via bootstrap().
3. The button reads the current URL to determine the content type UID and entry ID.
4. On click, it builds a preview URL using the configured base URL and opens it in a new tab.
5. The base URL is fetched from the server-side config, which merges plugin config and env variables.
📋 Compatibility
| Strapi Version | Supported |
|---|---|
| v5.x | ✅ |
| v4.x | ✅ |
| v3.x | ❌ |
📄 License
MIT — Made with ❤️ by Techexplified
Install now
npm install strapi-plugin-smart-preview
Create your own plugin
Check out the available plugin resources that will help you to develop your plugin or provider and get it listed on the marketplace.