Branding — name, logo, colours, hero
Operator guide
Branding — name, logo, colours, hero
Every node can look like its own brand. All branding lives in the admin panel at Settings → Branding and is applied live to the public site and the admin panel — no code changes.
What you can set
| Setting | What it affects |
|---|---|
| Site name | Header, page titles, admin brand |
| Logo | Public header + admin panel brand |
| Favicon | Browser tab icon |
| Hero image | Landing page background |
| Hero headline | Landing page H1 |
| Hero subtext | Landing page lead paragraph |
| Primary / secondary / link colour | Theme palette + admin accent |
| Footer copyright | Public site footer |
Official branding lives in the separate
vulasocial-websiterepo (charlesash-za/vulasocial-website): generated logo, favicon, hero and social-share images (violet→blue "joined hands" theme). Upload them via Settings → Branding, or reference them from the marketing page docroot on vulasocial.com.
Image guidelines
| Image | Recommended | Formats | Max |
|---|---|---|---|
| Logo | 512×512 px | PNG, SVG, WebP, JPEG | 2 MB |
| Favicon | 64×64 px | PNG, ICO, SVG | 512 KB |
| Hero image | 1920×1080 px (16:9) | PNG, JPEG, WebP | 5 MB |
Download a compliant sample from the admin page — each upload field has a "Download sample" link that gives you a ready-to-edit template at the exact recommended size and format. Edit it in any image editor and upload.
- Transparent backgrounds are best for logos/favicons.
- Keep text centred in the hero — edges get cropped on mobile.
Colours
Pick any hex value. The primary colour drives the admin panel accent and the
public theme's buttons/links. The theme also exposes CSS variables
(--os-primary, --os-link, etc.) for deeper customisation via a custom
theme.
How it's wired
App\Support\SiteBrandresolves every value fromBrandingSettingswith sensible defaults (so a fresh install shows "VulaSocial" branding even before an admin saves anything).- Both Filament panels (
admin+app) read the brand name/logo/favicon/colour at boot. - The public layout injects the colours as CSS custom properties
(
resources/views/partials/branding-css.blade.php). - Themed pages use
App\Support\ThemeColors::forSite()when a theme is active.
Defaults (shipped)
site_name => 'VulaSocial'
hero_headline => 'Social media, reinvented — by the people, for the people.'
hero_subtext => 'VulaSocial is the Facebook-style network you remember…'
primary_color => '#6366f1'
secondary_color => '#8b5cf6'
link_color => '#2563eb'
footer_copyright => '© VulaSocial. All rights reserved.'
Troubleshooting
| Symptom | Likely fix |
|---|---|
| Saving branding errors "null to property…" | Up-to-date code required — the nullable-path fix shipped in 2026-09-27 builds |
| Logo doesn't appear | Upload is on the media disk — confirm it exists (local /storage/brand/… or the cloud bucket) |
| Colour doesn't change | Browser cache — hard refresh; confirm hex is valid |
Related
- Media storage (where logo/hero files live)
- First-run setup
Still stuck? Contact the node administrator.