The branding feature allows users to customize their campaign appearance with company information, logos, and brand colors.
Features
Company Information
- Company name
- Company tagline (optional)
Logo Management
- Upload company logo (SVG, PNG, JPG, GIF up to 2MB)
- Preview uploaded logo
- Remove logo functionality
- Automatic storage management with Convex
Brand Colors
- Primary color (main brand color)
- Secondary color (accent color)
- Accent color (highlight color)
- Background color (main background)
- Text color (primary text)
Preview
- Real-time preview of branding settings
- Shows how branding will appear in campaigns
- Color swatches display
- Sample button with primary color
Technical Implementation
Database Schema
The brandingSettings
table stores:
- User association (clerkUserId)
- Company information
- Logo URL and storage ID
- Brand colors (5 customizable colors)
- Active status and timestamps
File Storage
- Logo files are stored using Convex file storage
- Automatic cleanup when logos are removed
- Secure file access with user verification
API Endpoints
getBrandingSettings
- Retrieve user's branding settingsupdateBrandingSettings
- Update branding informationuploadLogo
- Handle logo file uploadsremoveLogo
- Delete logo files
Usage Guidelines
Best Practice: Use consistent brand colors across all your campaigns to maintain brand identity and improve recognition.
- Logo files should be optimized for web use
- Brand colors should meet accessibility standards
- Test your branding with different email clients
- Keep taglines concise and impactful
Troubleshooting
Logo not displaying?
Check file size (must be under 2MB) and format (SVG, PNG, JPG, GIF only).
Colors not saving?
Ensure you're using valid hex color codes and that you have an active user session.