> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tariqdev.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Updating LucentUI

> How to update LucentUI to the latest version manually or via PTB.

# 🔄 Updating LucentUI

LucentUI receives updates regularly to bring new UI improvements, fixes, and compatibility with the latest Paymenter versions.

You can update the theme using **manual update** or using the recommended **PTB (.paytheme)** method.

***

## ⚙️ Manual Update

This is the standard method if you installed LucentUI from a ZIP file.

<Steps>
  <Step title="Download the latest ZIP">
    Get the latest version of `lucentui.zip` from your purchase source.
  </Step>

  <Step title="Upload and overwrite">
    Replace the existing theme directory:

    ```bash theme={null}
    mv lucentui.zip /var/www/paymenter/themes
    cd /var/www/paymenter/themes
    unzip -o lucentui.zip
    ```

    The `-o` flag will **overwrite** the previous files with the new ones.
  </Step>

  <Step title="Rebuild the theme">
    After replacing the files, navigate to your Paymenter root and rebuild assets:

    ```bash theme={null}
    cd /var/www/paymenter
    npm run build lucentui
    ```
  </Step>
</Steps>

## <Warning>Skipping the build step may result in a **500 Internal Server Error**.</Warning>

## 🧪 Checking Version

You can verify that the update was successful by checking your theme’s admin settings page, the `theme.php` file or the Admin Footer.

***

## 📌 Notes

* Custom changes will be **overwritten** unless you've backed them up.
* Always **backup your theme files** and database before updating.
* Read the latest [changelogs](/lucentui/changelogs) for what's new.

***

## 🚨 Troubleshooting

* **500 Internal Server Error**?
  → Re-run `npm run build lucentui` and clear your browser cache.

* **Missing Styles or Broken Layouts?**
  → Ensure assets were rebuilt correctly and check for version compatibility.