System Requirements

This page outlines the technical requirements for installing and running BreakMade.

Minimum Requirements

WordPress

Required Plugins

• Breakdance Page Builder: Required for all features

Optional Plugins

• HeadSpinUI: For HeadSpinUI integration features

Server Requirements

PHP Configuration

memory_limit = 256M        # Minimum
max_execution_time = 300   # For large operations
upload_max_filesize = 64M  # For design imports
post_max_size = 64M        # For design imports

Recommended PHP Extensions

• json - Required for data handling
• mbstring - For string operations
• curl - For API communications
• zip - For design set downloads

Browser Compatibility

Admin Panel

Frontend (CSS Variables)

Hosting Recommendations

Supported Hosting Types

• Shared Hosting: Works but may be slower
• VPS: Recommended for best performance
• Managed WordPress: Excellent choice
• Cloud Hosting: Ideal for scalability

Known Compatible Hosts

• WP Engine
• Kinsta
• Cloudways
• SiteGround
• Flywheel
• Local by Flywheel (development)

Hosting Features Needed

• PHP 7.4+ support
• WordPress core requirements
• wp-content/uploads writable
• HTTPS support (recommended)

Performance Considerations

Caching

BreakMade works with caching plugins:

• WP Rocket
• W3 Total Cache
• LiteSpeed Cache
• WP Super Cache

Note: Clear cache after:

• Installing design sets
• Changing color palette
• Updating selectors

CDN Compatibility

Compatible with:

• Cloudflare
• StackPath
• KeyCDN
• BunnyCDN

Note: Purge CDN cache after CSS changes.

Multi-Site Support

BreakMade works on WordPress Multisite:

• Network-activated: One license per network
• Site-activated: License per site

Considerations

• Each site has independent settings
• CSS files generated per site
• Design sets can differ per site

Local Development

Recommended Tools

• Local by Flywheel: Easiest setup
• MAMP/WAMP: Traditional approach
• Docker: For containerized development
• Laragon: Windows alternative

Local URLs

BreakMade works with:

• *.local domains
• *.test domains
• localhost with ports
• Custom local domains

License Activation

Domain Requirements

• Public domains: Counted against license
• Staging domains: Usually not counted
• Local domains: Not counted

Common Staging Patterns

These are typically recognized as staging:

staging.example.com
dev.example.com
test.example.com
*.staging.wpengine.com
*.flywheelsites.com

Troubleshooting

PHP Version Issues

If you see PHP errors:

1. Check current PHP version in WordPress Health Check
2. Contact hosting to upgrade PHP
3. Ensure PHP 7.4+ compatibility

Memory Limit Issues

If operations fail:

1. Check current memory limit
2. Add to wp-config.php:

   define('WP_MEMORY_LIMIT', '256M');
   

3. Contact hosting if unable to increase

Permission Issues

If CSS file won’t generate:

1. Verify /wp-content/uploads/ is writable
2. Check directory permissions (755)
3. Check file permissions (644)

Breakdance Not Detected

1. Ensure Breakdance is installed
2. Verify Breakdance is activated
3. Check for plugin conflicts
4. Deactivate/reactivate both plugins