How They Load

Both files are loaded last via the Joomla Web Asset Manager, after all theme stylesheets and template scripts. This ensures your overrides take precedence without needing !important.

Auto-Minification

Mokonyx automatically minifies user.css and user.js on first page load when not in development mode. The minified versions are served to visitors for better performance.

Development Mode

Enable Development Mode in the Advanced tab to load unminified source files for easier debugging, skip the minification cache, and see verbose error output.

Best Practices

• Use user.css for layout tweaks, colour overrides, or component styling
• Use user.js for analytics snippets, custom interactions, or third-party integrations
• These files are excluded from version control and are site-specific

Working Safely With Overrides

Because these files load after everything else, they are the recommended place for all custom styling and scripting. Keeping your changes here-rather than editing core template files-means your work will not be lost when the template is updated.

• Make small, incremental changes and review the site after each one.
• Comment your CSS and JavaScript so future edits are easier to understand.
• Keep a local backup of your user.css and user.js before major edits, since these files are site-specific and not tracked in version control.
• Test changes on a staging copy of the site when possible before applying them to production.

Troubleshooting

• Changes aren't appearing: The minified cache may still be serving an older version. Enable Development Mode to load the raw source files, or clear the Joomla cache after editing.
• A style isn't applying: Confirm the selector is correct and specific enough; because user.css loads last, you should rarely need !important.
• A script isn't running: Check the browser console for errors and confirm the code is valid JavaScript before saving.

Need Help?

If you are unsure how to structure an override or need assistance with a specific customisation, contact Moko Enterprises support and our team can help you implement it safely.