Amvionlie CMS
Where the Future Begins

Common Addon Mistakes

Purpose

Use this as a pre-flight check before calling an addon ready.

Avoid these

  • Reading `manifest.php` during ordinary rendering instead of using installed/governed runtime truth.
  • Adding admin UI without route and permission contracts.
  • Adding tables without a schema contract.
  • Adding protected behavior without a permissions contract.
  • Adding public routes without public target metadata when Menu Manager should link to them.
  • Creating local list, pagination, CSRF, permission, identity, or sortable systems.
  • Showing developer diagnostics in normal admin UI.
  • Leaving fallback/sample definitions after a governed owner exists.
  • Writing to old changelog tables.

Ownership mistakes

Do not make Dashboard manage widgets. Do not make Menu Manager render target content. Do not make Content Manager own Pages. Do not make an installer or catalog surface compensate for broken addon contracts.

Better habit

When a change feels like it wants to touch five owners, stop and find the actual contract boundary. There is usually one small handoff point trying to wave at you.

Updated: 2026-05-07 02:18:09