Nebulix installation and customization guide
Complete documentation for installing the Nebulix frontend website, WHMCS client area theme, modified Standard Cart order form, cPanel overview override, assets, cache clearing, color customization, and final delivery checks.
1. Demo and purchase links
Use these links to preview Nebulix, test the client area, and purchase the template.
Frontend Demo
WHMCS Client Area Demo
Demo Login
Email: test@hostk.com
Password: test
Purchase Nebulix
2. Package contents
The archive contains a standalone frontend, WHMCS client theme, order form overrides, cPanel module overview customization, and screenshots.
| Path | Files | Size | Purpose |
|---|---|---|---|
frontend-english/ | 39 | 8.3 MB | Standalone Nebulix frontend website and public landing pages. |
templates/hostique/ | 238 | 11.2 MB | WHMCS client area theme files included with this package. |
templates/orderforms/standard_cart/ | 40 | 1.3 MB | Modified Standard Cart order form used for cart and checkout. |
templates/orderforms/hostique/ | 40 | 1.3 MB | Optional custom order form copy included in the archive. |
modules/servers/cpanel/ | 1 | 32.4 KB | cPanel product overview override. |
screenshots/ | 11 | 8.9 MB | Marketing screenshots and preview images. |
frontend-english folder can be uploaded separately to the public website path or used as the main frontend.3. Requirements before installation
Check these points before uploading Nebulix to a live website.
WHMCS installation
Use Nebulix with a self-hosted WHMCS installation where template files can be uploaded and edited directly.
Server access
You need FTP, SFTP, cPanel File Manager, or SSH access to the website root and WHMCS root folder.
Admin access
You need WHMCS administrator access to activate the client theme and order form template.
Backup first
Take a full backup of files and database before replacing any existing WHMCS template, order form, or module template files.
Dependencies
The included order form declares Bootstrap 3 or 4, jQuery 1.12, and Font Awesome 5 dependencies through theme.yaml.
Recommended workflow
Install and test on a staging or demo WHMCS first, then repeat the same process on the production installation.
4. Frontend website installation
Install the standalone Nebulix frontend website before or after the WHMCS template upload.
Extract the package locally
Extract the zip file on your computer. The frontend website is located inside frontend-english/.
Choose the public website path
Upload the contents of frontend-english/ to the main public website folder, such as public_html, or to a subfolder such as /nebulix-demo/frontend-english/.
Verify frontend assets
Make sure the assets folder exists and the generated CSS, JS, fonts, and mascot images are reachable.
/frontend-english/index.html
/frontend-english/assets/index-CO3zQSr7.js
/frontend-english/assets/hero-mascot-DFxS0fM-.png
/frontend-english/site/assets/css/
/frontend-english/site/assets/js/Test frontend pages
Open the homepage, pricing, contact, docs, status, hosting, and solution pages. Check links, buttons, responsive layout, and domain search forms.
.htaccess file has been uploaded and that Apache rewrite rules are enabled on the hosting account.5. WHMCS files upload
Upload the WHMCS client theme, order form override, and cPanel overview file into the WHMCS root directory.
Open the WHMCS root directory
This is the folder that contains configuration.php, clientarea.php, cart.php, templates, and modules.
Upload template folders
Upload the package templates folder directly into the WHMCS root. Allow overwrite only after confirming you have a backup.
Upload module override
Upload the package modules folder into the WHMCS root to apply the cPanel product overview customization.
Verify final WHMCS paths
After upload, these paths must exist on the server:
/templates/hostique/header.tpl
/templates/hostique/footer.tpl
/templates/hostique/assets/css/custom.css
/templates/hostique/assets/js/custom.js
/templates/hostique/assets/nebulix/
/templates/orderforms/standard_cart/viewcart.tpl
/templates/orderforms/standard_cart/common.tpl
/templates/orderforms/hostique/viewcart.tpl
/modules/servers/cpanel/templates/overview.tpltemplates/hostique/. Keep this folder name unless you also rename all references safely. The customer-facing product name can remain Nebulix.6. Activate Nebulix in WHMCS
Enable the uploaded client area theme from WHMCS admin after files are uploaded.
- Login to the WHMCS Admin Area.
- Go to
ConfigurationthenSystem SettingsthenGeneral Settings. - Open the
Generaltab. - Select the uploaded client area template folder, usually
hostique, as the system theme/template. - Save changes and open
clientarea.phpin a new private browser window.
/templates/hostique/theme.yaml and change name to Nebulix. Keep the folder name hostique unless you are intentionally renaming the whole template folder.7. Activate Standard Cart order form
Nebulix includes a customized Standard Cart, so the recommended setup is to activate Standard Cart globally.
Set system default order form
In WHMCS Admin, go to Configuration then System Settings then General Settings then the Ordering tab. Set System Default Order Form Template to Standard Cart.
Check product group overrides
Go to System Settings then Products/Services. Edit each product group and set the order form template to Use System Default or Standard Cart.
Test checkout journey
Test product selection, configure product, domain register/transfer, view cart, checkout, invoice generation, and order complete page.
Included order form folders
/templates/orderforms/standard_cart/
/templates/orderforms/hostique/The recommended setup is standard_cart because many WHMCS installations and mixed-cart workflows expect the Standard Cart folder to be active.
cart.php?carttpl=standard_cart.8. Customization and branding
Nebulix uses CSS variables and reusable assets for color, spacing, rounded cards, gradients, and cloud-hosting visual style.
Main design variables
--brand-primary
--brand-primary-rgb
--brand-accent
--brand-accent-rgb
--gradient-primary
--gradient-primary-hover
--surface-page
--surface-card
--text-main
--text-secondary
--border-soft#5b5cf6 and #7d6bff. Additional theme previews are available from the color buttons in this documentation page.Files commonly edited
/templates/hostique/assets/css/custom.css | Main WHMCS client area custom styles. |
/templates/hostique/assets/js/custom.js | Theme selector, dashboard behavior, and UI scripts. |
/templates/hostique/header.tpl | Global WHMCS layout, topbar, sidebar, and header assets. |
/templates/hostique/footer.tpl | Footer scripts and closing layout wrappers. |
/templates/orderforms/standard_cart/css/ | Cart and checkout styles. |
/frontend-english/site/assets/css/ | Standalone frontend website styles. |
9. Cache, permissions, and update safety
Clear cached templates and protect customized files from accidental overwrite.
WHMCS template cache
Clear WHMCS template cache from admin utilities if available, or empty compiled files inside templates_c while keeping the directory itself.
Browser cache
Use hard refresh with Ctrl + F5. If needed, update CSS and JS query strings in template files.
File permissions
Use standard hosting permissions: folders 755, files 644. Do not set template files to world-writable.
WHMCS updates
WHMCS updates can overwrite default templates and orderforms. Keep a clean copy of Nebulix and compare files after each WHMCS upgrade.
Staging first
Test Nebulix on a staging/demo installation before applying it to production.
Rollback
Rollback by restoring backups for /templates, /templates/orderforms/standard_cart, and /modules/servers/cpanel/templates/overview.tpl.
10. Troubleshooting
Common issues after upload and the exact checks to perform.
| Issue | Most likely cause | Fix |
|---|---|---|
| WHMCS theme still looks default | The uploaded template is not active or cache is still compiled. | Select the uploaded template in WHMCS settings, clear template cache, and hard refresh the browser. |
| Theme appears as Twenty-One in admin | theme.yaml still contains the original display name. | Edit /templates/hostique/theme.yaml and set name: "Nebulix". |
| Order form still looks old | Wrong order form active or a product group override is selected. | Set default order form to Standard Cart and review every product group setting. |
| Icons show as squares | Font Awesome webfonts are missing or blocked. | Check browser Network tab for fa-solid-900.woff2 and confirm webfonts exist in the uploaded theme path. |
| CSS or JS returns 404 | Files uploaded into the wrong directory or theme path mismatch. | Confirm the WHMCS root path and verify assets open directly in the browser. |
| Frontend pages return 404 | Missing .htaccess or rewrite configuration issue. | Upload frontend-english/.htaccess and confirm server rewrite support. |
| cPanel product overview unchanged | cPanel module overview file was not overwritten. | Verify /modules/servers/cpanel/templates/overview.tpl exists and clear WHMCS cache. |
| Color changes not visible | Hardcoded colors or cached CSS. | Replace fixed colors with Nebulix CSS variables and clear browser/WHMCS cache. |
11. Final QA checklist
Use this checklist before delivering Nebulix to a customer.
- Frontend homepage opens correctly and all assets load without 404 errors.
- Frontend hosting, pricing, docs, blog, status, and contact pages work.
- WHMCS client area opens with Nebulix sidebar, topbar, cards, and responsive layout.
- Login, register, password reset, tickets, invoices, services, and domains pages display correctly.
- Product details page shows the customized cPanel overview.
- Cart, configure product, domain search, checkout, and complete pages work correctly.
- System theme is selected in WHMCS admin.
- Standard Cart is selected globally and product group overrides are checked.
- No missing CSS, JS, images, fonts, or webfonts in the browser Network tab.
- Mobile layout works below 991px and 575px widths.
- WHMCS template cache has been cleared after upload.
- A backup of original files and the Nebulix package is stored safely.
12. Official WHMCS references
Useful references for WHMCS theme and order form behavior.
13. Support handover
Recommended support message to include when delivering the package.