Estilos que se Aplican en Todas Partes

Los estilos con alcance limitado son geniales para los componentes, pero algunos estilos deben ser globales: tipografía, variables de color, estilos de reseteo y estilos de elementos base. SvelteKit ofrece varias formas de agregar CSS global.

Lo que Aprenderás

Agregar hojas de estilos globales a SvelteKit
Crear propiedades personalizadas de CSS (variables)
Configurar tipografía base
Usar el modificador :global()

Agregar una Hoja de Estilos Global

Crea un archivo CSS e impórtalo en tu layout:

/* filename: src/app.css */
/* Reset and base styles */
*,
*::before,
*::after {
  box-sizing: border-box;
}

body {
  margin: 0;
  font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
  line-height: 1.6;
  color: #1f2937;
  background: #f9fafb;
}

h1, h2, h3, h4, h5, h6 {
  margin: 0 0 0.5em 0;
  line-height: 1.3;
}

p {
  margin: 0 0 1em 0;
}

a {
  color: #3b82f6;
}

img {
  max-width: 100%;
  height: auto;
}

Impórtalo en tu layout raíz:

<!-- filename: src/routes/+layout.svelte -->
<script>
  import '../app.css';
  
  let { children } = $props();
</script>

{@render children()}

Ahora estos estilos se aplican a todas las páginas.

Propiedades Personalizadas de CSS

Define tokens de diseño como variables CSS para mantener la consistencia:

/* filename: src/app.css */
:root {
  /* Colors */
  --color-primary: #3b82f6;
  --color-primary-dark: #2563eb;
  --color-primary-light: #eff6ff;
  
  --color-success: #10b981;
  --color-warning: #f59e0b;
  --color-error: #ef4444;
  
  --color-gray-50: #f9fafb;
  --color-gray-100: #f3f4f6;
  --color-gray-200: #e5e7eb;
  --color-gray-300: #d1d5db;
  --color-gray-400: #9ca3af;
  --color-gray-500: #6b7280;
  --color-gray-600: #4b5563;
  --color-gray-700: #374151;
  --color-gray-800: #1f2937;
  --color-gray-900: #111827;
  
  /* Typography */
  --font-sans: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
  --font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, monospace;
  
  /* Spacing */
  --space-1: 0.25rem;
  --space-2: 0.5rem;
  --space-3: 0.75rem;
  --space-4: 1rem;
  --space-6: 1.5rem;
  --space-8: 2rem;
  
  /* Border radius */
  --radius-sm: 4px;
  --radius-md: 8px;
  --radius-lg: 12px;
  --radius-full: 9999px;
  
  /* Shadows */
  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.05);
  --shadow-md: 0 4px 6px rgba(0, 0, 0, 0.1);
  --shadow-lg: 0 10px 15px rgba(0, 0, 0, 0.1);
}

Úsalas en los componentes:

<style>
  .card {
    background: white;
    border: 1px solid var(--color-gray-200);
    border-radius: var(--radius-lg);
    padding: var(--space-6);
  }
  
  .btn-primary {
    background: var(--color-primary);
    color: white;
  }
  
  .btn-primary:hover {
    background: var(--color-primary-dark);
  }
</style>

Beneficios:

Cambia los colores en un solo lugar
Espaciado consistente en toda la aplicación
Temas fáciles de implementar (modo oscuro más adelante)

Escala Tipográfica

Configura una escala tipográfica consistente:

/* filename: src/app.css */
body {
  font-size: 16px;
}

h1 {
  font-size: 2.25rem;   /* 36px */
  font-weight: 700;
}

h2 {
  font-size: 1.875rem;  /* 30px */
  font-weight: 600;
}

h3 {
  font-size: 1.5rem;    /* 24px */
  font-weight: 600;
}

h4 {
  font-size: 1.25rem;   /* 20px */
  font-weight: 600;
}

h5 {
  font-size: 1.125rem;  /* 18px */
  font-weight: 500;
}

