📝 Short Description
A web platform for music lovers to explore live concerts and setlists by artist, view past and upcoming shows, access ticket links, and save favorite artists. The app integrates data from Setlist.fm and Ticketmaster to deliver a seamless music event discovery experience.
💡 Problem It Solves
-
Difficulty finding upcoming concerts for favorite artists.
-
Lack of centralized access to historical setlists.
-
Poor connection between concert discovery and ticket purchase.
🌟 Unique Value Propositions
-
Combined real-time ticketing and historical concert data.
-
Artist-centered experience with customized curation.
-
Light, modern, and immersive UI/UX focused on music fans.
⚙️ Tech Stack
-
Frontend: React, React Router, TailwindCSS
-
Backend: Node.js, Express.js
-
APIs: Setlist.fm, Ticketmaster, Google Maps e Places, OpenStreetMap (Nominatim, Overpass), Wikipedia/Wikidata, LRCLib, Spotify, YouTube
-
Hosting: Github Pages + Render
🛠️ Como rodar
São dois projetos npm independentes. Não há workspace na raiz: client/ e server/ têm
node_modules próprios e cada um precisa do seu npm install.
git clone [email protected]:gilabarreto/concertfyi2000.git && cd concertfyi2000
npm install --prefix client
npm install --prefix server
Depois, dois terminais:
cd server && npm run dev # Express na :4000 (nodemon)
cd client && npm run dev # Vite na :3000
O client precisa do servidor no ar: o Vite encaminha /api para localhost:4000. Abrir só o
client dá uma home que carrega e uma busca que não devolve nada.
Testado com Node 22. O CI usa Node 24 — não há engines fixando versão em nenhum dos dois lados.
Variáveis de ambiente
O servidor existe por causa desta lista: é ele que fala com as APIs de terceiro, para que nenhuma
chave chegue ao browser. server/.env:
TICKETMASTER_API_KEY= SETLISTFM_API_KEY= YOUTUBE_API_KEY=
SPOTIFY_CLIENT_ID= SPOTIFY_CLIENT_SECRET= GOOGLE_PLACES_API_KEY= PORT=
client/.env — tudo aqui vai para dentro do bundle e é público por definição, então nada de
segredo:
VITE_API_BASE= VITE_GOOGLE_MAPS_KEY= VITE_FORMSPREE_ID= VITE_SPOTIFY_CLIENT_ID=
As do client também existem como secrets no GitHub, porque o build do deploy precisa delas.
✅ Portão de qualidade
npm run check # ~2,5s — segredo (staged) + formatação + lint + testes
npm run check:full # ~5s — o de cima + build do client
Rode antes do push. O check precisa do gitleaks no PATH. O CONSTRAINTS.md explica cada
número e por que ele é aquele — inclusive por que baixar um limite para o código passar não conta
como passar.
O deploy.yml roda a mesma coisa no CI antes do build: reprovou, o site não sobe. Uma vez por
semana, o weekly-checks.yml varre CVE nos dois lockfiles e bate no proxy, abrindo issue se algo
estiver errado.
🚀 Deploy
Automático dos dois lados, a partir de um push no main:
| Parte | Onde | Como dispara |
|---|
| Client | GitHub Pages (concertfyi.com) | deploy.yml builda e publica client/dist na branch gh-pages |
| Server | Render | O próprio Render observa o main e redeploya sozinho — não há workflow neste repositório fazendo isso |
Ou seja: um push no main publica os dois. Não existe ambiente de staging.
APIs e fontes de dados
Consulte o inventário de APIs, origem dos campos e fallbacks para revisar integrações e ideias. O API Lab (/api-lab) saiu do app em 2026-10-02: cumpriu o papel de comparar fontes. O código continua no git — git show 5445fdc mostra a última versão, e git checkout 5445fdc -- client/src/pages/ApiLab.jsx server/routes/apiLab.js traz de volta. Catálogo e receitas de cada chamada em docs/API_LAB_REFERENCIA.md.
