Developer Guide

First-time setup

npm install
cd engine && composer install && cd ..
npm run build

Set nxp_starter as default template in Joomla after build/install.

Development modes

• Recommended: npm run dev:css and npm run dev:js
• Alternative: enable template developer mode with PHP compilation on request

Disable developer mode before production.

Common customizations

• SCSS variables/components under src/scss/
• JS modules under src/js/
• custom layouts under template_layouts/
• Joomla override integration under html/

Module positions

• top-nav
• header
• sidebar-left
• sidebar-right
• main-top
• main-bottom
• footer

Troubleshooting

• Clear Joomla + browser cache after asset changes.
• Check engine/logs/template.log.php for compile/runtime issues.
• Confirm css/, js/, and engine/logs/ are writable.