> For the complete documentation index, see [llms.txt](https://codehas.gitbook.io/repair-shop-solution/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codehas.gitbook.io/repair-shop-solution/settings/app-setup.md).

# ⚙️ App Setup

The App Setup section gives you complete control over how your Ultimate RepairShop system behaves. From enabling essential modules and security preferences to customizing branding and regional configurations—this is your centralized command center.

{% hint style="success" %}

#### 🧩 Are you looking for a customised or professional version?

For customized solutions, feel free to contact us at <info.codehas@gmail.com>. Check out our PRO version [here](https://codehas.gitbook.io/ultimate-repair-shop-pro/live-demo).
{% endhint %}

***

### 🌍 General Information

<figure><img src="https://1520645644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vuCQmbsftLHMwQ8eyLY%2Fuploads%2FdYWut4J6cyBkSNKk99eD%2Fimage.png?alt=media&amp;token=b93a5e86-b90f-40d4-b89e-4f283853c8ed" alt=""><figcaption></figcaption></figure>

Basic information used across invoices, reports, and notifications:

| Field     | Example               |
| --------- | --------------------- |
| App URL   | Default app URL       |
| App Name  | Your business name    |
| App Phone | Your business phone   |
| Address   | Your business address |

> This information is visible across printed documents, reports, and emails.

***

### 🔒 HTTPS Enforcement

* Force To HTTPS:

  Toggle to ensure all requests are securely redirected to HTTPS. This helps improve security and user trust.

***

### 🧩 Interface Preferences

| Setting              | Purpose                                                |
| -------------------- | ------------------------------------------------------ |
| Variant Tab Maximize | Expands the product variant interface by default.      |
| User Registration    | Allow or block public user registrations.              |
| Default Role         | Set which role is assigned to new users (e.g., Agent). |

***

### 🎨 Appearance Customization

<figure><img src="https://1520645644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vuCQmbsftLHMwQ8eyLY%2Fuploads%2FLlVcn6vNFZNkUeWfwI3L%2Fimage.png?alt=media&amp;token=aa9f09d7-2308-475e-b647-1c044fd752ee" alt=""><figcaption></figcaption></figure>

Make your app truly yours with branding elements:

| Field      | Description                                                   |
| ---------- | ------------------------------------------------------------- |
| Logo       | Upload your business logo (used on login page, POS, reports). |
| Background | Set a background image for the login screen or homepage.      |

***

### 🕒 Time & Date Configuration

<figure><img src="https://1520645644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vuCQmbsftLHMwQ8eyLY%2Fuploads%2FC9m0HoWv38Ttv0d3MDFT%2Fimage.png?alt=media&amp;token=27dfd3c3-e2f4-4e38-85ff-3f3f9b5cac70" alt=""><figcaption></figcaption></figure>

#### Timezone

* Set your local timezone (e.g., UTC, Asia/Kolkata, America/Denver)
* Used across reports, logs, and invoices.

Sure! Here’s a visual-friendly Date & Time Format guide that includes example output for each format, based on this datetime:

<br>

> 🗓️ Assumed Date & Time: July 17, 2025, 3:45:07 PM (UTC+0)

***

### 📅 Date Formats

| Format | Example Output |
| ------ | -------------- |
| d-m-Y  | 17-07-2025     |
| Y-m-d  | 2025-07-17     |
| Y/m/d  | 2025/07/17     |
| d/m/Y  | 17/07/2025     |

### ⏰ Date & Time Formats

| Format      | Example Output      |
| ----------- | ------------------- |
| d-m-Y H:i:s | 17-07-2025 15:45:07 |
| Y-m-d H:i:s | 2025-07-17 15:45:07 |
| Y/m/d H:i:s | 2025/07/17 15:45:07 |
| d/m/Y H:i:s | 17/07/2025 15:45:07 |

### 🗓️ Named Formats

| Format  | Example Output  |
| ------- | --------------- |
| d D M Y | 17 Thu Jul 2025 |
| Y M D d | 2025 Jul Thu 17 |
| d F Y   | 17 July 2025    |
| F d, Y  | July 17, 2025   |

### 🧠 Fancy Date-Time Formats

| Format         | Example Output            |
| -------------- | ------------------------- |
| d D M Y, h:i:s | 17 Thu Jul 2025, 03:45:07 |
| d D M Y h:i:s  | 17 Thu Jul 2025 03:45:07  |
| Y M D d, h:i:s | 2025 Jul Thu 17, 03:45:07 |
| Y M D d h:i:s  | 2025 Jul Thu 17 03:45:07  |

### 🕔 Time Only

| Format | Example Output |
| ------ | -------------- |
| H:i:s  | 15:45:07       |
| g:i A  | 3:45 PM        |

### ⏳ With Timezone

| Format        | Example Output          |
| ------------- | ----------------------- |
| Y-m-d H:i:s T | 2025-07-17 15:45:07 UTC |

### ✨ Custom Formats

| Format          | Example Output                  |
| --------------- | ------------------------------- |
| l, d M Y        | Thursday, 17 Jul 2025           |
| Y F d           | 2025 July 17                    |
| M d, Y          | Jul 17, 2025                    |
| g:i A, l F d, Y | 3:45 PM, Thursday July 17, 2025 |

***

### 🔐 Security Captcha (Google reCaptcha v3)<br>

<figure><img src="https://1520645644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vuCQmbsftLHMwQ8eyLY%2Fuploads%2FnSIE4xWXnX4B17BnbiqO%2Fimage.png?alt=media&amp;token=f993662e-d1b7-4004-b410-f7f840aefa63" alt=""><figcaption></figcaption></figure>

Block spam and bot form submissions across public-facing areas.

#### Configuration Steps:

1. Go to [Google reCaptcha Admin Panel](https://www.google.com/recaptcha/admin/create)
2. Register your domain and get keys for reCaptcha v3
3. Fill the following fields:

| Field                | Description                          |
| -------------------- | ------------------------------------ |
| reCaptcha Status     | Toggle ON/OFF                        |
| reCaptcha Site Key   | Public key for frontend verification |
| reCaptcha Secret Key | Private key used in backend          |

> Once enabled, forms like repair booking, contact, and buy forms will be protected silently without bothering real users.

***

### 📌 Final Tips

* Save your changes using the Save button at the bottom of the App Setup page.
* Any misconfiguration may affect visibility, reports, or invoice accuracy, so double-check all formatting and credentials.