[PT-BR] DecoMusic

DecoMusic é um projeto desenvolvido durante um hackathon de mais de 24 horas organizado pela deco.cx. É uma aplicação de página única construída utilizando Preact, TypeScript, Deno e Tailwind CSS. O projeto prioriza a praticidade e desempenho dos sites.

O objetivo principal do DecoMusic é fornecer prévias de músicas utilizando a API do iTunes. Os usuários podem buscar músicas pelo nome do artista principal, reproduzi-las e salvá-las em uma lista de favoritos. A lista de favoritos é mantida mesmo quando o usuário sai da página.

O site é totalmente responsivo e se adapta a diferentes dispositivos, como celulares, tablets e computadores.

Colaboradores

• Alisson Tassi - GitHub: Alisson Seraphim
• Dijair - GitHub: dijair12

Hospedagem

O DecoMusic é hospedado pela Deco e pode ser acessado em https://deco-sites-decomusic.deno.dev.

Tecnologias Utilizadas

• Preact
• TypeScript
• Deno
• Tailwind CSS

Funcionalidades

• Buscar músicas pelo nome do artista principal
• Reproduzir prévias de músicas
• Salvar músicas em uma lista de favoritos
• Armazenamento persistente da lista de favoritos
• Design responsivo para celulares, tablets e computadores

Execução

Para executar o projeto DecoMusic, siga estas etapas:

1. Clone o repositório do GitHub:

2. Navegue até a pasta do projeto:

3. Execute o comando para iniciar o servidor: deno task start

4. Abra o navegador e acesse http://localhost:8000 para utilizar o DecoMusic.

Contribuição

Aceitamos contribuições para o DecoMusic! Se você deseja contribuir, siga estas etapas:

1. Faça um fork do repositório no GitHub.
2. Crie uma nova branch para a sua funcionalidade ou correção.
3. Faça as alterações necessárias e faça commit do seu código.
4. Faça push das suas alterações para o seu fork.
5. Envie um pull request para o repositório principal.

[EN] DecoMusic

DecoMusic is a project developed during a hackathon that lasted over 24 hours, organized by deco.cx. It is a single-page application built using Preact, TypeScript, Deno, and Tailwind CSS. The project prioritizes the practicality and performance of websites.

The main purpose of DecoMusic is to provide song previews using the iTunes API. Users can search for songs by the name of the main artist, play them, and save them to a favorites list. The favorites list remains saved even when the user leaves the page.

The website is responsive and adapts to different devices such as mobile phones, tablets, and computers.

Collaborators

• Alisson Tassi - GitHub: Alisson Seraphim
• Dijair - GitHub: dijair12

Deployment

DecoMusic is deployed by Deco and can be accessed at https://deco-sites-decomusic.deno.dev.

Technologies Used

• Preact
• TypeScript
• Deno
• Tailwind CSS

Features

• Search for songs by the name of the main artist
• Play song previews
• Save songs to a favorites list
• Persistent storage of the favorites list
• Responsive design for mobile phones, tablets, and computers

Execution

To run the DecoMusic project, follow these steps:

1. Clone the repository from GitHub:

2. Navigate to the project directory:

3. Execute the command to start the server: deno task start

4. Open your web browser and go to http://localhost:8000 to use DecoMusic.

Contributing

We welcome contributions to DecoMusic! If you'd like to contribute, please follow these steps:

1. Fork the repository on GitHub.
2. Create a new branch for your feature or bug fix.
3. Make the necessary changes and commit your code.
4. Push your changes to your fork.
5. Submit a pull request to the main repository.