PHPackages                             pantheon-systems/decoupled-preview - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. pantheon-systems/decoupled-preview

ActiveWordpress-plugin[API Development](/categories/api)

pantheon-systems/decoupled-preview
==================================

Preview WordPress content on Front-end sites including Next.js

1.0.6(2y ago)82.5k—0%5[4 PRs](https://github.com/pantheon-systems/wp-decoupled-preview/pulls)GPL-2.0-or-laterPHPCI passing

Since Dec 14Pushed 3mo ago21 watchersCompare

[ Source](https://github.com/pantheon-systems/wp-decoupled-preview)[ Packagist](https://packagist.org/packages/pantheon-systems/decoupled-preview)[ RSS](/packages/pantheon-systems-decoupled-preview/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (3)Versions (17)Used By (0)

WP Decoupled Preview
====================

[](#wp-decoupled-preview)

[![Actively Maintained](https://camo.githubusercontent.com/2ae5ff81f271fb028d720adee6b3595770166f3707a4705a4a2a3b71c332b249/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f50616e7468656f6e2d4163746976656c795f4d61696e7461696e65642d79656c6c6f773f6c6f676f3d70616e7468656f6e26636f6c6f723d464644433238)](https://docs.pantheon.io/oss-support-levels#actively-maintained-support) [![Packagist Version](https://camo.githubusercontent.com/73180f6040fe9167ee522333121a7b7f30c5cf6cc36e72590afd188e08454ee4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70616e7468656f6e2d73797374656d732f6465636f75706c65642d70726576696577)](https://packagist.org/packages/pantheon-systems/decoupled-preview) [![GPL 2.0 License](https://camo.githubusercontent.com/681e280b5816db176050505727b1ec2ee4f01fd229becad5d079f5377fb3bad1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f70616e7468656f6e2d73797374656d732f77702d6465636f75706c65642d70726576696577)](https://github.com/pantheon-systems/wp-decoupled-preview/blob/main/LICENSE) [![Build Status](https://camo.githubusercontent.com/729f39ab9f968575d53b4d813ae3b733004b8dcc1281dfacd3e4e411957e05d6/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f70616e7468656f6e2d73797374656d732f77702d6465636f75706c65642d707265766965772f6c696e742d746573742e796d6c)](https://github.com/pantheon-systems/wp-decoupled-preview/actions)

Preview headless WordPress content on your front-end site.

This plugin intends to provide a single home for preview on a variety of decoupled front-ends.

Features
--------

[](#features)

- Preview while editing a Post/Page.
- Configure multiple preview sites.
- Specify the post types (Post and Pages) that each preview site applies to.

Configuration
-------------

[](#configuration)

In the WordPress Admin Dashboard, navigate to **Settings** -&gt; **Preview Sites** (`/wp-admin/options-general.php?page=preview_sites`), add one or more preview sites, and configure the following:

- Label: The name of the site.
- URL: The URL of the decoupled site you are providing preview data to.
- Secret: A token that will be passed to your decoupled site used to limit access to the preview.
- Preview Type: The type of preview site - currently only NextJS is supported.
- Content Types: The post types (like Post and Page) that this preview site applies to.

Preview Types
-------------

[](#preview-types)

While we hope to expand in the future, the initial release of this plugin only supports NextJS. It was developed in support of [Pantheon's Next WordPress Starter](https://github.com/pantheon-systems/next-wordpress-starter), but can be applied to other NextJS sites using a similar approach.

Known Issues
------------

[](#known-issues)

- Currently this plugin does not support custom post types.
- Currently this plugin does not support the classic editor.

Linting and Testing
-------------------

[](#linting-and-testing)

This plugin uses [Composer](https://getcomposer.org/) to manage dependencies. To install dependencies, run `composer install` from the plugin directory.

Linting is done with [PHP\_CodeSniffer](https://packagist.org/packages/squizlabs/php_codesniffer) using the [Pantheon WP Coding Standards](https://packagist.org/packages/pantheon-systems/pantheon-wp-coding-standards) ruleset. To run the linting checks, use the following command:

```
composer lint
```

Unit tests are written with [PHPUnit](https://packagist.org/packages/phpunit/phpunit) using the WP Unit test framework. To set up your local maching to be able to run the unit tests, use the following command:

```
composer test:install
```

Note that you will need to have MariaDB or MySQL installed and running on your local machine. Once you have the test environment set up, you can run the unit tests with the following command:

```
composer test
```

Both linting and testing are done in a GitHub Action on every commit and pull request. Tests are located in the `tests` directory.

###  Health Score

43

—

FairBetter than 90% of packages

Maintenance63

Regular maintenance activity

Popularity27

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~56 days

Recently: every ~83 days

Total

10

Last Release

737d ago

Major Versions

0.2.1 → 1.0.02023-03-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/5a89f5f15357797cbd6ec7833a28626478ae3c0ceb5fa1faa8a26d0960584c65?d=identicon)[pantheon-systems](/maintainers/pantheon-systems)

![](https://www.gravatar.com/avatar/d9ca460cecd2c1438b31b66b2f810dc0ff05746b53ba006edb915e1ff8354b99?d=identicon)[jspellman814](/maintainers/jspellman814)

![](https://www.gravatar.com/avatar/d3e0813f66232abbf905071333493f1ce86df97e63ba9a6fcc55cc2f84832b4f?d=identicon)[backlineint](/maintainers/backlineint)

---

Top Contributors

[![jazzsequence](https://avatars.githubusercontent.com/u/991511?v=4)](https://github.com/jazzsequence "jazzsequence (181 commits)")[![abhisekmazumdar](https://avatars.githubusercontent.com/u/12195330?v=4)](https://github.com/abhisekmazumdar "abhisekmazumdar (35 commits)")[![backlineint](https://avatars.githubusercontent.com/u/889478?v=4)](https://github.com/backlineint "backlineint (32 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (15 commits)")[![CobyPear](https://avatars.githubusercontent.com/u/63015754?v=4)](https://github.com/CobyPear "CobyPear (6 commits)")[![pwtyler](https://avatars.githubusercontent.com/u/8714062?v=4)](https://github.com/pwtyler "pwtyler (2 commits)")

---

Tags

decoupled-kitwordpresswordpress-plugin

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pantheon-systems-decoupled-preview/health.svg)

```
[![Health](https://phpackages.com/badges/pantheon-systems-decoupled-preview/health.svg)](https://phpackages.com/packages/pantheon-systems-decoupled-preview)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M475](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M270](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[microsoft/microsoft-graph

The Microsoft Graph SDK for PHP

65723.5M95](/packages/microsoft-microsoft-graph)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