h6 {
  font-size: 1rem;      /* 16px */
  font-weight: 500;
}

.text-sm {
  font-size: 0.875rem;  /* 14px */
}

.text-xs {
  font-size: 0.75rem;   /* 12px */
}

.text-lg {
  font-size: 1.125rem;  /* 18px */
}

.text-xl {
  font-size: 1.25rem;   /* 20px */
}

Clases de Utilidad

Agrega utilidades de uso frecuente:

/* filename: src/app.css */

/* Layout */
.container {
  max-width: 1200px;
  margin: 0 auto;
  padding: 0 var(--space-4);
}

/* Text alignment */
.text-center { text-align: center; }
.text-left { text-align: left; }
.text-right { text-align: right; }

/* Font weight */
.font-normal { font-weight: 400; }
.font-medium { font-weight: 500; }
.font-semibold { font-weight: 600; }
.font-bold { font-weight: 700; }

/* Colors */
.text-primary { color: var(--color-primary); }
.text-muted { color: var(--color-gray-500); }
.text-error { color: var(--color-error); }

/* Visibility */
.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}

Úsalas en el markup:

<p class="text-muted text-sm">Last updated: January 2025</p>
<h2 class="text-center">Our Services</h2>
<span class="sr-only">Opens in new window</span>

El Modificador :global()

A veces necesitas estilos globales dentro de un componente. Usa :global():

<style>
  /* Scoped - only affects this component */
  .card {
    padding: 1rem;
  }
  
  /* Global - affects all elements */
  :global(body.modal-open) {
    overflow: hidden;
  }
  
  /* Nested global - child elements of this component */
  .content :global(a) {
    color: var(--color-primary);
  }
  
  /* Global modifier on class */
  :global(.tooltip) {
    position: absolute;
    z-index: 1000;
  }
</style>

Úsalo con moderación — los estilos con alcance limitado generalmente son mejores.

app.css Completo

Aquí tienes una hoja de estilos base exhaustiva:

/* filename: src/app.css */

/* ===== CSS Variables ===== */
:root {
  /* Colors */
  --color-primary: #3b82f6;
  --color-primary-dark: #2563eb;
  --color-primary-light: #eff6ff;
  
  --color-success: #10b981;
  --color-warning: #f59e0b;
  --color-error: #ef4444;
  
  --color-gray-50: #f9fafb;
  --color-gray-100: #f3f4f6;
  --color-gray-200: #e5e7eb;
  --color-gray-300: #d1d5db;
  --color-gray-400: #9ca3af;
  --color-gray-500: #6b7280;
  --color-gray-600: #4b5563;
  --color-gray-700: #374151;
  --color-gray-800: #1f2937;
  --color-gray-900: #111827;
  
  /* Typography */
  --font-sans: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
  
  /* Spacing */
  --space-1: 0.25rem;
  --space-2: 0.5rem;
  --space-3: 0.75rem;
  --space-4: 1rem;
  --space-6: 1.5rem;
  --space-8: 2rem;
  --space-12: 3rem;
  
  /* Border radius */
  --radius-sm: 4px;
  --radius-md: 8px;
  --radius-lg: 12px;
  
  /* Shadows */
  --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.05);
  --shadow-md: 0 4px 6px rgba(0, 0, 0, 0.1);
  --shadow-lg: 0 10px 15px rgba(0, 0, 0, 0.1);
}

/* ===== Reset ===== */
*,
*::before,
*::after {
  box-sizing: border-box;
}

* {
  margin: 0;
}

