⚙️ App Configurations

The App Configs panel allows administrators to fine-tune core operational settings across Point of Sale, Email, SMS, WhatsApp, and Notification services. These settings enhance the flexibility, performance, and communication workflows of the Ultimate RepairShop platform.


🛒 Point of Sale (POS) Settings

Customize your POS behavior and layout for optimal usability.

Setting

Description

Reset to Default

Reverts POS settings to the original default values.

Scanner Focus Auto-Focus

Enable/disable automatic barcode scanner focus on load.

Auto-Focus Duration

Set duration (in ms) before scanner input autofocuses. (Default: 500ms)

Scanner Processing Delay

Delay after scanning a barcode to avoid duplication. (Default: 700ms)

Default Warehouse

Select the warehouse used by default in POS.

Display Categories at POS

Number of categories shown at a time. (e.g., 20)

Display Products at POS

Number of products shown at a time. (e.g., 20)

Default POS Layout

Choose your preferred layout (Layout One, Layout Two, etc.).

Quick Monies

Predefined quick-cash buttons. (Example: 100,500,1000,5000 — use 0 to disable)


💰 Currency & Display

Control how currency and numerical values are formatted in the app.

Setting

Description

Currency Symbol

Symbol used for currency display. (e.g., $)

Display Side

Choose Left or Right to position the symbol.

Decimals Display

Show prices with decimals. (Enabled/Disabled)

Spacing

Enable/disable space between currency symbol and amount.

Shorthand Notation

Enable short format (e.g., 5k for 5,000).


✉️ Outgoing Mail Setup

Choose how system emails are sent. Supported methods include SMTP, Mailgun, and Sendmail.

🔐 Common Fields

Field

Description

Sending Email

Email used to send messages.

Sender Name

Display name of the sender.

Outgoing Mail Method

Select between SMTP, Mailgun, or Sendmail.

📡 SMTP Settings

Field

Description

Mail Host

Your SMTP server (e.g., smtp.gmail.com)

Mail Username

SMTP login email

Mail Password

SMTP password or app key

Port

e.g., 587 (TLS), 465 (SSL)

Encryption

tls, ssl, or leave blank

☁️ Mailgun Settings

Field

Description

Mailgun Domain

Domain configured in Mailgun

Mailgun Endpoint

API region endpoint

Mailgun Secret

Private API key

🛠 Sendmail

No config needed. Make sure Sendmail is available on your server.


📞 WhatsApp (Twilio) Setup

Enable WhatsApp alerts via the Twilio WhatsApp API.

Field

Description

Status

Enable or disable WhatsApp messaging

Account SID

Twilio Account SID

Auth Token

Twilio Auth Token

From Number

Twilio-provided WhatsApp number


📱 SMS Gateway Setup

SMS alerts can be sent via Nexmo (Vonage) or Twilio.

Field

Description

Status

Enable or disable SMS notifications

SMS Channel

Choose Nexmo/Vonage or Twilio

Nexmo/Vonage Config

Field

Description

Key

Nexmo API key

Secret

Nexmo API secret

From

Sender ID (usually your app or brand name)

Twilio setup follows a similar format (SID, Token, From) if selected.


🔔 Notification Management

Control how and when notifications are sent across modules. Each module supports Email, SMS, and WhatsApp. All channels are toggleable — enable only what you use.

Processing Method

Option

Description

Send Synchronously

Notifications are processed in real time.

Send Asynchronously (Queue)

Processed in the background to save time and speed up response.

Notification Modules

Module

Email

SMS

WhatsApp

Repair

✅ Enabled/Disabled

✅ Enabled/Disabled

✅ Enabled/Disabled

Sales

✅ Enabled/Disabled

✅ Enabled/Disabled

✅ Enabled/Disabled

Sales Return

✅ Enabled/Disabled

✅ Enabled/Disabled

✅ Enabled/Disabled

Custom Bills

✅ Enabled/Disabled

✅ Enabled/Disabled

✅ Enabled/Disabled

Custom Products

✅ Enabled/Disabled

✅ Enabled/Disabled

✅ Enabled/Disabled

Online Repair Created

✅ Enabled

✅ Enabled

❌ Disabled

Online Repair Updated

✅ Enabled

✅ Enabled

❌ Disabled

Online Buy Order Created

✅ Enabled

✅ Enabled

❌ Disabled

Online Buy Order Updated

✅ Enabled

✅ Enabled

✅ Enabled

⚠️ The ✅/❌ above shows availability, not hardcoded enablement. You can toggle them inside the app.