Developer Guide

First-time setup

bash

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.