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

# General Settings

> Customize LucentUI behavior and visual appearance through the available settings.

# ⚙️ General Settings

LucentUI offers several built-in settings to help you tailor the user experience. You can configure these options via the **Admin Panel → Settings → Theme Settings** section.

Each setting below can enhance performance, improve UX, or adjust visuals based on your brand or preference.

***

## 🛒 Checkout Behavior

<Expandable title="Checkout Behavior Settings">
  ### **Direct Checkout**

  * **Setting Name**: `direct_checkout`
  * **Type**: Checkbox
  * **Default**: `false`

  If enabled, customers will be taken **directly to the checkout page** when clicking a product—skipping the product detail page entirely.

  <Info>Recommended for simple product offerings or one-click purchases.</Info>
</Expandable>

***

## 🖼️ Category Display Options

<Expandable title="Category Display Settings">
  ### **Show Category Image Banner**

  * **Setting Name**: `show_category_image_banner`
  * **Type**: Checkbox
  * **Default**: `true`

  Displays the image set for a category as a **wide banner** on the top of the product list page.

  ### **Show Category Description**

  * **Setting Name**: `show_category_description`
  * **Type**: Checkbox
  * **Default**: `true`

  Displays a **textual description or banner** underneath the category title.

  ### **Small Images**

  * **Setting Name**: `small_images`
  * **Type**: Checkbox
  * **Default**: `false`

  Reduces image size for product thumbnails. Useful for minimalist or grid-style layouts.
</Expandable>

***

## 🌌 Background Customization

<Expandable title="Background Customization Settings">
  ### **Background Image URL**

  * **Setting Name**: `background_image_url`
  * **Type**: Text
  * **Default**: `""`

  Allows you to set a **custom background image** via a direct URL.\
  Recommended image size: `1920x1080` or larger.

  ### **Background Image Opacity**

  * **Setting Name**: `background_image_opacity`
  * **Type**: Text
  * **Default**: `30`

  Set the **opacity level** of the background image.\
  Range: `0` (fully transparent) to `100` (fully opaque).

  ### **Background Image Blur**

  * **Setting Name**: `background_image_blur`
  * **Type**: Text
  * **Default**: `5`

  Applies a blur effect to the background image.\
  Range: `0px` (no blur) to `20px`.
</Expandable>

***

## 📝 Notes

* All changes take effect **immediately after saving** in the Paymenter admin panel.
* You can mix both **color + image backgrounds** to achieve a glassmorphic effect.
* Use URLs from **reliable sources** (e.g., your own hosting, imgur/CDN, etc.) for background images.

***

<Info>
  More settings will be added in future versions. Join [Zaqua Discord](https://discord.gg/UYMrM8kDne) for sneak peeks and support.
</Info>