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.

Add app loader and WP detail skeletons

Juan Denisdea4749679dd
diff --git a/frontend/src/App.jsx b/frontend/src/App.jsx
index bd561c01..c584016f 100644
--- a/frontend/src/App.jsx
+++ b/frontend/src/App.jsx
@@ -8,6 +8,7 @@ import { ResourceTierProvider } from './contexts/ResourceTierContext';
import { NotificationsProvider } from './contexts/NotificationsContext';
import { Toaster } from './components/ui/sonner';
import DashboardLayout from './layouts/DashboardLayout';
+import AppLoader from './components/AppLoader';
import Dashboard from './pages/Dashboard';
import Login from './pages/Login';
import Register from './pages/Register';
@@ -189,7 +190,7 @@ function PrivateRoute({ children }) {
const { isAuthenticated, loading, needsSetup, needsMigration } = useAuth();
if (loading) {
- return <div className="loading">Loading...</div>;
+ return <AppLoader />;
}
// Priority: migrations > setup > auth
@@ -208,7 +209,7 @@ function PublicRoute({ children }) {
const { isAuthenticated, loading, needsSetup, needsMigration } = useAuth();
if (loading) {
- return <div className="loading">Loading...</div>;
+ return <AppLoader />;
}
// Priority: migrations > setup > auth
@@ -227,7 +228,7 @@ function SetupRoute({ children }) {
const { loading, needsSetup, isAuthenticated } = useAuth();
if (loading) {
- return <div className="loading">Loading...</div>;
+ return <AppLoader />;
}
// If setup is not needed, redirect appropriately
diff --git a/frontend/src/components/AppLoader.jsx b/frontend/src/components/AppLoader.jsx
new file mode 100644
index 00000000..ea47fae9
--- /dev/null
+++ b/frontend/src/components/AppLoader.jsx
@@ -0,0 +1,22 @@
+import ServerKitLogo from './ServerKitLogo';
+
+/**
+ * Minimal full-screen initial loader shown while auth/setup state is resolved.
+ * A centered ServerKit logo with a soft pulsing ring — clean for the ~1s
+ * the user sees it on first paint.
+ */
+export function AppLoader() {
+ return (
+ <div className="app-loader">
+ <div className="app-loader__stage" aria-busy="true" aria-label="Loading ServerKit">
+ <div className="app-loader__ring" />
+ <div className="app-loader__logo">
+ <ServerKitLogo width={52} height={52} />
+ </div>
+ </div>
+ <span className="app-loader__label">Loading ServerKit</span>
+ </div>
+ );
+}
+
+export default AppLoader;
diff --git a/frontend/src/pages/WordPressDetail.jsx b/frontend/src/pages/WordPressDetail.jsx
index 05bc3297..bf7ab474 100644
--- a/frontend/src/pages/WordPressDetail.jsx
+++ b/frontend/src/pages/WordPressDetail.jsx
@@ -26,43 +26,100 @@ import { Label } from '@/components/ui/label';
import { Textarea } from '@/components/ui/textarea';
// Detail Page Skeleton for initial loading
+// Mirrors the real page chrome (top bar, identity, repo pill, tabs) and the
+// Overview tab layout (KPIs, quick-actions + traffic grid, activity feed).
const DetailPageSkeleton = () => (
- <div className="app-detail-page app-detail-page--wide wp-detail-page">
- <div className="app-detail-header">
- <div className="skeleton" style={{ width: 48, height: 48, borderRadius: 8 }} />
- <div className="app-detail-title-block">
- <div className="skeleton" style={{ width: 200, height: 28, marginBottom: 8 }} />
- <div className="skeleton" style={{ width: 300, height: 16 }} />
+ <div className="wp-detail-page wp-detail-page--skeleton">
+ {/* Top bar chrome */}
+ <div className="sk-topbar-skeleton">
+ <div className="sk-topbar-skeleton__icon" />
+ <div className="sk-topbar-skeleton__title" />
+ <div className="sk-topbar-skeleton__spacer" />
+ <div className="sk-topbar-skeleton__actions">
+ <div className="sk-topbar-skeleton__btn" />
+ <div className="sk-topbar-skeleton__btn" />
+ <div className="sk-topbar-skeleton__btn sk-topbar-skeleton__btn--primary" />
</div>
</div>
- <div className="app-detail-tabs flex gap-2">
- {[1, 2, 3, 4, 5, 6, 7].map(i => (
- <div key={i} className="skeleton" style={{ width: 80, height: 32, borderRadius: 4 }} />
- ))}
- </div>
- <div className="app-detail-content">
- <div className="tab-loading">
- <div className="tab-loading-header">
- <div className="tab-loading-title" />
- <div className="tab-loading-btn" />
+
+ <div className="app-detail-body">
+ {/* Identity header */}
+ <div className="app-detail-header">
+ <div className="app-detail-icon wp-icon skeleton" style={{ width: 52, height: 52, borderRadius: 13 }} />
+ <div className="app-detail-title-block">
+ <div className="skeleton" style={{ width: 260, height: 24, marginBottom: 10 }} />
+ <div className="skeleton" style={{ width: 340, height: 14 }} />
</div>
- <div className="environments-grid">
- <div className="wp-env-card-skeleton">
- <div className="wp-env-card-skeleton-header">
- <div className="wp-env-card-skeleton-badge" />
- <div className="wp-env-card-skeleton-status" />
+ </div>
+
+ {/* Repo pill placeholder */}
+ <div className="wp-detail__repo-bar">
+ <div className="wp-detail-skeleton-repo" />
+ </div>
+
+ {/* Tab strip */}
+ <div className="app-detail-tabs">
+ {[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14].map(i => (
+ <div key={i} className="skeleton app-detail-tab-skeleton" />
+ ))}
+ </div>
+
+ {/* Overview tab content placeholder */}
+ <div className="app-detail-content">
+ <div className="wp-overview wp-overview--skeleton">
+ {/* KPI row */}
+ <div className="wp-kpis wp-kpis--skeleton">
+ {[1, 2, 3, 4].map(i => (
+ <div key={i} className="wp-detail-skeleton-kpi">
+ <div className="wp-detail-skeleton-kpi__label" />
+ <div className="wp-detail-skeleton-kpi__value" />
+ </div>
+ ))}
+ </div>
+
+ {/* Quick actions + traffic grid */}
+ <div className="wp-overview-main">
+ <div className="app-panel wp-detail-skeleton-panel">
+ <div className="app-panel-header">
+ <div className="skeleton" style={{ width: 100, height: 12 }} />
+ </div>
+ <div className="app-panel-body">
+ <div className="quick-actions-grid">
+ {[1, 2, 3, 4, 5, 6, 7, 8].map(i => (
+ <div key={i} className="skeleton" style={{ height: 38, borderRadius: 8 }} />
+ ))}
+ </div>
+ </div>
</div>
- <div className="wp-env-card-skeleton-body">
- <div className="wp-env-card-skeleton-url" />
+
+ <div className="app-panel wp-detail-skeleton-panel wp-traffic-panel">
+ <div className="app-panel-header">
+ <div className="skeleton" style={{ width: 80, height: 12, marginBottom: 4 }} />
+ <div className="skeleton" style={{ width: 140, height: 10 }} />
+ </div>
+ <div className="app-panel-body">
+ <div className="wp-detail-skeleton-chart" />
+ </div>
</div>
</div>
- <div className="wp-env-card-skeleton">
- <div className="wp-env-card-skeleton-header">
- <div className="wp-env-card-skeleton-badge" />
- <div className="wp-env-card-skeleton-status" />
+
+ {/* Recent activity panel */}
+ <div className="app-panel wp-detail-skeleton-panel wp-activity-panel">
+ <div className="app-panel-header">
+ <div className="skeleton" style={{ width: 110, height: 12 }} />
</div>
- <div className="wp-env-card-skeleton-body">
- <div className="wp-env-card-skeleton-url" />
+ <div className="app-panel-body">
+ <div className="wp-detail-skeleton-activity">
+ {[1, 2, 3, 4].map(i => (
+ <div key={i} className="wp-detail-skeleton-activity__row">
+ <div className="skeleton" style={{ width: 32, height: 32, borderRadius: '50%' }} />
+ <div className="wp-detail-skeleton-activity__lines">
+ <div className="skeleton" style={{ width: '40%', height: 12, marginBottom: 6 }} />
+ <div className="skeleton" style={{ width: '65%', height: 10 }} />
+ </div>
+ </div>
+ ))}
+ </div>
</div>
</div>
</div>
@@ -660,7 +717,7 @@ const PhpTab = ({ siteId }) => {
}
}
- if (loading) return <div className="tab-loading"><p className="hint">Loading PHP info...</p></div>;
+ if (loading) return <OverviewGridSkeleton panels={2} />;
const limits = php?.limits || {};
const current = php?.php_version || 'Unknown';
@@ -792,7 +849,7 @@ const UptimeTab = ({ siteId }) => {
} finally { setBusy(false); }
}
- if (loading) return <div className="tab-loading"><p className="hint">Loading uptime info...</p></div>;
+ if (loading) return <OverviewGridSkeleton panels={2} />;
const comp = data?.component;
const pages = data?.pages || [];
@@ -926,7 +983,7 @@ const UpdatesTab = ({ siteId }) => {
finally { setBusy(false); }
}
- if (loading) return <div className="tab-loading"><p className="hint">Loading updates...</p></div>;
+ if (loading) return <OverviewGridSkeleton panels={2} />;
const runs = data?.runs || [];
const running = data?.running;
@@ -1066,7 +1123,7 @@ const SecurityTab = ({ siteId }) => {
finally { setBusy(false); }
}
- if (loading) return <div className="tab-loading"><p className="hint">Loading security tools...</p></div>;
+ if (loading) return <OverviewGridSkeleton panels={2} />;
const intRunning = integrity?.status === 'running';
const issues = integrity?.issues || [];
@@ -1217,7 +1274,7 @@ const VulnerabilitiesTab = ({ siteId }) => {
}
}
- if (loading) return <div className="tab-loading"><p className="hint">Loading vulnerabilities...</p></div>;
+ if (loading) return <OverviewGridSkeleton panels={2} />;
const running = data?.scan_status === 'running';
const summary = data?.summary || {};
@@ -1331,7 +1388,7 @@ const AnalyticsTab = ({ siteId }) => {
useEffect(() => { load(); }, [load]);
- if (loading) return <div className="tab-loading"><p className="hint">Loading analytics...</p></div>;
+ if (loading) return <OverviewGridSkeleton panels={3} />;
const fmtHour = (iso) => {
const d = new Date(iso);
@@ -1566,7 +1623,7 @@ const ReportsTab = ({ siteId }) => {
window.print();
}
- if (loading) return <div className="tab-loading"><p className="hint">Loading reports...</p></div>;
+ if (loading) return <OverviewGridSkeleton panels={2} />;
const selected = reports.find(r => r.id === selectedId) || null;
@@ -2619,18 +2676,40 @@ const EnvironmentCardSkeleton = () => (
</div>
);
-const TableRowSkeleton = () => (
- <div className="skeleton-table-row">
- <div className="skeleton-cell cell-name" />
- <div className="skeleton-cell cell-tag" />
- <div className="skeleton-cell cell-size" />
- <div className="skeleton-cell cell-date" />
- <div className="skeleton-cell cell-actions" />
+const ListItemSkeleton = () => (
+ <div className="skeleton" style={{ height: 48, borderRadius: 6, marginBottom: 8 }} />
+);
+
+// Generic panel skeleton — matches .app-panel + .app-panel-header + .app-panel-body
+const PanelSkeleton = ({ headerWidth = 100, rows = 3, children }) => (
+ <div className="app-panel wp-detail-skeleton-panel">
+ <div className="app-panel-header">
+ <div className="skeleton" style={{ width: headerWidth, height: 12 }} />
+ </div>
+ <div className="app-panel-body">
+ {children || (
+ <div className="wp-detail-skeleton-rows">
+ {Array.from({ length: rows }).map((_, i) => (
+ <div key={i} className="wp-detail-skeleton-row">
+ <div className="skeleton" style={{ width: '35%', height: 10 }} />
+ <div className="skeleton" style={{ width: '55%', height: 14 }} />
+ </div>
+ ))}
+ </div>
+ )}
+ </div>
</div>
);
-const ListItemSkeleton = () => (
- <div className="skeleton" style={{ height: 48, borderRadius: 6, marginBottom: 8 }} />
+// Skeleton used by tabs that render inside .app-overview-grid > .app-overview-left
+const OverviewGridSkeleton = ({ panels = 2 }) => (
+ <div className="app-overview-grid">
+ <div className="app-overview-left">
+ {Array.from({ length: panels }).map((_, i) => (
+ <PanelSkeleton key={i} headerWidth={i === 0 ? 120 : 160} />
+ ))}
+ </div>
+ </div>
);
// Environments Tab
diff --git a/frontend/src/styles/layout/_main-content.scss b/frontend/src/styles/layout/_main-content.scss
index b177e575..aeb29759 100644
--- a/frontend/src/styles/layout/_main-content.scss
+++ b/frontend/src/styles/layout/_main-content.scss
@@ -186,3 +186,75 @@
.loading-state {
min-height: 40vh;
}
+
+// ============================================================
+// APP-LEVEL INITIAL LOADER
+// Full-screen splash shown while auth/setup state resolves.
+// ============================================================
+.app-loader {
+ position: fixed;
+ inset: 0;
+ z-index: 9999;
+ display: flex;
+ flex-direction: column;
+ align-items: center;
+ justify-content: center;
+ gap: $space-5;
+ background: var(--surface);
+
+ &__stage {
+ position: relative;
+ width: 96px;
+ height: 96px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ }
+
+ &__logo {
+ position: relative;
+ z-index: 2;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ width: 64px;
+ height: 64px;
+ border-radius: 16px;
+ background: var(--surface-2);
+ box-shadow: var(--shadow-md), 0 0 0 1px var(--border-soft);
+ animation: app-loader-pulse 2s ease-in-out infinite;
+
+ svg {
+ width: 38px;
+ height: 38px;
+ }
+ }
+
+ &__ring {
+ position: absolute;
+ width: 96px;
+ height: 96px;
+ border-radius: 50%;
+ border: 2px solid transparent;
+ border-top-color: var(--accent-bright);
+ border-right-color: fade($accent-primary-raw, 30%);
+ animation: app-loader-spin 1.2s linear infinite;
+ }
+
+ &__label {
+ font-size: $font-size-sm;
+ font-weight: $font-weight-medium;
+ color: var(--text-dim);
+ letter-spacing: 0.02em;
+ }
+}
+
+@keyframes app-loader-pulse {
+ 0%, 100% { transform: scale(1); opacity: 1; }
+ 50% { transform: scale(1.03); opacity: 0.85; }
+}
+
+@keyframes app-loader-spin {
+ from { transform: rotate(0deg); }
+ to { transform: rotate(360deg); }
+}
diff --git a/frontend/src/styles/pages/_wordpress.scss b/frontend/src/styles/pages/_wordpress.scss
index c0914c1a..0450ac2e 100644
--- a/frontend/src/styles/pages/_wordpress.scss
+++ b/frontend/src/styles/pages/_wordpress.scss
@@ -2555,6 +2555,154 @@
@include skeleton();
}
+// ============================================
+// WORDPRESS DETAIL PAGE SKELETON
+// Mirrors the real page chrome + Overview tab layout.
+// ============================================
+.wp-detail-page--skeleton {
+ .sk-topbar-skeleton {
+ display: flex;
+ align-items: center;
+ gap: 14px;
+ min-height: 60px;
+ padding: 10px $space-4;
+ border-bottom: 1px solid var(--border-soft);
+
+ &__icon {
+ width: 18px;
+ height: 18px;
+ border-radius: 4px;
+ @include skeleton();
+ }
+
+ &__title {
+ width: 160px;
+ height: 16px;
+ border-radius: 4px;
+ @include skeleton();
+ }
+
+ &__spacer { flex: 1; }
+
+ &__actions {
+ display: inline-flex;
+ align-items: center;
+ gap: 8px;
+ flex-shrink: 0;
+ }
+
+ &__btn {
+ width: 90px;
+ height: 32px;
+ border-radius: $radius-md;
+ @include skeleton();
+
+ &--primary { width: 110px; }
+ }
+ }
+
+ .wp-detail-skeleton-repo {
+ width: 220px;
+ height: 30px;
+ border-radius: $radius-full;
+ @include skeleton();
+ }
+
+ .app-detail-tab-skeleton {
+ width: 80px;
+ height: 38px;
+ border-radius: 0;
+ background: transparent;
+ border-bottom: 2px solid transparent;
+ @include skeleton();
+ }
+
+ .wp-kpis--skeleton {
+ display: grid;
+ grid-template-columns: repeat(auto-fit, minmax(170px, 1fr));
+ gap: $space-4;
+ }
+
+ .wp-detail-skeleton-kpi {
+ background: var(--surface);
+ border: 1px solid var(--border-soft);
+ border-radius: var(--radius);
+ padding: $space-4 $space-5;
+ display: flex;
+ flex-direction: column;
+ gap: $space-2;
+
+ &__label {
+ width: 70%;
+ height: 11px;
+ border-radius: 3px;
+ @include skeleton();
+ }
+
+ &__value {
+ width: 45%;
+ height: 26px;
+ border-radius: 4px;
+ @include skeleton();
+ }
+ }
+
+ .wp-detail-skeleton-panel {
+ background: var(--surface);
+ border: 1px solid var(--border-soft);
+ border-radius: var(--radius);
+
+ .app-panel-header {
+ display: flex;
+ flex-direction: column;
+ align-items: flex-start;
+ gap: 2px;
+ padding: 12px 17px;
+ border-bottom: 1px solid var(--border-soft);
+ }
+
+ .app-panel-body {
+ padding: $space-4 17px;
+ }
+ }
+
+ .wp-detail-skeleton-chart {
+ height: 250px;
+ border-radius: $radius-md;
+ @include skeleton();
+ }
+
+ .wp-detail-skeleton-activity {
+ display: flex;
+ flex-direction: column;
+ gap: $space-3;
+
+ &__row {
+ display: flex;
+ align-items: center;
+ gap: $space-3;
+ }
+
+ &__lines {
+ flex: 1;
+ min-width: 0;
+ }
+ }
+
+ .wp-detail-skeleton-rows {
+ display: flex;
+ flex-direction: column;
+ gap: $space-3;
+ }
+
+ .wp-detail-skeleton-row {
+ display: flex;
+ justify-content: space-between;
+ align-items: center;
+ gap: $space-4;
+ }
+}
+
// ============================================
// ERROR STATES
// ============================================