Help & Documentation
Open Support Ticket

Portal Page Developer Helper Releases

Release 1.2.1 (released August 7, 2026)

Bug Fixes & Improvements

  1. Fixed a regression introduced in 1.2.0 where the Variables Editor's script could fail to parse, blanking out the entire Dev Panel UI.

Release 1.2.0 (released August 7, 2026)

New Features

  1. New Variables Editor for editing a Template's Variable schema and an App's live Variable values, with Schema and Values tabs, raw-JSON view for each, and JSON import/export for Values. Adds [Reload variables] and [Open variables editor…] buttons to the Dev Panel.
  2. Added an Auto/Dark/Light theme switcher to the Dev Panel's settings popover. The Inspector and Variables Editor, previously dark-only, now support it too.
  3. New App-variables API (/@api/variables/*) with schema, export, and validation helpers.

Bug Fixes & Improvements

  1. Variables Editor tab switching no longer blanks out while a network request is pending, it shows cached content or a skeleton immediately and debounces the background reload.
  2. Added a delete-confirmation step for variables and a simpler way to reveal advanced fields in the Schema tab.
  3. Resolved new npm audit findings across the package and its test fixtures.

Release 1.1.1 (released July 27, 2026)

  1. Patched dependencies flagged by npm audit to close known security advisories in pp-dev's dependency tree. No functional changes.

Release 1.1.0 (released July 21, 2026)

Next.js Build Parity

  1. Added a new pp-dev next-build command so Next.js Apps get the same build output that pp-dev build already produces for other App types: a VERSION file, a BUILD-MANIFEST file, and a zipped dist package.
  2. pp-dev now shows a console warning when a Next.js App wrapped with withPPDev() is built using plain next build instead of pp-dev next-build, so a manifest-less build doesn't slip through unnoticed.
  3. Added CLI flags (and matching environment variables) to customize the dist-zip folder and filename, and to turn the version manifest on or off, for both build and next-build.

Bug Fixes & Improvements

  1. Fixed a logging issue where pp-dev reported writing the VERSION and BUILD-MANIFEST files even when the version file was disabled.
  2. Resolved new npm audit advisories surfaced in pp-dev's dependencies and test fixtures.

Release 1.0.0 (released July 13, 2026)

pp-dev 1.0.0 is the first stable release. It adopts semantic versioning, requires Node.js 24 or later, and introduces a new configuration format.

Configuration Format Changes:

  1. Flat 0.x options are replaced by a grouped config. Run npx @metricinsights/pp-dev migrate to convert an existing config automatically, it backs up the original before overwriting.
  2. Legacy pp-watch.config.* files are no longer read directly, the migrate command still detects and converts them.

New Features

  1. Added a Request Inspector to the Dev Panel for inspecting requests proxied through pp-dev during local App development. It exposes its own REST API for tooling and AI agents.
  2. Dev Panel position is now configurable, and the panel can be hidden automatically or manually.

Bug Fixes & Improvements

  1. Fixed the Request Inspector not capturing the bodies of proxied PUT and POST requests.
  2. Refined the Dev Panel UI to align with core Metric Insights design.