Skip to content

This project was originally developed during Next Level Week, presented by Rocketseat in April 2021. The codebase was refactored in 2025.

License

Notifications You must be signed in to change notification settings

ericrocha97/Podcastr

Repository files navigation

Podcastr

MIT License Next.js React TypeScript

Podcastr Logo

Podcastr é um reprodutor de podcasts moderno, construído com Next.js e React, que permite ouvir seus episódios favoritos diretamente do navegador. O projeto consome dados de um feed RSS e oferece uma interface limpa, responsiva e amigável para navegação e reprodução de áudio.


✨ Recursos

  • Navegação de Episódios: Veja os episódios mais recentes e acesse todos os episódios disponíveis.
  • Player de Áudio Integrado: Ouça episódios com controles intuitivos.
  • Design Responsivo: Interface adaptável a qualquer dispositivo.
  • Tema Claro/Escuro: Alternância de tema para melhor experiência visual.

🚀 Tecnologias Utilizadas

  • Next.js – Framework React para SSR e SSG.
  • React – Biblioteca para interfaces de usuário.
  • TypeScript – Tipagem estática para JavaScript.
  • Tailwind CSS – Utilitários CSS para estilização.
  • Radix UI – Componentes de UI acessíveis.
  • shadcn/ui – Componentes de interface reutilizáveis e acessíveis.
  • Lucide React – Ícones SVG modernos.
  • Rose Pine Theme – Tema visual elegante e suave para a interface.

🛠️ Como começar

Pré-requisitos

Instalação e Execução

  1. Clone o repositório:

    git clone https://github.com/ericrocha97/Podcastr.git
    cd Podcastr
  2. Instale as dependências:

    pnpm install
  3. Configure as variáveis de ambiente: Crie um arquivo .env.local na raiz do projeto e adicione:

    API_RSS=URL_DO_SEU_FEED_RSS
    NEXT_PUBLIC_BASE_URL=http://localhost:3000
  4. Inicie o servidor de desenvolvimento:

    pnpm dev

Abra http://localhost:3000 no navegador para ver o resultado.


📋 Scripts Disponíveis

No diretório do projeto, execute:

  • pnpm dev — Executa a aplicação em modo de desenvolvimento.
  • pnpm build — Compila a aplicação para produção.
  • pnpm start — Inicia o servidor de produção.
  • pnpm lint — Formata o código usando o Biome.

💡 Exemplo de Uso

  1. Acesse a página inicial para ver os episódios mais recentes.
  2. Clique em um episódio para ver detalhes e ouvir no player integrado.
  3. Use o botão de alternância de tema para mudar entre claro e escuro.

🤝 Contribuindo

Contribuições são bem-vindas! Siga os passos abaixo para colaborar:

  1. Faça um fork do projeto
  2. Crie uma branch para sua feature (git checkout -b feature/SuaFeature)
  3. Commit suas alterações (git commit -m 'feat: adiciona SuaFeature')
  4. Faça push para a branch (git push origin feature/SuaFeature)
  5. Abra uma Pull Request

Ou abra uma issue com sugestões, dúvidas ou problemas encontrados.

Não se esqueça de deixar uma estrela ⭐ no projeto!


📄 Licença

Distribuído sob a Licença MIT. Veja o arquivo LICENSE para mais informações.

About

This project was originally developed during Next Level Week, presented by Rocketseat in April 2021. The codebase was refactored in 2025.

Topics

Resources

License

Stars

Watchers

Forks