Реалізація White-Label версії веб-застосунку

White-Label веб-приложение

White-label дозволяє клієнтам продавати ваш продукт під своїм брендом: власний домен, логотип, кольори, email-шаблони. Користувачі клієнта не знають про вашу платформу.

Архітектура White-Label

Два підходи до ізоляції:

По субдомену — acme.yourplatform.com або app.acmecorp.com (custom domain)

По записам DNS — клієнт додає CNAME: app.acmecorp.com → yourplatform.com

// middleware.ts: визначаємо тенанта по домену
export async function middleware(request: NextRequest) {
  const hostname = request.headers.get('host')!;
  const domain = hostname.replace(':3000', '');

  const tenant = await getTenantByDomain(domain);
  if (!tenant) {
    return NextResponse.rewrite(new URL('/404', request.url));
  }

  const response = NextResponse.next();
  response.headers.set('x-tenant-id', tenant.id);
  response.headers.set('x-tenant-slug', tenant.slug);
  return response;
}

Custom Domain: верифікація

export async function verifyCustomDomain(tenantId: string, domain: string) {
  const dns = await import('dns/promises');

  let cnameTarget: string;
  try {
    const records = await dns.resolveCname(domain);
    cnameTarget = records[0];
  } catch {
    return { verified: false, error: 'CNAME not found' };
  }

  const expectedCname = `${process.env.PLATFORM_DOMAIN}`;
  if (cnameTarget !== expectedCname) {
    return {
      verified: false,
      error: `CNAME must point to ${expectedCname}, found: ${cnameTarget}`
    };
  }

  await db.tenant.update({
    where: { id: tenantId },
    data: {
      customDomain: domain,
      customDomainVerifiedAt: new Date(),
    }
  });

  await addCloudflareCustomHostname(domain, tenantId);
  return { verified: true };
}

Брендинг: конфігурація тенанта

model TenantBranding {
  id              String  @id @default(cuid())
  tenantId        String  @unique
  logoUrl         String?
  faviconUrl      String?
  appName         String
  primaryColor    String  @default("#6366f1")
  secondaryColor  String  @default("#f1f5f9")
  fontFamily      String  @default("Inter")
  supportEmail    String?
  supportUrl      String?
  privacyUrl      String?
  termsUrl        String?
  footerText      String?
  hideWatermark   Boolean @default(false)
  customCss       String? @db.Text
  emailFromName   String?
  emailFromAddress String?
  emailLogoUrl    String?
}

export function TenantStylesheet({ branding }: { branding: TenantBranding }) {
  const css = `
    :root {
      --color-primary: ${branding.primaryColor};
      --color-secondary: ${branding.secondaryColor};
      --font-family: '${branding.fontFamily}', sans-serif;
    }
    ${branding.customCss ?? ''}
  `;

  return <style dangerouslySetInnerHTML={{ __html: css }} />;
}

// app/layout.tsx: динамічна метаінформація
export async function generateMetadata(): Promise<Metadata> {
  const tenantId = headers().get('x-tenant-id');
  const branding = await db.tenantBranding.findUnique({
    where: { tenantId: tenantId! }
  });

  return {
    title: branding?.appName ?? 'App',
    icons: { icon: branding?.faviconUrl ?? '/favicon.ico' },
  };
}

Email-шаблони з брендингом

export async function sendBrandedEmail(
  tenantId: string,
  to: string,
  template: string,
  variables: Record<string, string>
) {
  const branding = await db.tenantBranding.findUnique({
    where: { tenantId }
  });

  await resend.emails.send({
    from: branding?.emailFromAddress
      ? `${branding.emailFromName} <${branding.emailFromAddress}>`
      : `[email protected]`,
    to,
    subject: variables.subject,
    react: EmailTemplate({
      ...variables,
      logoUrl: branding?.emailLogoUrl,
      brandColor: branding?.primaryColor ?? '#6366f1',
      appName: branding?.appName ?? 'App',
      footerText: branding?.footerText,
    }),
  });
}

Розробка white-label системи з custom domains, брендингом та email-шаблонами — 5–10 робочих днів.