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: configurable panel title + switchable login layouts

Juan Denis9a1a1f69a308
diff --git a/backend/app/api/auth.py b/backend/app/api/auth.py
index 5eec30f8..6fd7f88e 100644
--- a/backend/app/api/auth.py
+++ b/backend/app/api/auth.py
@@ -42,6 +42,9 @@ def get_setup_status():
'registration_enabled': registration_enabled,
'sso_providers': sso_providers,
'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'),
+ 'login_layout': SettingsService.get('login_layout', 'centered'),
'needs_migration': migration_status['needs_migration'],
'migration_info': {
'pending_count': migration_status['pending_count'],
diff --git a/backend/app/services/settings_service.py b/backend/app/services/settings_service.py
index 06c4634f..0e4e2f75 100644
--- a/backend/app/services/settings_service.py
+++ b/backend/app/services/settings_service.py
@@ -24,6 +24,16 @@ class SettingsService:
'type': 'string',
'description': 'Name of this ServerKit instance'
},
+ 'panel_title': {
+ 'value': 'ServerKit',
+ 'type': 'string',
+ 'description': 'Display name shown in the browser tab and on the auth pages'
+ },
+ 'login_layout': {
+ 'value': 'centered',
+ 'type': 'string',
+ 'description': 'Login page layout variant: centered | split | minimal'
+ },
'audit_log_retention_days': {
'value': 90,
'type': 'integer',
diff --git a/frontend/src/App.jsx b/frontend/src/App.jsx
index ab7c963d..7ad5ad40 100644
--- a/frontend/src/App.jsx
+++ b/frontend/src/App.jsx
@@ -152,6 +152,7 @@ function LegacyAppRedirect() {
function PageTitleUpdater() {
const location = useLocation();
const { page_titles: pluginTitles } = useContributions();
+ const { panelTitle } = useAuth();
useEffect(() => {
const path = location.pathname;
@@ -182,12 +183,13 @@ function PageTitleUpdater() {
else if (path.startsWith('/servers/')) title = 'Server Details';
else if (path.startsWith('/wordpress/pipelines/') || path.startsWith('/wordpress/projects/')) title = 'WordPress Pipeline';
else if (path.startsWith('/wordpress/')) title = 'WordPress Site';
- else title = 'ServerKit';
+ else title = '';
}
}
- document.title = title ? `${title} | ServerKit` : 'ServerKit';
- }, [location, pluginTitles]);
+ const brand = panelTitle || 'ServerKit';
+ document.title = title ? `${title} | ${brand}` : brand;
+ }, [location, pluginTitles, panelTitle]);
return null;
}
diff --git a/frontend/src/components/settings/SiteSettingsTab.jsx b/frontend/src/components/settings/SiteSettingsTab.jsx
index 9b9ce7a5..d4649f43 100644
--- a/frontend/src/components/settings/SiteSettingsTab.jsx
+++ b/frontend/src/components/settings/SiteSettingsTab.jsx
@@ -6,9 +6,14 @@ import { Input } from '@/components/ui/input';
import { Button } from '@/components/ui/button';
import { Pill } from '@/components/ds';
import useSettingFocus from '../../hooks/useSettingFocus';
+import { useAuth } from '../../contexts/AuthContext';
const SiteSettingsTab = ({ onDevModeChange }) => {
const register = useSettingFocus();
+ const { refreshSetupStatus } = useAuth();
+ const [panelTitle, setPanelTitle] = useState('ServerKit');
+ const [loginLayout, setLoginLayout] = useState('centered');
+ const [savingBrand, setSavingBrand] = useState(false);
const [settings, setSettings] = useState({
registration_enabled: false,
dev_mode: false
@@ -42,6 +47,8 @@ const SiteSettingsTab = ({ onDevModeChange }) => {
dev_mode: data.dev_mode || false
});
setBasePort(String(data.managed_app_base_port ?? 0));
+ setPanelTitle(data.panel_title ?? 'ServerKit');
+ setLoginLayout(data.login_layout ?? 'centered');
await loadHttps();
} catch (err) {
console.error('Failed to load settings:', err);
@@ -239,6 +246,21 @@ const SiteSettingsTab = ({ onDevModeChange }) => {
}
}
+ async function handleSaveBrand() {
+ setSavingBrand(true);
+ setMessage(null);
+ try {
+ await api.updateSystemSetting('panel_title', panelTitle.trim() || 'ServerKit');
+ await api.updateSystemSetting('login_layout', loginLayout);
+ await refreshSetupStatus(); // running SPA picks up the new title live
+ setMessage({ type: 'success', text: 'Panel appearance saved' });
+ } catch (err) {
+ setMessage({ type: 'error', text: err.message || 'Failed to save appearance' });
+ } finally {
+ setSavingBrand(false);
+ }
+ }
+
async function handleToggleSetting(key, label) {
setSaving(true);
setMessage(null);
@@ -271,6 +293,54 @@ const SiteSettingsTab = ({ onDevModeChange }) => {
<div className={`message ${message.type}`}>{message.text}</div>
)}
+ <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>
+
+ <div className="form-group">
+ <div className="settings-row">
+ <div className="settings-label">
+ <Label htmlFor="panel-title">Panel title</Label>
+ </div>
+ <div className="settings-control">
+ <Input
+ id="panel-title"
+ type="text"
+ value={panelTitle}
+ onChange={(e) => setPanelTitle(e.target.value)}
+ placeholder="ServerKit"
+ className="w-56"
+ />
+ </div>
+ </div>
+ <span className="form-help">Shown in the browser tab and as the heading on the sign-in / setup pages.</span>
+ </div>
+
+ <div className="form-group">
+ <div className="settings-row">
+ <div className="settings-label">
+ <Label htmlFor="login-layout">Login layout</Label>
+ </div>
+ <div className="settings-control">
+ <select
+ id="login-layout"
+ className="settings-select"
+ value={loginLayout}
+ onChange={(e) => setLoginLayout(e.target.value)}
+ >
+ <option value="centered">Centered card</option>
+ <option value="split">Split hero</option>
+ <option value="minimal">Minimal</option>
+ </select>
+ <Button onClick={handleSaveBrand} disabled={savingBrand}>
+ {savingBrand ? 'Saving…' : 'Save'}
+ </Button>
+ </div>
+ </div>
+ <span className="form-help">Rearranges the sign-in page. Applies on the next load of the login page.</span>
+ </div>
+ </div>
+
<div {...register('site-registration', 'settings-card')}>
<h3>User Registration</h3>
<p>Allow new users to create accounts on the login page.</p>
diff --git a/frontend/src/contexts/AuthContext.jsx b/frontend/src/contexts/AuthContext.jsx
index 4048b1ee..7a7bdf6c 100644
--- a/frontend/src/contexts/AuthContext.jsx
+++ b/frontend/src/contexts/AuthContext.jsx
@@ -12,6 +12,10 @@ export function AuthProvider({ children }) {
registrationEnabled: false,
ssoProviders: [],
passwordLoginEnabled: true,
+ // 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',
+ loginLayout: 'centered',
needsMigration: false,
migrationInfo: null,
checked: false
@@ -35,6 +39,8 @@ export function AuthProvider({ children }) {
registrationEnabled: status.registration_enabled,
ssoProviders: status.sso_providers || [],
passwordLoginEnabled: status.password_login_enabled !== false,
+ panelTitle: status.panel_title || import.meta.env.VITE_PANEL_TITLE || 'ServerKit',
+ loginLayout: status.login_layout || 'centered',
needsMigration: status.needs_migration || false,
migrationInfo: status.migration_info || null,
checked: true
@@ -84,6 +90,8 @@ export function AuthProvider({ children }) {
registrationEnabled: status.registration_enabled,
ssoProviders: status.sso_providers || [],
passwordLoginEnabled: status.password_login_enabled !== false,
+ panelTitle: status.panel_title || import.meta.env.VITE_PANEL_TITLE || 'ServerKit',
+ loginLayout: status.login_layout || 'centered',
needsMigration: status.needs_migration || false,
migrationInfo: status.migration_info || null,
checked: true
@@ -173,6 +181,8 @@ export function AuthProvider({ children }) {
registrationEnabled: setupStatus.registrationEnabled,
ssoProviders: setupStatus.ssoProviders,
passwordLoginEnabled: setupStatus.passwordLoginEnabled,
+ panelTitle: setupStatus.panelTitle,
+ loginLayout: setupStatus.loginLayout,
};
return (
diff --git a/frontend/src/data/settingsIndex.js b/frontend/src/data/settingsIndex.js
index 44adc7e7..cbba7d07 100644
--- a/frontend/src/data/settingsIndex.js
+++ b/frontend/src/data/settingsIndex.js
@@ -58,6 +58,7 @@ export const SETTINGS_INDEX = [
{ id: 'activity-audit-log', label: 'Audit log', description: 'View a detailed audit trail of all system actions and user activities', keywords: 'audit log history actions', tab: 'activity', adminOnly: true },
{ id: 'site-registration', label: 'Public user registration', description: 'Allow or disable new user registration on the login page', keywords: 'registration public signup', tab: 'site', adminOnly: true },
+ { id: 'site-appearance', label: 'Panel title & login layout', description: 'Set the panel name shown in the browser tab and on the sign-in page, and pick the login page layout', keywords: 'title brand name login layout appearance tab centered split minimal', tab: 'site', adminOnly: true },
{ id: 'site-app-ports', label: 'Managed app ports', description: 'Control the base port assigned to new applications', keywords: 'ports app wordpress container', tab: 'site', adminOnly: true },
{ id: 'site-base-domains', label: 'Base domains', description: 'Register and manage domains for publishing managed sites', keywords: 'base domain sites registry subdomain', tab: 'site', adminOnly: true },
{ id: 'site-server-ip', label: 'Server public IP', description: 'Configure the public IP address for DNS A records', keywords: 'server public ip dns', tab: 'site', adminOnly: true },
diff --git a/frontend/src/hooks/usePageTitle.js b/frontend/src/hooks/usePageTitle.js
index c7ac1a10..af4847c7 100644
--- a/frontend/src/hooks/usePageTitle.js
+++ b/frontend/src/hooks/usePageTitle.js
@@ -1,18 +1,21 @@
import { useEffect } from 'react';
+import { useAuth } from '../contexts/AuthContext';
/**
- * Hook to set the page title
- * @param {string} title - The page title (will be appended with " | ServerKit")
+ * Hook to set the page title (suffixed with " | <panel title>")
+ * @param {string} title - The page title
*/
export function usePageTitle(title) {
+ const { panelTitle } = useAuth();
useEffect(() => {
+ const brand = panelTitle || 'ServerKit';
const previousTitle = document.title;
- document.title = title ? `${title} | ServerKit` : 'ServerKit';
+ document.title = title ? `${title} | ${brand}` : brand;
return () => {
document.title = previousTitle;
};
- }, [title]);
+ }, [title, panelTitle]);
}
export default usePageTitle;
diff --git a/frontend/src/pages/Login.jsx b/frontend/src/pages/Login.jsx
index 77addd92..7688bccd 100644
--- a/frontend/src/pages/Login.jsx
+++ b/frontend/src/pages/Login.jsx
@@ -4,6 +4,7 @@ import { useAuth } from '../contexts/AuthContext';
import api from '../services/api';
import SSOProviderIcon from '../components/SSOProviderIcon';
import ServerKitLogo from '../components/ServerKitLogo';
+import AuthLayout from './auth/AuthLayout';
import { Button } from '@/components/ui/button';
import { Input } from '@/components/ui/input';
import { Label } from '@/components/ui/label';
@@ -26,7 +27,7 @@ const Login = () => {
const [useBackupCode, setUseBackupCode] = useState(false);
const [backupCode, setBackupCode] = useState('');
- const { login, setUser, setTokens, registrationEnabled, ssoProviders, passwordLoginEnabled } = useAuth();
+ const { login, setUser, setTokens, registrationEnabled, ssoProviders, passwordLoginEnabled, panelTitle } = useAuth();
const navigate = useNavigate();
const location = useLocation();
const [ssoLoading, setSsoLoading] = useState(null);
@@ -211,8 +212,7 @@ const Login = () => {
// Render 2FA verification form
if (requires2FA) {
return (
- <div className="auth-container">
- <div className="auth-card">
+ <AuthLayout>
<div className="auth-header">
<div className="brand-logo">
<ServerKitLogo width={40} height={40} />
@@ -277,25 +277,22 @@ const Login = () => {
Back to login
</Button>
</div>
- </div>
- </div>
+ </AuthLayout>
);
}
// A one-time login link is being redeemed — show a minimal waiting card
if (redeemingLink) {
return (
- <div className="auth-container">
- <div className="auth-card">
+ <AuthLayout>
<div className="auth-header">
<div className="brand-logo">
<ServerKitLogo width={40} height={40} />
</div>
- <h1>ServerKit</h1>
+ <h1>{panelTitle}</h1>
<p>Signing you in…</p>
</div>
- </div>
- </div>
+ </AuthLayout>
);
}
@@ -307,7 +304,7 @@ const Login = () => {
<div className="brand-logo">
<ServerKitLogo width={40} height={40} />
</div>
- <h1>ServerKit</h1>
+ <h1>{panelTitle}</h1>
<p>Sign in to your account</p>
</div>
diff --git a/frontend/src/pages/Register.jsx b/frontend/src/pages/Register.jsx
index d469898d..59bf355b 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 } = useAuth();
+ const { register, registrationEnabled, panelTitle } = 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>ServerKit</h1>
+ <h1>{panelTitle}</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>ServerKit</h1>
+ <h1>{panelTitle}</h1>
<p>Validating invitation...</p>
</div>
</div>
@@ -81,7 +81,7 @@ const Register = () => {
<div className="brand-logo">
<ServerKitLogo width={40} height={40} />
</div>
- <h1>ServerKit</h1>
+ <h1>{panelTitle}</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>ServerKit</h1>
+ <h1>{panelTitle}</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 42cb70b6..0800fa1d 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 } = useAuth();
+ const { isAuthenticated, completeOnboarding, panelTitle } = 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 ServerKit</h1>
+ <h1>Welcome to {panelTitle}</h1>
<p>Let&apos;s get your server ready</p>
</div>
diff --git a/frontend/src/pages/auth/AuthLayout.jsx b/frontend/src/pages/auth/AuthLayout.jsx
new file mode 100644
index 00000000..42b01203
--- /dev/null
+++ b/frontend/src/pages/auth/AuthLayout.jsx
@@ -0,0 +1,19 @@
+import { useAuth } from '../../contexts/AuthContext';
+import CenteredLayout from './layouts/CenteredLayout';
+import SplitHeroLayout from './layouts/SplitHeroLayout';
+import MinimalLayout from './layouts/MinimalLayout';
+
+// Picks the auth-page chrome from the admin-configured `login_layout` setting
+// (exposed pre-auth via /auth/setup-status → useAuth().loginLayout). Unknown
+// values fall back to the centered card.
+const LAYOUTS = {
+ centered: CenteredLayout,
+ split: SplitHeroLayout,
+ minimal: MinimalLayout,
+};
+
+export default function AuthLayout({ children }) {
+ const { loginLayout } = useAuth();
+ const Layout = LAYOUTS[loginLayout] || CenteredLayout;
+ return <Layout>{children}</Layout>;
+}
diff --git a/frontend/src/pages/auth/layouts/CenteredLayout.jsx b/frontend/src/pages/auth/layouts/CenteredLayout.jsx
new file mode 100644
index 00000000..17c7e55a
--- /dev/null
+++ b/frontend/src/pages/auth/layouts/CenteredLayout.jsx
@@ -0,0 +1,9 @@
+// Default auth layout: a single centered card. Identical to the original
+// login chrome, so `login_layout: centered` is a no-visual-change baseline.
+export default function CenteredLayout({ children }) {
+ return (
+ <div className="auth-container">
+ <div className="auth-card">{children}</div>
+ </div>
+ );
+}
diff --git a/frontend/src/pages/auth/layouts/MinimalLayout.jsx b/frontend/src/pages/auth/layouts/MinimalLayout.jsx
new file mode 100644
index 00000000..a893e401
--- /dev/null
+++ b/frontend/src/pages/auth/layouts/MinimalLayout.jsx
@@ -0,0 +1,8 @@
+// Minimal auth layout: a bare centered form with no card chrome.
+export default function MinimalLayout({ children }) {
+ return (
+ <div className="auth-container auth-minimal">
+ <div className="auth-minimal__inner">{children}</div>
+ </div>
+ );
+}
diff --git a/frontend/src/pages/auth/layouts/SplitHeroLayout.jsx b/frontend/src/pages/auth/layouts/SplitHeroLayout.jsx
new file mode 100644
index 00000000..a0366b51
--- /dev/null
+++ b/frontend/src/pages/auth/layouts/SplitHeroLayout.jsx
@@ -0,0 +1,19 @@
+import ServerKitLogo from '../../../components/ServerKitLogo';
+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();
+ 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>
+ </div>
+ </aside>
+ <div className="auth-card auth-split__card">{children}</div>
+ </div>
+ );
+}
diff --git a/frontend/src/styles/pages/_auth.scss b/frontend/src/styles/pages/_auth.scss
index 38e6cf10..36cce402 100644
--- a/frontend/src/styles/pages/_auth.scss
+++ b/frontend/src/styles/pages/_auth.scss
@@ -53,6 +53,51 @@
}
}
+// Login layout variants (the `login_layout` setting selects one).
+// `centered` is the default .auth-card above; these two are the alternates.
+.auth-minimal {
+ .auth-minimal__inner {
+ width: 100%;
+ max-width: 400px;
+ }
+}
+
+.auth-split {
+ padding: 0;
+ align-items: stretch;
+
+ .auth-split__hero {
+ display: none;
+ flex: 1;
+ background: linear-gradient(135deg, var(--accent-primary, #6d7cff), var(--accent-hover, #5a67e8));
+ color: #fff;
+ }
+
+ .auth-split__brand {
+ margin: auto;
+ display: flex;
+ flex-direction: column;
+ align-items: center;
+ gap: $space-4;
+ }
+
+ .auth-split__name {
+ font-size: $font-size-2xl;
+ font-weight: $font-weight-bold;
+ }
+
+ .auth-split__card {
+ flex: 1;
+ max-width: 480px;
+ margin: auto;
+ border: none;
+ }
+
+ @media (min-width: 900px) {
+ .auth-split__hero { display: flex; }
+ }
+}
+
// SSO login buttons
.sso-providers {
display: flex;