Skip to content

Home

Jump to bottom
Jeiel0rbit edited this page Jul 29, 2025 · 1 revision

Bem-vindo à Wiki do LoFi Square!

Olá, eu sou Jeiel Miranda, o criador do LoFi Square. Criei este espaço para compartilhar um pouco mais sobre minha jornada e os detalhes técnicos deste projeto, que nasceu com gosto de ouvir lofi rádio.

Sumário

✨ Sobre o Projeto:

Criei o LoFi Square com um objetivo simples: ter um ambiente sonoro para foco e relaxamento que fosse visualmente limpo, sem as distrações de outras plataformas. Minha inspiração para o design veio de uma estética espacial, combinando um fundo de partículas animadas com um player translúcido (efeito glassmorphism) e como base empresa Square Cloud.

O projeto evoluiu de executáveis pesados para um PWA (Progressive Web App) leve e rápido, garantindo que qualquer pessoa possa acessá-lo e instalá-lo com um clique, independentemente do dispositivo.

🛠️ Visão Técnica:

Tomei a decisão de unificar todo o código em um único arquivo index.html. Isso pode parecer incomum, mas para um projeto desta escala, simplifica enormemente minha manutenção e desenvolvimento.

Minha estrutura é a seguinte:

  • index.html: É o coração do projeto

    • HTML: Define a estrutura do player
    • CSS: A estilização é feita primariamente com Tailwind CSS, carregado via CDN. Adicionei uma pequena tag <style> para animações específicas, como o fundo de partículas
    • JavaScript: Toda a lógica do player está aqui. Organizei as estações de rádio em um objeto chamado categories, facilitando a adição de novos streams

  • manifest.json: Define o comportamento do PWA, permitindo que o site seja "instalado" como um aplicativo

🤝 Como Contribuir:

Fico muito feliz com o interesse em ajudar a melhorar o LoFi Square! Toda contribuição é bem-vinda.

  • Ideias e Bugs: A melhor forma de começar é abrindo uma Issue no repositório para sugerir uma nova funcionalidade ou relatar um bug que encontrou
  • Enviando Código: Se quer adicionar uma rádio, corrigir um bug ou implementar algo novo, o processo é simples:
    1. Faça um fork do repositório
    2. Crie uma nova branch para sua alteração
    3. Envie um Pull Request detalhando o que fez

Para mais detalhes sobre meu estilo de código e mensagens de commit, por favor, leia meu Guia de Contribuição.

Para garantir um ambiente respeitoso para todos, peço que siga meu Código de Conduta.

🗺️ Roteiro (Roadmap):

Embora o projeto já esteja em uma versão que me agrada muito, tenho algumas ideias para o futuro:

  • Temas Customizáveis: Quero permitir que o usuário escolha diferentes temas visuais.
  • Mais Streams: Planejo adicionar mais categorias e rádios de qualidade.
  • Visualizador de Áudio: Pretendo implementar uma animação sutil que reage à música.

Sinta-se à vontade para sugerir novas ideias para meu roadmap através das Issues!

Clone this wiki locally