Cloud Hosting WHMCS Template

# 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.

Start installation Frontend demo WHMCS demo
371 Total files in package
31.1 MB Total uncompressed size
39 Frontend website files
2 Order form folders

## 1. Demo and purchase links

Use these links to preview Nebulix, test the client area, and purchase the template.

### Frontend Demo

https://hostk.com/nebulix-demo/frontend-english

### WHMCS Client Area Demo

https://hostk.com/nebulix-demo/clientarea.php

### Demo Login

Email: `test@hostk.com`
Password: `test`

### Purchase Nebulix

Buy Nebulix Cloud WHMCS Template

## 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.

The archive is structured to be uploaded into the WHMCS installation root for WHMCS files. The `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.

1

### Extract the package locally

Extract the zip file on your computer. The frontend website is located inside `frontend-english/`.

2

### 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/`.

3

### 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/

4

### Test frontend pages

Open the homepage, pricing, contact, docs, status, hosting, and solution pages. Check links, buttons, responsive layout, and domain search forms.

If frontend routes return 404 after upload, confirm the `.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.

1

### Open the WHMCS root directory

This is the folder that contains `configuration.php`, `clientarea.php`, `cart.php`, `templates`, and `modules`.

2

### Upload template folders

Upload the package `templates` folder directly into the WHMCS root. Allow overwrite only after confirming you have a backup.

3

### Upload module override

Upload the package `modules` folder into the WHMCS root to apply the cPanel product overview customization.

4

### 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.tpl

The included WHMCS template folder is `templates/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.

1. Login to the WHMCS Admin Area.
2. Go to `Configuration` then `System Settings` then `General Settings`.
3. Open the `General` tab.
4. Select the uploaded client area template folder, usually `hostique`, as the system theme/template.
5. Save changes and open `clientarea.php` in a new private browser window.

If the theme dropdown displays the name as Twenty-One, open `/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.

A

### 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`.

B

### 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`.

C

### 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.

For testing, you can force the cart template using a URL parameter such as `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

Default Nebulix colors are blue-violet: `#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.

- WHMCS Themes and Templates documentation
- WHMCS Order Form Templates settings
- WHMCS Developer Order Form Templates guide
- WHMCS Developer Theme Customising guide

## 13. Support handover

Recommended support message to include when delivering the package.

Thank you for choosing Nebulix. Please follow this documentation carefully for installation, activation, cache clearing, and final testing. If you need professional installation, branding, or WHMCS customization, our team can assist you with setup and delivery.