White-Label / Branding

Quick rebrand checklist (5 minutes)

To turn MailTrixy into “Acme Corp” (or whatever your brand is):

1. Admin → Settings → General — set Site Name (e.g. “Acme Corp”). This single field flows everywhere.
2. Admin → Settings → Branding — upload your logo (light + dark), set primary/secondary brand colors, upload favicon.
3. Admin → Theme Studio — fine-tune all 13 colors per mode (light + dark). See the Theme Studio page.
4. Admin → Settings → General → Body Font — pick a Google Font that matches your brand.
5. Admin → Settings → Company — fill in legal entity name, address, Tax ID/VAT for invoices.
6. Admin → Settings → SMTP — set From Address to your brand domain (e.g. noreply@acme.com).
7. .env — set APP_URL=https://app.acme.com and APP_NAME="Acme Corp". Run php artisan config:clear.
8. Open an incognito tab and load your site. Every page now reads “Acme Corp”, your logo, your colors, your font.

What gets rebranded automatically

Setting Site Name once flips the brand name on every user-visible surface:

Frontend / public

• Marketing landing page (header logo, footer copyright, hero copy, testimonial demos, AI demo)
• Login + register pages
• Page <title> tags everywhere
• PWA install prompt & manifest
• Robots.txt sitemap URL (derives from APP_URL)

User dashboard

• Sidebar brand mark + name
• Onboarding wizard steps
• Inbox header
• “Get the most out of {brand}” on the dashboard
• “When this fires, {brand} will...” on AI workflow descriptions
• Workspace slug prefix (e.g. app.acme.com/your-workspace)
• Email account placeholders (e.g. support@acme.com)

Admin panel

• Admin sidebar brand
• Theme Studio preview card label
• Admin update screen error toasts
• AI providers Pinecone placeholder (e.g. acme-knowledge)
• Default support/noreply email placeholders

Content & emails

• All 20+ help articles in the help center (rewritten at read time via model accessor)
• SaaS email templates that mention the platform name
• Referral program template URL (uses {platform_url} token)

Billing & exports

• Invoice PDF header brand mark + footer
• Invoice HTML preview
• GDPR data export filename (e.g. acme-corp-export-2026-05-28-093015.json)
• Database backup SQL header comment

Integrations

• Slack /help command response (uses the actual slash command name from the inbound payload)
• Live chat widget “Powered by” (or hidden entirely if show_branding is off)

Per-workspace white-label (hide “Powered by”)

If you sell the platform B2B and want individual customers to hide the “Powered by {your brand}” credit:

1. Admin → Plans → pick a paid plan → enable the White-Label feature flag.
2. Customers on that plan see no “Powered by” in the chat widget or anywhere it might appear.
3. Lower-tier plans still see the credit (typical SaaS pattern — charge for white-label).

How the system works under the hood

All of this is powered by a small helper class, App\Helpers\BrandingHelper, with four methods:

• BrandingHelper::name() — returns Site Name setting, falls back to config('app.name'), falls back to literal “MailTrixy” (only on a fresh DB-less install).
• BrandingHelper::host() — parsed host from APP_URL (e.g. app.acme.com). Used for the workspace slug prefix.
• BrandingHelper::rootDomain() — strips app. / www. to get the bare domain (e.g. acme.com). Used for email placeholders.
• BrandingHelper::emailPlaceholder($local) — returns e.g. support@acme.com.

Help articles run through a model accessor (HelpArticle::getContentAttribute) that rewrites {brand} tokens AND literal “MailTrixy” to the current Site Name at read time. So even articles written when the platform was named “MailTrixy” instantly become “Acme Corp” articles after rebrand — no re-seeding needed.