System Requirements

Ensure your server and browser meet these requirements before installing XBuilder.

Server Requirements

Joomla Version

Joomla Version	Supported
Joomla 4.x	✅ Yes
Joomla 5.x	✅ Yes
Joomla 6.x	✅ Yes
Joomla 3.x	❌ No

Joomla 3 Users

XBuilder is not compatible with Joomla 3. Please upgrade to Joomla 4 or later.

PHP Version

Requirement	Minimum	Recommended
PHP Version	8.0.0	8.2+

Required PHP Extensions:

• json — JSON encoding/decoding
• mbstring — Multibyte string handling
• gd or imagick — Image processing

Database

Database	Minimum Version
MySQL	5.7+
MariaDB	10.2+
PostgreSQL	11+

Web Server

XBuilder works with any web server supported by Joomla:

• Apache 2.4+
• Nginx 1.18+
• IIS 10+
• LiteSpeed

PHP Settings

Recommended PHP configuration for optimal performance:

; Minimum recommended settings
upload_max_filesize = 10M
post_max_size = 12M
max_execution_time = 60
memory_limit = 256M

Browser Requirements

Admin Builder Interface

The visual builder requires a modern web browser with JavaScript enabled:

Browser	Minimum Version
Chrome	90+
Firefox	90+
Safari	14+
Edge	90+

Internet Explorer

Internet Explorer is not supported. Please use Microsoft Edge or another modern browser.

Required Browser Features

• JavaScript enabled
• Cookies enabled
• Local storage enabled
• CSS3 support
• SVG support

Frontend Popup Display

Popups display correctly on:

• All modern desktop browsers
• Mobile browsers (iOS Safari, Chrome for Android)
• Older browsers with graceful degradation

Disk Space

Approximate disk space requirements:

Component	Size
Component files	~5 MB
Module files	~500 KB
Media assets	~2 MB
Total	~8 MB

Additional space needed for:

• Uploaded images
• Template assets
• Database storage

Checking Your Environment

Via Joomla System Information

1. Go to System → System Information
2. Review:
   • PHP Version — Should be 8.0.0+
   • Joomla Version — Should be 4.0.0+
   • Database Version — Check compatibility

Via PHP Info

Create a temporary file phpinfo.php:

<?php phpinfo(); ?>

Upload to your server and access via browser. Check:

• PHP Version
• Loaded Extensions
• Configuration values

Security

Delete phpinfo.php after checking! It exposes sensitive server information.

Compatibility Notes

Template Compatibility

XBuilder works with any Joomla template. Popups render as overlays and don't interfere with template layouts.

Tested with:

• Cassiopeia (Joomla default)
• JoomShaper templates
• RocketTheme templates
• YOOtheme Pro
• Most commercial and free templates

Extension Compatibility

XBuilder is compatible with most Joomla extensions. Known integrations:

• Page Builders — Works alongside other page builders
• SEF Extensions — Compatible with sh404SEF, JoomSEF, etc.
• Cache Extensions — Works with JotCache, LiteSpeed Cache
• Security Extensions — Compatible with RSFirewall, AdminTools

JavaScript Libraries

XBuilder uses React and loads its own JavaScript. Potential conflicts may occur with:

• Older jQuery-based extensions (rare)
• Custom React applications on same page

If you experience JavaScript conflicts, check browser console for errors.

Performance Recommendations

For best performance:

1. Enable Joomla Caching

   • System → Global Configuration → System → Cache

2. Enable Browser Caching

   • Configure via .htaccess or server settings

3. Use PHP OPcache

   • Improves PHP execution speed

4. Optimize Images

   • Use compressed images in popups
   • Consider WebP format

Next Steps

• Installation Guide — Install the extension
• Module Setup — Configure display module