Estilos que se Aplicam em Todo Lugar

Estilos com escopo são ótimos para componentes, mas alguns estilos precisam ser globais: tipografia, variáveis de cor, estilos de reset e estilização de elementos base. O SvelteKit oferece várias formas de adicionar CSS global.

O que Você Vai Aprender

Adicionar folhas de estilo globais ao SvelteKit
Criar propriedades customizadas CSS (variáveis)
Configurar tipografia base
Usar o modificador :global()

Adicionando uma Folha de Estilo Global

Crie um arquivo CSS e importe-o no seu 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;
}

Importe-o no seu layout raiz:

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

{@render children()}

Agora esses estilos se aplicam a todas as páginas.

Propriedades Customizadas CSS

Defina tokens de design como variáveis CSS para garantir consistência:

/* 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);
}

Use-os nos 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>

Benefícios:

Altere cores em um único lugar
Espaçamento consistente em toda a aplicação
Temas facilitados (modo escuro futuramente)

Escala Tipográfica

Configure uma escala de tipos 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 */
}

Classes Utilitárias

Adicione utilitários comumente necessários:

/* 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;
}

Use-os na marcação:

<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>

O Modificador :global()

Às vezes você precisa de estilos globais dentro de um componente. Use :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>

Use com moderação — estilos com escopo geralmente são melhores.

app.css Completo

Aqui está uma folha de estilos base abrangente:

/* 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;
}

Usando Variáveis nos Componentes

Referencie variáveis globais em qualquer 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>

Os componentes permanecem consistentes com o sistema de design global.

Erros Comuns

Uso Excessivo 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 Fixos no Código

<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 Concluído! 🎉

Você concluiu o Módulo 8: Estilização. O BookIt agora possui:

Estilos de componente com escopo
Design de cartão profissional
Manipulação dinâmica de classes
Estilização de formulário refinada
Efeitos de hover suaves
Sistema de design global consistente

🎯 Nível Iniciante Concluído!

Parabéns! Você concluiu o nível Iniciante da trilha de aprendizado do BookIt.

O que você construiu:

Estrutura de projeto SvelteKit
Múltiplas páginas com roteamento
Layouts compartilhados com cabeçalho/rodapé
Estado reativo com $state
Fluxo de controle com {#if} e {#each}
Entradas de formulário com vinculação de dados
Componentes reutilizáveis com props
Estilização CSS profissional

O que funciona:

Navegar pelos serviços
Ver detalhes dos serviços
Preencher o formulário de agendamento
Ver prévia do formulário em tempo real
Navegar entre páginas

O que está faltando:

Os dados ainda estão fixos no código
O formulário não salva de verdade
Sem banco de dados
Sem lógica no lado do servidor

Resumo

Os estilos globais estabelecem a base: cores, tipografia, espaçamento e estilização de elementos base. Use variáveis CSS para consistência, importe CSS global no seu layout raiz e use :global() com moderação para casos extremos.

Principais conclusões:

Importe app.css no +layout.svelte
Defina tokens de design como variáveis CSS
Crie classes utilitárias para padrões comuns
Use :global() somente quando necessário

Próximos Passos

O aplicativo client-side está completo! Continue para o Módulo 9: Carregando Dados para iniciar o nível Intermediário, onde você carregará dados reais do servidor e fará o BookIt funcionar de verdade.