Skip to content

ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.

feat: brand-neutral public title + per-install favicon tint

Juan Denis882b7bb8e2c8
diff --git a/backend/app/api/auth.py b/backend/app/api/auth.py
index 6fd7f88e..cc2eacec 100644
--- a/backend/app/api/auth.py
+++ b/backend/app/api/auth.py
@@ -44,6 +44,7 @@ def get_setup_status():
'password_login_enabled': password_login_enabled,
# Pre-auth branding (read by the login page before any authed call).
'panel_title': SettingsService.get('panel_title', 'ServerKit'),
+ 'public_title': SettingsService.get('public_title', 'Control Panel'),
'login_layout': SettingsService.get('login_layout', 'centered'),
'needs_migration': migration_status['needs_migration'],
'migration_info': {
diff --git a/backend/app/services/settings_service.py b/backend/app/services/settings_service.py
index 0e4e2f75..988e0843 100644
--- a/backend/app/services/settings_service.py
+++ b/backend/app/services/settings_service.py
@@ -27,7 +27,12 @@ class SettingsService:
'panel_title': {
'value': 'ServerKit',
'type': 'string',
- 'description': 'Display name shown in the browser tab and on the auth pages'
+ 'description': 'Display name shown in the browser tab once signed in'
+ },
+ 'public_title': {
+ 'value': 'Control Panel',
+ 'type': 'string',
+ 'description': 'Generic name shown on the public sign-in/register pages (kept brand-neutral on purpose)'
},
'login_layout': {
'value': 'centered',
diff --git a/frontend/index.html b/frontend/index.html
index 348c8d98..ee285aae 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -8,8 +8,8 @@
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png" />
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
- <meta name="description" content="ServerKit - Server Management Dashboard" />
- <title>ServerKit</title>
+ <meta name="description" content="Control Panel" />
+ <title>Control Panel</title>
<!-- Fonts are SELF-HOSTED (see src/styles/base/_fonts.scss → /fonts/*.woff2).
No Google Fonts / third-party CDN: a self-hosted control panel must not
leak every user's IP + usage to Google. Falls back to system-ui until
diff --git a/frontend/public/favicon.svg b/frontend/public/favicon.svg
index c198cd50..630ab9ca 100644
--- a/frontend/public/favicon.svg
+++ b/frontend/public/favicon.svg
@@ -1,11 +1,8 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" fill="none">
- <defs>
- <linearGradient id="skFavTile" x1="0" y1="0" x2="32" y2="32" gradientUnits="userSpaceOnUse">
- <stop stop-color="#6d7cff"/>
- <stop offset="1" stop-color="#5a67e8"/>
- </linearGradient>
- </defs>
- <rect width="32" height="32" rx="7" fill="url(#skFavTile)"/>
+ <!-- Tile fill is recolored per-install by install.sh (randomize_favicon) so a
+ favicon-hash comparison across installs differs by color while the mark
+ stays the same. If the tint step never runs, this default color ships. -->
+ <rect width="32" height="32" rx="7" fill="#5a67e8"/>
<g transform="translate(6 6) scale(0.8333)" fill="none" stroke="#ffffff" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
<rect x="2" y="2" width="20" height="8" rx="2" ry="2"/>
<rect x="2" y="14" width="20" height="8" rx="2" ry="2"/>
diff --git a/frontend/src/App.jsx b/frontend/src/App.jsx
index 7ad5ad40..20b707e8 100644
--- a/frontend/src/App.jsx
+++ b/frontend/src/App.jsx
@@ -152,7 +152,7 @@ function LegacyAppRedirect() {
function PageTitleUpdater() {
const location = useLocation();
const { page_titles: pluginTitles } = useContributions();
- const { panelTitle } = useAuth();
+ const { panelTitle, publicTitle } = useAuth();
useEffect(() => {
const path = location.pathname;
@@ -187,9 +187,11 @@ function PageTitleUpdater() {
}
}
- const brand = panelTitle || 'ServerKit';
+ // Public (pre-auth) routes stay brand-neutral; the app interior uses the panel brand.
+ const isPublicRoute = ['/login', '/register', '/setup', '/forgot'].some(p => path.startsWith(p));
+ const brand = isPublicRoute ? (publicTitle || 'Control Panel') : (panelTitle || 'ServerKit');
document.title = title ? `${title} | ${brand}` : brand;
- }, [location, pluginTitles, panelTitle]);
+ }, [location, pluginTitles, panelTitle, publicTitle]);
return null;
}
diff --git a/frontend/src/components/settings/SiteSettingsTab.jsx b/frontend/src/components/settings/SiteSettingsTab.jsx
index d4649f43..c93d6fe2 100644
--- a/frontend/src/components/settings/SiteSettingsTab.jsx
+++ b/frontend/src/components/settings/SiteSettingsTab.jsx
@@ -12,6 +12,7 @@ const SiteSettingsTab = ({ onDevModeChange }) => {
const register = useSettingFocus();
const { refreshSetupStatus } = useAuth();
const [panelTitle, setPanelTitle] = useState('ServerKit');
+ const [publicTitle, setPublicTitle] = useState('Control Panel');
const [loginLayout, setLoginLayout] = useState('centered');
const [savingBrand, setSavingBrand] = useState(false);
const [settings, setSettings] = useState({
@@ -48,6 +49,7 @@ const SiteSettingsTab = ({ onDevModeChange }) => {
});
setBasePort(String(data.managed_app_base_port ?? 0));
setPanelTitle(data.panel_title ?? 'ServerKit');
+ setPublicTitle(data.public_title ?? 'Control Panel');
setLoginLayout(data.login_layout ?? 'centered');
await loadHttps();
} catch (err) {
@@ -251,6 +253,7 @@ const SiteSettingsTab = ({ onDevModeChange }) => {
setMessage(null);
try {
await api.updateSystemSetting('panel_title', panelTitle.trim() || 'ServerKit');
+ await api.updateSystemSetting('public_title', publicTitle.trim() || 'Control Panel');
await api.updateSystemSetting('login_layout', loginLayout);
await refreshSetupStatus(); // running SPA picks up the new title live
setMessage({ type: 'success', text: 'Panel appearance saved' });
@@ -295,12 +298,31 @@ const SiteSettingsTab = ({ onDevModeChange }) => {
<div {...register('site-appearance', 'settings-card')}>
<h3>Panel Appearance</h3>
- <p>The name shown in the browser tab and on the sign-in page, plus the sign-in page layout.</p>
+ <p>Names shown in the browser tab and on the sign-in page, plus the sign-in page layout.</p>
<div className="form-group">
<div className="settings-row">
<div className="settings-label">
- <Label htmlFor="panel-title">Panel title</Label>
+ <Label htmlFor="public-title">Public sign-in title</Label>
+ </div>
+ <div className="settings-control">
+ <Input
+ id="public-title"
+ type="text"
+ value={publicTitle}
+ onChange={(e) => setPublicTitle(e.target.value)}
+ placeholder="Control Panel"
+ className="w-56"
+ />
+ </div>
+ </div>
+ <span className="form-help">Shown on the public sign-in / register pages and the browser tab before login. Kept brand-neutral by default so the panel isn&apos;t trivially identifiable.</span>
+ </div>
+
+ <div className="form-group">
+ <div className="settings-row">
+ <div className="settings-label">
+ <Label htmlFor="panel-title">Panel title (signed in)</Label>
</div>
<div className="settings-control">
<Input
@@ -313,7 +335,7 @@ const SiteSettingsTab = ({ onDevModeChange }) => {
/>
</div>
</div>
- <span className="form-help">Shown in the browser tab and as the heading on the sign-in / setup pages.</span>
+ <span className="form-help">Shown in the browser tab once signed in (the interior of the app).</span>
</div>
<div className="form-group">
diff --git a/frontend/src/contexts/AuthContext.jsx b/frontend/src/contexts/AuthContext.jsx
index 7a7bdf6c..45839559 100644
--- a/frontend/src/contexts/AuthContext.jsx
+++ b/frontend/src/contexts/AuthContext.jsx
@@ -15,6 +15,7 @@ export function AuthProvider({ children }) {
// Build-time default until the pre-auth fetch resolves (avoids a title flash
// for forks that brand at build time via VITE_PANEL_TITLE).
panelTitle: import.meta.env.VITE_PANEL_TITLE || 'ServerKit',
+ publicTitle: 'Control Panel',
loginLayout: 'centered',
needsMigration: false,
migrationInfo: null,
@@ -40,6 +41,7 @@ export function AuthProvider({ children }) {
ssoProviders: status.sso_providers || [],
passwordLoginEnabled: status.password_login_enabled !== false,
panelTitle: status.panel_title || import.meta.env.VITE_PANEL_TITLE || 'ServerKit',
+ publicTitle: status.public_title || 'Control Panel',
loginLayout: status.login_layout || 'centered',
needsMigration: status.needs_migration || false,
migrationInfo: status.migration_info || null,
@@ -91,6 +93,7 @@ export function AuthProvider({ children }) {
ssoProviders: status.sso_providers || [],
passwordLoginEnabled: status.password_login_enabled !== false,
panelTitle: status.panel_title || import.meta.env.VITE_PANEL_TITLE || 'ServerKit',
+ publicTitle: status.public_title || 'Control Panel',
loginLayout: status.login_layout || 'centered',
needsMigration: status.needs_migration || false,
migrationInfo: status.migration_info || null,
@@ -182,6 +185,7 @@ export function AuthProvider({ children }) {
ssoProviders: setupStatus.ssoProviders,
passwordLoginEnabled: setupStatus.passwordLoginEnabled,
panelTitle: setupStatus.panelTitle,
+ publicTitle: setupStatus.publicTitle,
loginLayout: setupStatus.loginLayout,
};
diff --git a/frontend/src/pages/Login.jsx b/frontend/src/pages/Login.jsx
index 7688bccd..eb7a9afd 100644
--- a/frontend/src/pages/Login.jsx
+++ b/frontend/src/pages/Login.jsx
@@ -27,7 +27,7 @@ const Login = () => {
const [useBackupCode, setUseBackupCode] = useState(false);
const [backupCode, setBackupCode] = useState('');
- const { login, setUser, setTokens, registrationEnabled, ssoProviders, passwordLoginEnabled, panelTitle } = useAuth();
+ const { login, setUser, setTokens, registrationEnabled, ssoProviders, passwordLoginEnabled, publicTitle } = useAuth();
const navigate = useNavigate();
const location = useLocation();
const [ssoLoading, setSsoLoading] = useState(null);
@@ -289,7 +289,7 @@ const Login = () => {
<div className="brand-logo">
<ServerKitLogo width={40} height={40} />
</div>
- <h1>{panelTitle}</h1>
+ <h1>{publicTitle}</h1>
<p>Signing you in…</p>
</div>
</AuthLayout>
@@ -304,7 +304,7 @@ const Login = () => {
<div className="brand-logo">
<ServerKitLogo width={40} height={40} />
</div>
- <h1>{panelTitle}</h1>
+ <h1>{publicTitle}</h1>
<p>Sign in to your account</p>
</div>
diff --git a/frontend/src/pages/Register.jsx b/frontend/src/pages/Register.jsx
index 59bf355b..3c777c06 100644
--- a/frontend/src/pages/Register.jsx
+++ b/frontend/src/pages/Register.jsx
@@ -17,7 +17,7 @@ const Register = () => {
const [inviteInfo, setInviteInfo] = useState(null);
const [inviteLoading, setInviteLoading] = useState(false);
const [inviteInvalid, setInviteInvalid] = useState(false);
- const { register, registrationEnabled, panelTitle } = useAuth();
+ const { register, registrationEnabled, publicTitle } = useAuth();
const navigate = useNavigate();
const [searchParams] = useSearchParams();
const inviteToken = searchParams.get('invite');
@@ -46,7 +46,7 @@ const Register = () => {
<div className="brand-logo">
<ServerKitLogo width={40} height={40} />
</div>
- <h1>{panelTitle}</h1>
+ <h1>{publicTitle}</h1>
<p>Registration is currently disabled</p>
</div>
<p className="auth-footer">
@@ -65,7 +65,7 @@ const Register = () => {
<div className="brand-logo">
<ServerKitLogo width={40} height={40} />
</div>
- <h1>{panelTitle}</h1>
+ <h1>{publicTitle}</h1>
<p>Validating invitation...</p>
</div>
</div>
@@ -81,7 +81,7 @@ const Register = () => {
<div className="brand-logo">
<ServerKitLogo width={40} height={40} />
</div>
- <h1>{panelTitle}</h1>
+ <h1>{publicTitle}</h1>
<p>This invitation is invalid or has expired</p>
</div>
<p className="auth-footer">
@@ -125,7 +125,7 @@ const Register = () => {
<div className="brand-logo">
<ServerKitLogo width={40} height={40} />
</div>
- <h1>{panelTitle}</h1>
+ <h1>{publicTitle}</h1>
<p>{inviteInfo ? `You've been invited as ${inviteInfo.role}` : 'Create your account'}</p>
</div>
diff --git a/frontend/src/pages/Setup.jsx b/frontend/src/pages/Setup.jsx
index 0800fa1d..fdfe4e00 100644
--- a/frontend/src/pages/Setup.jsx
+++ b/frontend/src/pages/Setup.jsx
@@ -19,7 +19,7 @@ const STEP_TITLES = [
];
const Setup = () => {
- const { isAuthenticated, completeOnboarding, panelTitle } = useAuth();
+ const { isAuthenticated, completeOnboarding, publicTitle } = useAuth();
const navigate = useNavigate();
const [currentStep, setCurrentStep] = useState(1);
@@ -118,7 +118,7 @@ const Setup = () => {
<div className="wizard-card">
<div className="wizard-header">
<ServerKitLogo className="wizard-logo" width={48} height={48} />
- <h1>Welcome to {panelTitle}</h1>
+ <h1>Welcome to {publicTitle}</h1>
<p>Let&apos;s get your server ready</p>
</div>
diff --git a/frontend/src/pages/auth/layouts/SplitHeroLayout.jsx b/frontend/src/pages/auth/layouts/SplitHeroLayout.jsx
index a0366b51..a3d65978 100644
--- a/frontend/src/pages/auth/layouts/SplitHeroLayout.jsx
+++ b/frontend/src/pages/auth/layouts/SplitHeroLayout.jsx
@@ -4,13 +4,13 @@ import { useAuth } from '../../../contexts/AuthContext';
// Split auth layout: a branded hero panel beside the form card. The hero is
// hidden on small screens (the card just centers), so it stays usable on mobile.
export default function SplitHeroLayout({ children }) {
- const { panelTitle } = useAuth();
+ const { publicTitle } = useAuth();
return (
<div className="auth-container auth-split">
<aside className="auth-split__hero" aria-hidden="true">
<div className="auth-split__brand">
<ServerKitLogo width={56} height={56} />
- <span className="auth-split__name">{panelTitle || 'ServerKit'}</span>
+ <span className="auth-split__name">{publicTitle || 'Control Panel'}</span>
</div>
</aside>
<div className="auth-card auth-split__card">{children}</div>
diff --git a/install.sh b/install.sh
index 6266d622..da5fba2c 100644
--- a/install.sh
+++ b/install.sh
@@ -1105,11 +1105,28 @@ EOF
# ---------------------------------------------------------------------------
# Frontend build (skipped on release installs)
# ---------------------------------------------------------------------------
+# Give each install a unique favicon tile color (same mark, different color) so
+# a favicon-hash comparison across ServerKit installs differs — a light-touch,
+# Cloudflare-lava-lamp-style deterrent, NOT a security control. The favicon is a
+# plain-text SVG, so this is a pure string replace: no image tooling needed, and
+# if it can't run (or the marker is absent) the shipped default color just stays.
+randomize_favicon() {
+ local fav="$INSTALL_DIR/frontend/dist/favicon.svg"
+ [ -f "$fav" ] || return 0
+ # Curated, legible tile colors (no washed-out / low-contrast picks).
+ local colors=(6d7cff 5a67e8 4f46e5 4338ca 0ea5e9 0891b2 0d9488 059669 7c3aed db2777 e11d48 ea580c)
+ local pick="${colors[$RANDOM % ${#colors[@]}]}"
+ if sed -i -E "s|(<rect width=\"32\" height=\"32\" rx=\"7\" fill=\")#[0-9a-fA-F]{3,8}(\")|\1#${pick}\2|" "$fav" 2>/dev/null; then
+ good "Favicon tint set to #${pick}"
+ fi
+}
+
build_frontend() {
phase "Frontend Build"
if [ "$INSTALL_FROM_RELEASE" = "1" ]; then
good "Using the pre-built frontend from the release."
+ randomize_favicon
return
fi
@@ -1120,6 +1137,7 @@ build_frontend() {
step "Compiling the frontend bundle..."
NODE_OPTIONS="--max-old-space-size=1024" npm run build 2>&1 | tail -5
good "Frontend built."
+ randomize_favicon
}
# ---------------------------------------------------------------------------