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.
Python astracloudflarecontrol-panelcyberpaneldnsfablehosting-control-panelhosting-panelkimi-k3server-managementserverkitubuntu-web-panelwebserver
feat: configurable panel title + switchable login layouts
Juan Denis9a1a1f69a308
diff --git a/backend/app/api/auth.py b/backend/app/api/auth.pyindex 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.pyindex 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.jsxindex 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.jsxindex 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.jsxindex 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.jsindex 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.jsindex 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.jsxindex 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 formif (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 cardif (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.jsxindex 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.jsxindex 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's get your server ready</p></div>diff --git a/frontend/src/pages/auth/AuthLayout.jsx b/frontend/src/pages/auth/AuthLayout.jsxnew file mode 100644index 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.jsxnew file mode 100644index 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.jsxnew file mode 100644index 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.jsxnew file mode 100644index 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.scssindex 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;