/* ===== CSS CUSTOM PROPERTIES ===== */
        :root {
            --primary: #FF8B00;
            --primary-dark: #B03700;
            --primary-light: #FFB74D;
            --secondary: #3A3A50;
            --accent: #00C3FF;
            --light: #F9F9F9;
            --light-bg: #F8F9FA;
            --dark: #1A1A2E;
            --text-color: #333;
            --light-text: #777;
            --card-bg: #fff;
            --white: #FFFFFF;
            --success: #28C76F;
            --warning: #FF9F43;
            --danger: #EA5455;
            --gradient-primary: linear-gradient(266deg, var(--primary-dark), var(--primary));
            --shadow-lg: 0 10px 30px rgba(0, 0, 0, 0.2);
            --border-radius-lg: 20px;
            --border-radius-xl: 30px;
            --transition: all 0.3s ease;
        }

        [data-theme="dark"] {
            --primary: #FF8B00;
            --primary-dark: #B03700;
            --primary-light: #FFB74D;
            --secondary: #E2E8F0;
            --accent: #00C3FF;
            --light: #0f1419;
            --light-bg: #1a202c;
            --dark: #f7fafc;
            --text-color: #f7fafc;
            --light-text: #cbd5e0;
            --card-bg: #1e293b;
            --white: #0f1419;
            --success: #48BB78;
            --warning: #ED8936;
            --danger: #F56565;
        }

        * {
            margin: 0;
            padding: 0;
            box-sizing: border-box;
        }

        body {
            font-family: 'Tajawal', sans-serif;
            background-color: var(--light);
            color: var(--text-color);
            line-height: 1.7;
            overflow-x: hidden;
            transition: background-color 0.3s ease, color 0.3s ease;
        }

        [data-theme="dark"] body {
            background: linear-gradient(135deg, var(--light) 0%, var(--light-bg) 100%);
        }

        .container {
            width: 100%;
            max-width: 1200px;
            margin: 0 auto;
            padding: 0 20px;
        }

        /* ===== HEADER ===== */
        .header {
            background: rgba(255, 255, 255, 0.05);
            padding: 15px 0;
            position: fixed;
            width: calc(100% - 60px);
            max-width: 1200px;
            top: 20px;
            left: 50%;
            transform: translateX(-50%);
            z-index: 1000;
            border: 1px solid rgba(255, 255, 255, 0.1);
            border-radius: 24px;
            box-shadow: 0 8px 32px rgba(0, 0, 0, 0.1);
            backdrop-filter: blur(20px);
            transition: all 0.4s cubic-bezier(0.4, 0, 0.2, 1);
        }

        .header.scrolled {
            background: rgba(176, 55, 0, 0.9);
            box-shadow: 0 10px 30px rgba(0, 0, 0, 0.3);
        }

        [data-theme="dark"] .header {
            background: rgba(15, 23, 42, 0.6);
            border-color: rgba(255, 139, 0, 0.2);
        }

        [data-theme="dark"] .header.scrolled {
            background: rgba(15, 23, 42, 0.95);
        }

        .navbar {
            display: flex;
            justify-content: space-between;
            align-items: center;
            padding: 0 20px;
        }

        .logo {
            display: flex;
            align-items: center;
        }

        .logo img {
            height: 40px;
            filter: drop-shadow(0 2px 4px rgba(0, 0, 0, 0.1));
        }

        .nav-links {
            display: flex;
            list-style: none;
            gap: 8px;
        }

        .nav-links a {
            color: rgba(255, 255, 255, 0.9);
            text-decoration: none;
            font-weight: 600;
            font-size: 0.95rem;
            padding: 10px 20px;
            border-radius: 50px;
            transition: var(--transition);
        }

        .nav-links a:hover,
        .nav-links a.active {
            background: rgba(255, 255, 255, 0.2);
            color: #fff;
        }

        .header-actions {
            display: flex;
            align-items: center;
            gap: 12px;
        }

        .theme-toggle {
            width: 44px;
            height: 44px;
            border-radius: 50%;
            background: rgba(0, 0, 0, 0.2);
            border: 1px solid rgba(255, 255, 255, 0.1);
            cursor: pointer;
            display: flex;
            align-items: center;
            justify-content: center;
            color: rgba(255, 255, 255, 0.9);
            font-size: 1.1rem;
            transition: var(--transition);
        }

        .theme-toggle:hover {
            background: rgba(255, 255, 255, 0.2);
            transform: rotate(15deg) scale(1.05);
        }

        .btn-dashboard {
            display: inline-flex;
            align-items: center;
            padding: 12px 24px;
            background: var(--gradient-primary);
            color: #fff;
            text-decoration: none;
            font-weight: 700;
            border-radius: 50px;
            box-shadow: 0 8px 25px rgba(255, 139, 0, 0.3);
            transition: var(--transition);
        }

        .btn-dashboard:hover {
            transform: translateY(-3px);
            box-shadow: 0 15px 40px rgba(255, 139, 0, 0.4);
        }

        /* ===== HERO SECTION ===== */
        .hero {
            background: radial-gradient(circle at top left, #2a1b3d 0%, var(--primary-dark) 40%, var(--primary) 100%);
            padding-top: 160px;
            padding-bottom: 80px;
            color: #fff;
            position: relative;
            overflow: hidden;
        }

        [data-theme="dark"] .hero {
            background: linear-gradient(135deg, #0f172a 0%, var(--primary-dark) 50%, var(--primary) 100%);
        }

        .hero::before {
            content: '';
            position: absolute;
            top: 0;
            left: 0;
            width: 100%;
            height: 100%;
            background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='100' height='100' viewBox='0 0 100 100'%3E%3Cpath fill='%23ffffff' fill-opacity='0.05' d='M11 18c3.866 0 7-3.134 7-7s-3.134-7-7-7-7 3.134-7 7 3.134 7 7 7zm48 25c3.866 0 7-3.134 7-7s-3.134-7-7-7-7 3.134-7 7 3.134 7 7 7zm-43-7c1.657 0 3-1.343 3-3s-1.343-3-3-3-3 1.343-3 3 1.343 3 3 3zm63 31c1.657 0 3-1.343 3-3s-1.343-3-3-3-3 1.343-3 3 1.343 3 3 3z'%3E%3C/path%3E%3C/svg%3E");
            pointer-events: none;
        }

        .hero-content {
            text-align: center;
            position: relative;
            z-index: 1;
        }

        .hero h1 {
            font-size: 3.5rem;
            font-weight: 800;
            margin-bottom: 1.5rem;
            text-shadow: 0 4px 20px rgba(0, 0, 0, 0.3);
        }

        .hero p {
            font-size: 1.3rem;
            opacity: 0.9;
            max-width: 700px;
            margin: 0 auto 2rem;
        }

        .hero-badge {
            display: inline-block;
            background: rgba(255, 255, 255, 0.15);
            padding: 8px 24px;
            border-radius: 50px;
            font-size: 0.9rem;
            font-weight: 600;
            border: 1px solid rgba(255, 255, 255, 0.2);
            backdrop-filter: blur(10px);
        }

        /* ===== MAIN CONTENT ===== */
        .main {
            padding: 60px 0 100px;
            background: var(--light);
        }

        [data-theme="dark"] .main {
            background: var(--light-bg);
        }

        .content-grid {
            display: grid;
            grid-template-columns: 280px 1fr;
            gap: 40px;
        }

        /* ===== SIDEBAR ===== */
        .sidebar {
            position: sticky;
            top: 120px;
            height: fit-content;
        }

        .sidebar-nav {
            background: var(--card-bg);
            border-radius: var(--border-radius-lg);
            padding: 24px;
            box-shadow: 0 10px 40px rgba(0, 0, 0, 0.08);
            border: 1px solid rgba(0, 0, 0, 0.05);
        }

        [data-theme="dark"] .sidebar-nav {
            border-color: rgba(255, 255, 255, 0.1);
        }

        .sidebar-title {
            font-size: 0.75rem;
            font-weight: 700;
            text-transform: uppercase;
            letter-spacing: 1px;
            color: var(--light-text);
            margin-bottom: 16px;
        }

        .sidebar-links {
            list-style: none;
        }

        .sidebar-links li {
            margin-bottom: 4px;
        }

        .sidebar-links a {
            display: flex;
            align-items: center;
            gap: 12px;
            padding: 14px 16px;
            color: var(--text-color);
            text-decoration: none;
            font-weight: 600;
            border-radius: 12px;
            transition: var(--transition);
        }

        .sidebar-links a:hover {
            background: rgba(255, 139, 0, 0.1);
            color: var(--primary);
        }

        .sidebar-links a.active {
            background: var(--gradient-primary);
            color: #fff;
            box-shadow: 0 8px 20px rgba(255, 139, 0, 0.3);
        }

        .sidebar-links a i {
            width: 20px;
            text-align: center;
        }

        /* ===== SIDEBAR SUBLINKS ===== */
        .sidebar-sublinks {
            list-style: none;
            margin: 8px 0 0 0;
            padding: 0 0 0 32px;
        }

        .sidebar-sublinks li {
            margin-bottom: 2px;
        }

        .sidebar-sublinks a {
            display: flex;
            align-items: center;
            gap: 8px;
            padding: 10px 14px;
            color: var(--light-text);
            text-decoration: none;
            font-weight: 500;
            font-size: 0.9rem;
            border-radius: 8px;
            transition: var(--transition);
        }

        .sidebar-sublinks a:hover {
            background: rgba(255, 139, 0, 0.08);
            color: var(--primary);
        }

        .sidebar-sublinks a.active {
            background: rgba(255, 139, 0, 0.15);
            color: var(--primary);
        }

        .sidebar-sublinks a i {
            width: 16px;
            font-size: 0.85rem;
            text-align: center;
        }

        .sidebar-help {
            margin-top: 24px;
            padding: 24px;
            background: var(--gradient-primary);
            border-radius: var(--border-radius-lg);
            color: #fff;
        }

        .sidebar-help h4 {
            font-size: 1rem;
            margin-bottom: 8px;
        }

        .sidebar-help p {
            font-size: 0.9rem;
            opacity: 0.8;
            margin-bottom: 16px;
        }

        .sidebar-help a {
            display: inline-flex;
            align-items: center;
            gap: 8px;
            padding: 10px 18px;
            background: rgba(255, 255, 255, 0.2);
            color: #fff;
            text-decoration: none;
            border-radius: 50px;
            font-weight: 600;
            font-size: 0.85rem;
            transition: var(--transition);
        }

        .sidebar-help a:hover {
            background: rgba(255, 255, 255, 0.3);
        }

        /* ===== CONTENT SECTIONS ===== */
        .content-section {
            display: none;
        }

        .content-section.active {
            display: block;
        }

        .section-header {
            background: var(--card-bg);
            padding: 40px;
            border-radius: var(--border-radius-xl);
            margin-bottom: 32px;
            box-shadow: 0 10px 40px rgba(0, 0, 0, 0.08);
            border: 1px solid rgba(0, 0, 0, 0.05);
        }

        [data-theme="dark"] .section-header {
            border-color: rgba(255, 139, 0, 0.1);
        }

        .section-header h2 {
            font-size: 2.5rem;
            font-weight: 800;
            margin-bottom: 12px;
            background: var(--gradient-primary);
            -webkit-background-clip: text;
            -webkit-text-fill-color: transparent;
            background-clip: text;
        }

        .section-header p {
            font-size: 1.1rem;
            color: var(--light-text);
        }

        /* ===== CARDS ===== */
        .card {
            background: var(--card-bg);
            border-radius: var(--border-radius-lg);
            padding: 32px;
            margin-bottom: 24px;
            box-shadow: 0 10px 40px rgba(0, 0, 0, 0.08);
            border: 1px solid rgba(0, 0, 0, 0.05);
            transition: var(--transition);
        }

        [data-theme="dark"] .card {
            border-color: rgba(255, 255, 255, 0.1);
        }

        .card:hover {
            transform: translateY(-4px);
            box-shadow: 0 20px 50px rgba(0, 0, 0, 0.12);
        }

        .card h3 {
            font-size: 1.5rem;
            font-weight: 700;
            margin-bottom: 16px;
            color: var(--text-color);
        }

        .card p {
            color: var(--light-text);
            margin-bottom: 16px;
        }

        /* ===== STEP CARDS ===== */
        .step-card {
            display: flex;
            gap: 24px;
            padding: 28px;
            background: var(--card-bg);
            border-radius: var(--border-radius-lg);
            margin-bottom: 20px;
            border: 1px solid rgba(0, 0, 0, 0.05);
            transition: var(--transition);
        }

        [data-theme="dark"] .step-card {
            border-color: rgba(255, 255, 255, 0.1);
        }

        .step-card:hover {
            transform: translateX(8px);
            border-color: var(--primary);
        }

        .step-number {
            width: 56px;
            height: 56px;
            background: var(--gradient-primary);
            border-radius: 16px;
            display: flex;
            align-items: center;
            justify-content: center;
            font-size: 1.5rem;
            font-weight: 800;
            color: #fff;
            flex-shrink: 0;
            box-shadow: 0 8px 20px rgba(255, 139, 0, 0.3);
        }

        .step-content h4 {
            font-size: 1.2rem;
            font-weight: 700;
            margin-bottom: 8px;
            color: var(--text-color);
        }

        .step-content p {
            color: var(--light-text);
            margin: 0;
        }

        /* ===== CODE BLOCKS ===== */
        .code-block {
            background: #1e293b;
            border-radius: 16px;
            overflow: hidden;
            margin: 16px 0;
        }

        .code-header {
            display: flex;
            align-items: center;
            justify-content: space-between;
            padding: 12px 20px;
            background: rgba(0, 0, 0, 0.3);
            border-bottom: 1px solid rgba(255, 255, 255, 0.1);
        }

        .code-header span {
            display: flex;
            align-items: center;
            gap: 8px;
            color: #94a3b8;
            font-size: 0.85rem;
            font-weight: 600;
        }

        .code-header .dot {
            width: 12px;
            height: 12px;
            border-radius: 50%;
        }

        .code-header .dot.green { background: #4ade80; }
        .code-header .dot.yellow { background: #facc15; }
        .code-header .dot.red { background: #f87171; }

        .code-block pre {
            padding: 20px;
            margin: 0;
            overflow-x: auto;
        }

        .code-block code {
            font-family: 'Fira Code', 'Consolas', monospace;
            font-size: 0.85rem;
            line-height: 1.6;
        }

        /* ===== ALERT BOXES ===== */
        .alert {
            display: flex;
            gap: 16px;
            padding: 20px 24px;
            border-radius: 16px;
            margin: 20px 0;
        }

        .alert-warning {
            background: linear-gradient(135deg, rgba(255, 159, 67, 0.15) 0%, rgba(255, 139, 0, 0.1) 100%);
            border: 1px solid rgba(255, 159, 67, 0.3);
        }

        .alert-warning .alert-icon {
            color: var(--warning);
            font-size: 1.3rem;
        }

        .alert-success {
            background: linear-gradient(135deg, rgba(40, 199, 111, 0.15) 0%, rgba(72, 187, 120, 0.1) 100%);
            border: 1px solid rgba(40, 199, 111, 0.3);
        }

        .alert-success .alert-icon {
            color: var(--success);
            font-size: 1.3rem;
        }

        .alert-content h4 {
            font-size: 0.95rem;
            font-weight: 700;
            margin-bottom: 4px;
            color: var(--text-color);
        }

        .alert-content p {
            font-size: 0.9rem;
            color: var(--light-text);
            margin: 0;
        }

        /* ===== SCOPE BADGES ===== */
        .scope-grid {
            display: grid;
            grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
            gap: 16px;
            margin: 20px 0;
        }

        .scope-card {
            display: flex;
            align-items: center;
            gap: 16px;
            padding: 20px;
            background: var(--card-bg);
            border-radius: 16px;
            border: 1px solid rgba(0, 0, 0, 0.05);
            transition: var(--transition);
        }

        [data-theme="dark"] .scope-card {
            border-color: rgba(255, 255, 255, 0.1);
        }

        .scope-card:hover {
            border-color: var(--primary);
            transform: translateY(-2px);
        }

        .scope-badge {
            padding: 6px 14px;
            border-radius: 8px;
            font-size: 0.75rem;
            font-weight: 700;
            text-transform: uppercase;
        }

        .scope-badge.read {
            background: rgba(59, 130, 246, 0.15);
            color: #3b82f6;
        }

        .scope-badge.write {
            background: rgba(40, 199, 111, 0.15);
            color: #28c76f;
        }

        .scope-info code {
            font-weight: 700;
            color: var(--text-color);
        }

        .scope-info p {
            font-size: 0.85rem;
            color: var(--light-text);
            margin: 4px 0 0;
        }

        /* ===== ENDPOINT CARDS ===== */
        .endpoint-card {
            background: var(--card-bg);
            border-radius: var(--border-radius-lg);
            overflow: hidden;
            margin-bottom: 24px;
            border: 1px solid rgba(0, 0, 0, 0.05);
            transition: var(--transition);
        }

        [data-theme="dark"] .endpoint-card {
            border-color: rgba(255, 255, 255, 0.1);
        }

        .endpoint-card:hover {
            box-shadow: 0 20px 50px rgba(0, 0, 0, 0.12);
        }

        .endpoint-header {
            display: flex;
            align-items: center;
            justify-content: space-between;
            padding: 20px 28px;
            background: linear-gradient(135deg, rgba(255, 139, 0, 0.08) 0%, rgba(176, 55, 0, 0.05) 100%);
            border-bottom: 1px solid rgba(0, 0, 0, 0.05);
        }

        [data-theme="dark"] .endpoint-header {
            background: linear-gradient(135deg, rgba(255, 139, 0, 0.15) 0%, rgba(176, 55, 0, 0.1) 100%);
            border-bottom-color: rgba(255, 255, 255, 0.1);
        }

        .endpoint-method {
            display: flex;
            align-items: center;
            gap: 16px;
        }

        .method-badge {
            padding: 8px 16px;
            border-radius: 10px;
            font-size: 0.8rem;
            font-weight: 700;
        }

        .method-badge.post {
            background: var(--gradient-primary);
            color: #fff;
        }

        .method-badge.get {
            background: linear-gradient(135deg, var(--success), #229954);
            color: #fff;
        }

        .endpoint-name {
            font-weight: 700;
            font-size: 1.1rem;
            color: var(--text-color);
        }

        .endpoint-scope {
            padding: 6px 14px;
            background: rgba(255, 139, 0, 0.1);
            color: var(--primary);
            border-radius: 8px;
            font-size: 0.8rem;
            font-weight: 600;
        }

        .endpoint-body {
            padding: 28px;
        }

        .endpoint-path {
            display: inline-block;
            padding: 12px 20px;
            background: rgba(0, 0, 0, 0.04);
            border-radius: 10px;
            font-family: 'Fira Code', monospace;
            font-size: 0.9rem;
            color: var(--primary);
            margin-bottom: 16px;
        }

        [data-theme="dark"] .endpoint-path {
            background: rgba(255, 255, 255, 0.05);
        }

        .endpoint-desc {
            color: var(--light-text);
            margin-bottom: 20px;
        }

        .endpoint-examples {
            display: grid;
            grid-template-columns: 1fr 1fr;
            gap: 20px;
        }

        .example-label {
            font-size: 0.85rem;
            font-weight: 700;
            color: var(--text-color);
            margin-bottom: 8px;
        }

        /* ===== FOOTER ===== */
        .footer {
            background: var(--card-bg);
            padding: 40px 0;
            border-top: 1px solid rgba(0, 0, 0, 0.05);
        }

        [data-theme="dark"] .footer {
            border-top-color: rgba(255, 255, 255, 0.1);
        }

        .footer-content {
            display: flex;
            align-items: center;
            justify-content: space-between;
        }

        .footer-logo {
            display: flex;
            align-items: center;
            gap: 16px;
        }

        .footer-logo img {
            height: 36px;
        }

        .footer-logo span {
            color: var(--light-text);
            font-size: 0.9rem;
        }

        .footer-links {
            display: flex;
            gap: 32px;
        }

        .footer-links a {
            color: var(--light-text);
            text-decoration: none;
            font-weight: 600;
            transition: var(--transition);
        }

        .footer-links a:hover {
            color: var(--primary);
        }

        /* ===== RESPONSIVE ===== */
        @media (max-width: 992px) {
            .header {
                width: calc(100% - 24px);
                top: 10px;
                border-radius: 16px;
                padding: 12px 0;
            }

            .nav-links {
                display: none;
            }

            .content-grid {
                grid-template-columns: 1fr;
            }

            .sidebar {
                position: static;
            }

            .hero h1 {
                font-size: 2.5rem;
            }

            .endpoint-examples {
                grid-template-columns: 1fr;
            }
        }

        @media (max-width: 768px) {
            .hero {
                padding-top: 120px;
                padding-bottom: 60px;
            }

            .hero h1 {
                font-size: 2rem;
            }

            .section-header {
                padding: 28px;
            }

            .section-header h2 {
                font-size: 1.8rem;
            }

            .footer-content {
                flex-direction: column;
                gap: 24px;
                text-align: center;
            }

            .footer-links {
                flex-wrap: wrap;
                justify-content: center;
                gap: 20px;
            }
        }