🌐 ACESSAR A DEMO AO VIVO

📖 Sobre o projeto

Brasil Time é uma aplicação web leve e responsiva construída inteiramente em tecnologias nativas do navegador — sem frameworks nem dependências externas. O foco é entregar uma experiência rápida, precisa e elegante para quem precisa acompanhar o horário oficial de Brasília (BRT) e ferramentas de tempo do dia a dia.

Toda a lógica roda no lado do cliente, o que torna o projeto leve, instantâneo no carregamento e hospedado gratuitamente via GitHub Pages.

✨ Funcionalidades

Recurso	Descrição
🕐 Relógio digital	Hora atual no fuso de Brasília (BRT), atualizada em tempo real.
⏱️ Cronômetro	Contagem progressiva com precisão de centésimos de segundo — iniciar, pausar e zerar.
⏳ Temporizador	Contagem regressiva configurável com alerta ao final.
📅 Feriados	Consulta rápida aos feriados nacionais brasileiros.
🌗 Tema claro/escuro	Alternância de tema com preferência salva no navegador.
📱 Responsivo	Layout adaptável para desktop, tablet e celular.

Nota: o cronômetro é progressivo e o temporizador é regressivo, seguindo o uso convencional. Se a sua implementação inverter essa lógica, basta ajustar a tabela.

🖼️ Preview

Adicione aqui um GIF ou capturas de tela da aplicação em funcionamento.

🚀 Começando

Por ser uma aplicação 100% estática, não há etapa de build nem instalação de pacotes.

Acesso online

A versão publicada está disponível diretamente pelo GitHub Pages:

🔗 https://destypc.github.io/Brasil-Time/

Execução local

Clone o repositório:

git clone https://github.com/destypc/Brasil-Time.git
cd Brasil-Time

Abra o index.html no navegador ou suba um servidor estático para evitar restrições de origem:

# Python 3
python -m http.server 8000

# Node.js (npx)
npx serve

Depois acesse http://localhost:8000 no navegador.

Publicando no GitHub Pages

1. Vá em Settings → Pages no repositório.
2. Em Source, selecione a branch (main) e a pasta raiz (/root).
3. Salve — em alguns instantes o site estará no ar em https://destypc.github.io/Brasil-Time/.

🧭 Como usar

Navegue entre as seções pelo menu principal:

1. Relógio — exibe a hora atual de Brasília.
2. Cronômetro — mede o tempo decorrido com precisão de centésimos.
3. Temporizador — define uma contagem regressiva com alerta.
4. Feriados — lista os feriados nacionais brasileiros.

Use o botão de tema para alternar entre claro e escuro — a escolha é mantida na próxima visita.

📁 Estrutura do projeto

Brasil-Time/
├── index.html              # Página principal (Relógio)
├── paginas/
│   ├── stopwatch.html      # Cronômetro
│   ├── timer.html          # Temporizador
│   └── holidays.html       # Feriados
├── scripts/
│   ├── clock.js            # Lógica do relógio
│   ├── stopwatch.js        # Lógica do cronômetro
│   ├── timer.js            # Lógica do temporizador
│   ├── holidays.js         # Dados dos feriados
│   └── theme.js            # Gerenciamento de tema
├── estilos/
│   └── style.css           # Estilos da aplicação
└── README.md               # Este arquivo

🛠️ Tecnologias

• HTML5 — estrutura semântica das páginas
• CSS3 — estilização e layout responsivo com Flexbox
• JavaScript (Vanilla) — toda a lógica de tempo e interatividade
• Web Storage API (localStorage) — persistência da preferência de tema
• GitHub Pages — hospedagem estática gratuita
• Sem dependências externas — nenhum framework ou biblioteca de terceiros

⚙️ Detalhes técnicos

• Fuso horário preciso: a hora é formatada com a API Intl.DateTimeFormat usando o timezone America/Sao_Paulo, garantindo o horário correto de Brasília independentemente do fuso local do usuário.
• Persistência de tema: a preferência (claro/escuro) é salva no localStorage e reaplicada automaticamente a cada visita.
• Layout responsivo: construído com Flexbox para se adaptar a diferentes tamanhos de tela.
• Carregamento instantâneo: sem dependências externas, todo o conteúdo é servido de forma estática.

🗺️ Roadmap

• Suporte a múltiplos fusos horários brasileiros (AMT, ACT, FNT)
• Sons de alerta personalizáveis no temporizador
• Cálculo automático de feriados móveis (Carnaval, Páscoa, Corpus Christi)
• Exportação de marcações do cronômetro
• Progressive Web App (uso offline)

🤝 Contribuindo

Contribuições são bem-vindas! Para sugerir melhorias:

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/minha-feature)
3. Commit suas mudanças (git commit -m 'Adiciona minha feature')
4. Push para a branch (git push origin feature/minha-feature)
5. Abra um Pull Request

📄 Licença

Distribuído sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

👤 Autor

Luan Henrique Garcia