Theme Documentation
Comprehensive reference manual, core architectural specifications, CSS variable schemas, and responsive UI layout components powering the UrbanHub Premium Real Estate Dashboard system.
Project Overview
UrbanHub is an ultra-premium, high-density dashboard and administration system custom-built for high-ticket Real Estate brokerages, asset management firms, and luxury residential consultancies. Synthesizing cutting-edge UX patterns with modern developer frameworks, it streamlines visual property management, transaction processing, customer interactions, analytics, intelligence, and organizational settings into a high-performance system.
Designed around Swiss Modern Grid aesthetics, the theme integrates fluid transitions, fine-tuned high-contrast typography, premium gold accents, glassmorphic filters, and lightweight animations to elevate the standard real estate administrative tool into an immersive executive portal.
Core Technical Specifications
Folder Structure
The filesystem is designed symmetrically for instant navigation, clean separation of static templates, core scripts, and styling layers. Let's inspect the layout hierarchy:
-
/
-
assets/
-
css/
- style.css // Unified premium design system & utility classes
-
js/
- main.js // App core, animations, charts config, & state
-
css/
- index.html // Main executive dashboard analytics
- properties.html // Real estate listings grid with filters
- add-property.html // Form wizard to create premium property listings
- agents.html // Profiles directory of premium brokers
- customers.html // High-net-worth client registry database
- leads.html // Interactive Sales funnel CRM lead tracker
- appointments.html // Customer show times & legal appointments log
- messages.html // Multi-channel chat interface for clients & agents
- transactions.html // Contract ledgers, transaction records & logs
- invoices.html // Premium commission invoices & payments
- analytics.html // Deep reporting, interactive graphs & charts
- calendar.html // Interactive full-scale planning calendar
- tasks.html // Operational board, check-offs and items
- reviews.html // Customer satisfaction metrics and testimonials
- settings.html // System preferences, customization panel
- profile.html // Agent profile parameters and statistics
- documentation.html // Active developer docs (This Page)
-
assets/
Assets Catalog
UrbanHub ensures a pristine visual experience without locally storing massive visual assets. All assets (except local styles and scripts) are fetched dynamically from robust, premium CDNs:
Urban imagery, luxury penthouses, agent headshots, and layout covers are fetched dynamically from Unsplash with custom query parameters (high resolution, exact cropping ratios).
Bootstrap 5.3, Bootstrap Icons, Chart.js, and AOS are served via high-performance cloud networks (JsDelivr CDN), ensuring sub-millisecond delivery to user devices.
HTML Structure
Symmetrical layout nesting ensures responsive rendering on mobile and collapsing interactions on desktop. Here is the canonical boilerplate template of an UrbanHub page:
<!doctype html>
<html lang="en" data-bs-theme="dark">
<head>
<!-- Pre-load LocalStorage theme choice to prevent visual flicker -->
<script>
(function () {
const savedTheme = localStorage.getItem('theme') || 'dark';
document.documentElement.setAttribute('data-bs-theme', savedTheme);
})();
</script>
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet" />
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css" />
<link rel="stylesheet" href="/assets/css/style.css" />
</head>
<body>
<!-- Mobile overlay -->
<div id="sidebar-overlay" class="sidebar-overlay"></div>
<div class="app-wrapper">
<!-- FIXED LEFT SIDEBAR -->
<aside id="sidebar-wrapper" class="sidebar-wrapper">
<!-- Sidebar items and footer -->
</aside>
<!-- PAGE CONTENT AREA & TOP HEADER -->
<main class="main-content-wrapper">
<header class="top-header">
<!-- Search & controls -->
</header>
<!-- CONTAINER BODY -->
<div class="page-body">
<!-- Page contents sit here -->
</div>
<footer class="uh-footer mt-auto">
<!-- Footer elements -->
</footer>
</main>
</div>
</body>
</html>
CSS Structure
Styling relies entirely on a centralized file (assets/css/style.css) containing design definitions, typography overrides, utility helpers, and a complete, highly expressive set of design system tokens (variables).
Core CSS Variables & Custom Theme Settings
/* CSS Custom Properties Scheme */
:root {
--uh-sidebar-width: 240px;
--uh-header-height: 64px;
--uh-font-title: 'Plus Jakarta Sans', sans-serif;
--uh-font-body: 'Inter', sans-serif;
--uh-transition-smooth: all 0.25s cubic-bezier(0.4, 0, 0.2, 1);
}
:root, [data-bs-theme="light"] {
--uh-primary: #B8860B; /* Darker Gold / Bronze */
--uh-primary-rgb: 184, 134, 11;
--uh-bg-body: #F8F9FA;
--uh-bg-sidebar: #FFFFFF;
--uh-bg-card: #FFFFFF;
--uh-border-color: rgba(0, 0, 0, 0.08);
--uh-text-main: #0F172A;
--uh-text-muted: #64748B;
--uh-scrollbar-thumb: #CBD5E1;
}
[data-bs-theme="dark"] {
--uh-primary: #D4AF37; /* Premium Gold */
--uh-primary-rgb: 212, 175, 55;
--uh-bg-body: #0A0A0B;
--uh-bg-sidebar: #111114;
--uh-bg-card: #111114;
--uh-border-color: rgba(255, 255, 255, 0.08);
--uh-text-main: #E2E8F0;
--uh-text-muted: #94A3B8;
--uh-scrollbar-thumb: #222226;
}
JavaScript Engine
Client-side intelligence resides in assets/js/main.js, governing theme persistence, responsive sidebars, smooth animations via AOS, interactive forms, custom components, and responsive charts.
Theme and Sidebar Management Implementation
// Apply Theme state dynamically
function applyTheme(theme) {
document.documentElement.setAttribute('data-bs-theme', theme);
localStorage.setItem('theme', theme);
if (theme === 'light') {
themeIcon.className = 'bi bi-moon-stars';
} else {
themeIcon.className = 'bi bi-sun';
}
// Dispatch custom event to notify charts to redraw with new colors
window.dispatchEvent(new CustomEvent('themeChanged', { detail: { theme } }));
}
// Collapsible Sidebar Toggle action
sidebarToggleBtn.addEventListener('click', () => {
if (window.innerWidth >= 992) {
const isCollapsed = document.body.classList.toggle('sidebar-collapsed');
localStorage.setItem('sidebarCollapsed', isCollapsed ? 'true' : 'false');
} else {
sidebarWrapper.classList.toggle('mobile-show');
sidebarOverlay.classList.toggle('active');
}
});
Theme System & Mode
UrbanHub utilizes a hybrid styling engine combining Bootstrap 5.3 theme utilities with native CSS variable tokens. Real-time switching between Light and Dark mode changes variables dynamically without reloading.
Header Controls
The Top Header (.top-header) contains critical application level utilities, styled as a subtle glass pane blurring trailing background scroll. Features include:
- Global Navigation Search: Dynamic form targeting properties, leads or agents.
- Theme Switcher: Light and dark mode instant state updates.
- Inbox & Notifications: Rich drop-down listings detailing message payloads with high-contrast indicator badges.
- User Account Menu: Direct access to profile, security settings, configuration and system logs.
Bootstrap Components
All core Bootstrap 5.3 structures are natively supported. To align them with UrbanHub's luxury feel, they are automatically styled using our customized theme variables:
Icons Selection
UrbanHub imports Bootstrap Icons (v1.11.3) via global CDN. All menu items and dashboard status cards utilize semantic glyphs to ensure immediate intuitive recognition.
bi-building-up
bi-house-door
bi-people
bi-currency-exchange
bi-sliders2
bi-graph-up-arrow
Form Controls
Form fields utilize custom overrides on Bootstrap's .form-control. Input focus states exhibit a refined fade-in gold boundary ring with a subtle container glow shadow.
<!-- Symmetrical Input Field Pattern -->
<div class="mb-3">
<label class="form-label font-title fw-semibold text-muted" style="font-size: 0.75rem;">Premium Property Name</label>
<input type="text" class="form-control" placeholder="e.g. Skyline Heights Penthouse" />
</div>
Bento Cards
Cards (.uh-card) represent the primary visual block of the system. Styled with a solid container panel, ultra-thin border highlights, generous inner margins, and subtle drop shadows, they stack beautifully as responsive grid grids.
Hover Bento Action
This card features .uh-card-hover, which elevates the element using an elegant upwards slide-and-shadow effect when cursors hover.
Accent Border Bento
Using border-top: 3px solid var(--uh-primary) instantly anchors status and priority highlights to specific content blocks.
Tables & Ledger
Ledgers, lists and directories utilize high-density table designs, emphasizing vertical typography alignment and custom status pill indicators.
| Property Account | Broker Agent | Contract Status | Value Price |
|---|---|---|---|
| Regency Plaza Duplex | sarah@urbanhub.com | Completed | $2,450,000 |
| Coastal Sunset Villa | david@urbanhub.com | In Progress | $4,120,000 |
Theme Charts
UrbanHub implements high-performance charts using Chart.js (v4.x). Charts dynamically watch for theme change events (themeChanged) and refresh their background grids, font colors, and tooltips instantly.
Animations & AOS
All page elements utilize AOS (Animate On Scroll) to enter the viewport elegantly. Layout animations are restricted to short durations (800ms) and low movement translates (fade-up, fade-down) to guarantee responsive rendering.
<!-- AOS Entry Fade Binding -->
<div class="uh-card" data-aos="fade-up" data-aos-delay="100">
<h5>Animated Panel</h5>
</div>
Customization Guide
UrbanHub is highly customizable. You can adapt the visual color themes, branding, sidebars, and grid parameters with simple overrides.
Branding & Gold Accents
To modify the signature gold accent color across the entire application, simply update the CSS variables --uh-primary and --uh-primary-rgb inside the :root declaration of assets/css/style.css. For instance, to apply a luxurious deep copper accent:
/* Apply Copper Accent Overrides */
[data-bs-theme="dark"] {
--uh-primary: #D35400; /* Luxury Copper */
--uh-primary-rgb: 211, 84, 0;
}
Responsive Guide
UrbanHub is 100% mobile-fluid. The layout adapts smoothly based on Bootstrap grid breakpoints:
| Viewport Breakpoint | Layout Behavior | Sidebar Interaction |
|---|---|---|
| Mobile (<992px) | Single-column vertical stack grid | Hidden by default. Toggle slides in full width off-screen |
| Tablet (992px - 1199px) | High density grids | Collapsed to thin icon-only bar automatically |
| Desktop (≥1200px) | Multi-column bento grids | Expanded to full 240px wide side navigation rail |
Browser Support
UrbanHub leverages modern web standards (ES Modules, CSS Variables, CSS Grid, IntersectionObserver, and local memory caches). Supported engines include:
- Google Chrome: v100+ (Full Support)
- Apple Safari: v15.4+ (Full Support with CSS variable support)
- Mozilla Firefox: v100+ (Full Support)
- Microsoft Edge: v100+ (Full Support)
- Opera: v85+ (Full Support)
FAQ & Support
assets/js/main.js to post to your REST API or backend services.
<head> of your template, and using their standard HTML class names within the side navigation lists.
Credits
UrbanHub would not exist without the dedication of outstanding open-source libraries and digital resource creators:
- Bootstrap Framework: Powered by Bootstrap 5.3 CSS grid systems.
- Chart.js: Dynamic theme-responsive HTML5 analytical charts.
- AOS Animate: Scroll-triggered entry and exit animation effects.
- Unsplash: Premium, high-resolution royalty-free urban design photography assets.
- Google Fonts: Plus Jakarta Sans and Inter font distributions.
Version History
Theme Documentation & Error Layout Integration
- Created comprehensive developer documentation.html module.
- Configured premium interactive copy-code blocks.
- Built section search engine & custom scrollspy layout tracking.
- Completed verification pages and email verify validation screens.
Core Platform Initial Release
- Released core executive real estate analytical dashboard.
- Created Property management boards with quick filtration layers.
- Added real-time messaging, calendar events logs, and dark theme variables.