Before you begin
- Paymenter 1.5.8 is installed and working.
- The server runs PHP 8.3 or newer.
- You have administrator permission to install extensions and change settings.
- You can write to Paymenter’s
themes,public,storage, andbootstrap/cachepaths. - You downloaded
LucentUI-3.0.0-bundle.zipfrom your licensed source.
/var/www/paymenter as the Paymenter root. Substitute the path
used by your server.
1
Open the release bundle
Extract
LucentUI-3.0.0-bundle.zip on your computer. Keep the two inner ZIP files
intact: the theme archive is extracted on the server, while the Editor archive is
uploaded through Paymenter. Read INSTALLATION-GUIDE.md for the portable copy of
this workflow and use PACKAGE-SHA256SUMS.txt to verify both inner packages.2
Back up an existing installation
If LucentUI is already installed, back up its theme and public asset directories and
export the current Editor settings before replacing files.
3
Extract the theme package
The theme archive already contains one Confirm that
lucentui root directory./var/www/paymenter/themes/lucentui/theme.php exists. A path such as
themes/lucentui/lucentui/theme.php means the archive was extracted one level too deep.4
Publish the prebuilt assets
Copy the browser bundle stored inside the theme to Paymenter’s public directory.Confirm that
/var/www/paymenter/public/lucentui/manifest.json and
/var/www/paymenter/public/lucentui/assets/editor.svg exist. The same directory
includes locale flags, service icons, and Editor card previews; no separate asset
download or external image host is required.5
Upload LucentUI Editor
In Paymenter Admin, open Extensions → Available Extensions → Ready to Install /
Upload, select Upload Extension, and upload
LucentUIEditor-3.0.0-upload.zip.Upload the ZIP itself. Its LucentUIEditor.php file must remain at the archive root
for Paymenter to detect it.6
Install and enable the Editor
After upload, stay on Ready to Install / Upload. Click Install beside
LucentUI Editor. On the extension edit page, turn on Enabled and save.
7
Activate the theme
Open Paymenter’s administrator settings, find Theme, choose
lucentui, and save.
Then clear framework caches from the Paymenter root:8
Complete the smoke test
Open the homepage, sign-in page, product catalogue, client dashboard, and LucentUI
Editor. Test light and dark mode, then check the browser console for errors.
Installation is complete when the storefront is styled, LucentUI Editor appears under
the Extensions navigation, and both
/lucentui/manifest.json and
/lucentui/assets/editor.svg return successfully.Developer-only asset build
Run a frontend build only after changing LucentUI CSS or JavaScript source:node vite.js lucentui, not npm run build lucentui.
Next: configure the Editor
Learn how draft previews, saving, presets, exports, imports, and reset protection work.