Add better spacing and color palette for headers.

Signed-off-by: James R. Perkins <jperkins@ibm.com>

Author: jamezp

public/css/bootstrap-theme.css

@@ -36,6 +36,67 @@ body#project {
   overflow-x: hidden !important;
 }
 
+/* ============================================
+   TYPOGRAPHY - Headings
+   ============================================ */
+/* General heading styles with proper hierarchy */
+h1 {
+  color: var(--resteasy-primary-dark) !important;
+  font-weight: 700 !important;
+  margin-top: 2rem !important;
+  margin-bottom: 1.5rem !important;
+  line-height: 1.2 !important;
+}
+
+h2 {
+  color: var(--resteasy-primary) !important;
+  font-weight: 600 !important;
+  margin-top: 2.5rem !important;
+  margin-bottom: 1rem !important;
+  line-height: 1.3 !important;
+}
+
+h3 {
+  color: var(--resteasy-primary-light) !important;
+  font-weight: 600 !important;
+  margin-top: 2rem !important;
+  margin-bottom: 0.75rem !important;
+  line-height: 1.4 !important;
+}
+
+h4 {
+  color: var(--resteasy-text-muted) !important;
+  font-weight: 600 !important;
+  margin-top: 1.5rem !important;
+  margin-bottom: 0.5rem !important;
+  line-height: 1.4 !important;
+}
+
+/* First heading on page shouldn't have top margin */
+.container > h1:first-child,
+.container > h2:first-child,
+#main > h1:first-child,
+#main > h2:first-child {
+  margin-top: 0 !important;
+}
+
+/* Dark mode heading colors */
+[data-bs-theme="dark"] h1 {
+  color: #e6edf3 !important;
+}
+
+[data-bs-theme="dark"] h2 {
+  color: var(--resteasy-accent-light) !important;
+}
+
+[data-bs-theme="dark"] h3 {
+  color: var(--resteasy-accent) !important;
+}
+
+[data-bs-theme="dark"] h4 {
+  color: #8b949e !important;
+}
+
 /* Fix Bootstrap containers - no fixed heights! */
 .container,
 .container-fluid {