Skip to content

Development Notes

Jump to bottom
Shane Rounce edited this page May 10, 2026 · 2 revisions

Development notes

This page is for practical maintenance and contributor context.

Repository shape

  • adaptive-customer-engagement.php bootstraps the plugin
  • includes/ holds the PHP classes
  • assets/src/admin/ holds the source admin app
  • assets/src/frontend/ holds the frontend tracker
  • assets/build/ holds generated build assets

Build commands

From the plugin directory:

npm install
npm run build

Validation expectations

When I touch PHP, I want the changed files checked with:

php -l path/to/file.php

When I touch the admin or frontend JavaScript, I want the assets rebuilt so the working copy stays in step with the source.

Documentation expectations

I want the documentation to stay aligned across:

  • README.md
  • readme.txt
  • the GitHub wiki
  • AGENTS.md

If behaviour, setup, reporting surfaces, or roadmap position changes, the docs should be refreshed as part of the same piece of work.

Writing style

Documentation should stay in British English and read as though I wrote it.

GitHub issue comments and issue bodies can include the repository’s AI summary convention, but the wiki should read like normal project documentation and should not carry those summaries.

Clone this wiki locally