html {
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

body {
  font-family: var(--font-sans);
  font-size: 1rem;
  line-height: 1.6;
  color: var(--color-gray-800);
  background: var(--color-gray-50);
}

img, picture, video, canvas, svg {
  display: block;
  max-width: 100%;
}

input, button, textarea, select {
  font: inherit;
}

/* ===== Typography ===== */
h1, h2, h3, h4, h5, h6 {
  line-height: 1.3;
  color: var(--color-gray-900);
}

h1 { font-size: 2.25rem; font-weight: 700; }
h2 { font-size: 1.875rem; font-weight: 600; }
h3 { font-size: 1.5rem; font-weight: 600; }
h4 { font-size: 1.25rem; font-weight: 600; }

p {
  margin-bottom: 1rem;
}

a {
  color: var(--color-primary);
  text-decoration: none;
}

a:hover {
  text-decoration: underline;
}

/* ===== Layout ===== */
.container {
  max-width: 1200px;
  margin: 0 auto;
  padding: 0 var(--space-4);
}

.page {
  padding: var(--space-8) 0;
}

/* ===== Utilities ===== */
.text-center { text-align: center; }
.text-muted { color: var(--color-gray-500); }
.text-sm { font-size: 0.875rem; }

.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}

Usar Variables en los Componentes

Referencia variables globales en cualquier lugar:

<!-- filename: src/lib/components/ServiceCard.svelte -->
<style>
  .card {
    background: white;
    border: 1px solid var(--color-gray-200);
    border-radius: var(--radius-lg);
    padding: var(--space-6);
    transition: box-shadow 0.2s ease;
  }
  
  .card:hover {
    box-shadow: var(--shadow-md);
  }
  
  .price {
    color: var(--color-primary);
    font-weight: 600;
  }
</style>

Los componentes se mantienen consistentes con el sistema de diseño global.

Errores Comunes

Abusar de :global()

<style>
  /* ❌ Too much global */
  :global(.card) { }
  :global(.btn) { }
  :global(.title) { }
  
  /* ✅ Keep styles scoped, use variables for consistency */
  .card {
    border-radius: var(--radius-lg);
  }
</style>

Valores Hardcodeados

<style>
  /* ❌ Inconsistent hardcoded values */
  .card { padding: 17px; border-radius: 11px; }
  .form { padding: 1.2rem; border-radius: 8px; }
  
  /* ✅ Use variables for consistency */
  .card { padding: var(--space-4); border-radius: var(--radius-lg); }
  .form { padding: var(--space-4); border-radius: var(--radius-lg); }
</style>

¡Módulo Completo! 🎉

Has terminado el Módulo 8: Estilos. BookIt ahora tiene:

Estilos de componentes con alcance limitado
Diseño de tarjetas profesional
Manejo dinámico de clases
Estilos de formulario pulidos
Efectos hover suaves
Sistema de diseño global consistente

🎯 ¡Nivel Principiante Completo!

¡Felicitaciones! Has completado el nivel Principiante del camino de aprendizaje de BookIt.

Lo que construiste:

Estructura de proyecto SvelteKit
Múltiples páginas con enrutamiento
Layouts compartidos con encabezado/pie de página
Estado reactivo con $state
Flujo de control con {#if} y {#each}
Entradas de formulario con enlace de datos
Componentes reutilizables con props
Estilos CSS profesionales

Lo que funciona:

Explorar servicios
Ver detalles de servicios
Completar el formulario de reserva
Ver una vista previa en vivo del formulario
Navegar entre páginas

Lo que falta:

Los datos aún están hardcodeados
El formulario no guarda realmente
Sin base de datos
Sin lógica del lado del servidor

Resumen

Los estilos globales establecen la base: colores, tipografía, espaciado y estilos de elementos base. Usa variables CSS para mantener la consistencia, importa el CSS global en tu layout raíz y usa :global() con moderación para casos especiales.

Puntos clave:

Importa app.css en +layout.svelte
Define tokens de diseño como variables CSS
Crea clases utilitarias para patrones comunes
Usa :global() solo cuando sea necesario

Próximos Pasos

¡La aplicación del lado del cliente está completa! Continúa con el Módulo 9: Carga de Datos para comenzar el nivel Intermedio, donde cargarás datos reales desde el servidor y harás que BookIt funcione de verdad.