Customization Guide

Customize Appy's branding and email templates to match your brand identity.

Branding

Customize Appy's visual identity to match your brand. Navigate to Admin > Settings > General Settings.

Site Logo

Upload your company logo to appear throughout the platform:

• Recommended format: PNG or SVG
• Recommended size: Maximum height 40-50px
• Background: Transparent preferred
• Where it appears: Header, login page, emails, invoices

Favicon

Set a custom favicon for browser tabs:

• Format: ICO, PNG, or SVG
• Size: 16x16px or 32x32px (can be larger, will be scaled)
• Tip: Use a simple, recognizable icon that works at small sizes

Site Name

Your platform name appears in:

• Browser title tags
• Email templates
• Footer copyright notices
• Email subject lines

Site Description

A brief description of your platform:

• Used for SEO meta descriptions
• Displayed on public pages if enabled
• Keep it under 160 characters for best SEO

Color Scheme

While Appy uses Tailwind CSS with a default blue theme, you can customize colors by modifying the Tailwind configuration:

1. Edit tailwind.config.js in your installation directory
2. Modify the primary color palette
3. Run npm run build to recompile assets

Email Templates

Customize automated emails to match your brand voice and style. Go to Admin > Email Templates.

Available Templates

Appy includes templates for common email notifications:

• Welcome Email: Sent when new users register
• Password Reset: Password recovery instructions
• Email Verification: Confirm email address
• Subscription Confirmation: Payment successful
• Subscription Canceled: Subscription ended
• Build Completed: App build ready to download
• Build Failed: Build encountered an error
• Credits Low: Running low on build credits
• Credits Depleted: No build credits remaining

Editing Templates

Available Variables

Use these variables in subject lines and body content:

HTML Formatting

Email templates support HTML for rich formatting:

<h2>Welcome to {site_name}!</h2>
<p>Hello <strong>{user_name}</strong>,</p>
<p>Thank you for joining our platform.</p>
<a href="{site_url}">Get Started</a>

Testing Templates

Some templates include a preview feature:

1. Click Preview to see how the email looks
2. Variables are filled with sample data
3. Check formatting on both desktop and mobile views

Resetting Templates

If you want to restore the default template:

1. Click Reset to Default
2. Confirm the action
3. Your customizations will be permanently lost

Localization

Appy supports multiple languages. You can add new languages by creating translation files and registering the language in the admin panel.

Adding a New Language

Follow these steps to add a new language to your Appy installation:

# Example: Adding Spanish (es)
cp -r lang/en lang/es

# Example: Adding Portuguese (pt)
cp -r lang/en lang/pt

// lang/es/auth.php
return [
    'failed' => 'Estas credenciales no coinciden con nuestros registros.',
    'password' => 'La contraseña es incorrecta.',
    'throttle' => 'Demasiados intentos de inicio de sesión. Intente de nuevo en :seconds segundos.',
];

Translation Tips

• Keep placeholders intact: Variables like :attribute, :seconds, or :max are replaced dynamically. Don't translate them.
• Maintain PHP syntax: Keep the array structure, quotes, and semicolons intact.
• Test thoroughly: After adding a language, switch to it and navigate through the app to verify translations.
• Use UTF-8 encoding: Save all files with UTF-8 encoding to support special characters.

RTL Language Support

Appy supports right-to-left (RTL) languages like Arabic, Hebrew, and Persian. RTL is automatically enabled based on the language code. Currently supported RTL languages:

• Arabic (ar)
• Hebrew (he)
• Persian/Farsi (fa)
• Urdu (ur)

When users select an RTL language, the interface automatically adjusts text direction, alignment, and layout.