mirsui

O que é

Frontend do Mirsui, em Next.js 14 (App Router). O backend fica em um repositório separado, mirsui-backend, e é ele quem fala com o Postgres na maior parte dos casos — o frontend só usa o Supabase direto para sessão e para leituras públicas da landing.

Rodar

npm install
npm run dev     # sobe em :3001

Variáveis de ambiente

# Supabase (sessão e leituras públicas)
NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=

# Backend
BACKEND_URL=
NEXT_PUBLIC_BACKEND_URL=

# Site (canonical, OG)
NEXT_PUBLIC_SITE_URL=

# Quem abre /admin — lista de e-mails separada por vírgula. É uma cópia
# deliberada da lista do backend, não um import: ver lib/admin.ts.
ADMIN_EMAILS=

# Analytics (ambos opcionais; sem chave, cada um desliga sozinho)
NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX
NEXT_PUBLIC_POSTHOG_KEY=
NEXT_PUBLIC_POSTHOG_HOST=
NEXT_PUBLIC_POSTHOG_UI_HOST=

# APIs externas (reserva; a fonte principal de catálogo é o Deezer, que não
# pede credencial)
SPOTIFY_CLIENT_ID=
SPOTIFY_CLIENT_SECRET=
YOUTUBE_API_KEY=

Analytics

Duas ferramentas, com papéis diferentes:

• Google Analytics — só pageview, em lib/gtag.ts + hooks/use-analytics.tsx.
• PostHog — eventos de produto, via capture() de lib/posthog.ts. É onde moram os eventos de salvar, botar ficha, compartilhar e login.

Documentos

• DESIGN.md — guia da identidade aprovada: princípios, tokens, componentes e como aplicá-la em outras telas. Referência preservada na tag design-club-v1; capturas em docs/redesign/.
• REVISITAR.md — leia antes de divulgar o Mirsui em qualquer lugar com audiência. O que quebra quando o site der certo, com os números medidos.
• docs/plano-de-urls-e-seo.md — a forma das URLs e por que a indexação está segurada.
• docs/analise-entidade-da-faixa.md — página derivada ou registro.
• Stake.md — as regras das fichas.

To-do

• Send Suggestion page
• Página de configurações do perfil (o item saiu do menu do avatar até existir — apontava para /settings, que nunca foi criada)
• Index page on Google Search (ver docs/plano-de-urls-e-seo.md §10)
• Tema claro por preferência do sistema
• Terminar a página do artista — e virou urgente por um motivo que não é de acabamento: em 26/08 ela é a maior fonte de tráfego de robô do site, porque publica link por id do Deezer para toda faixa fora do catálogo. Ver REVISITAR.md §4.1.
• Documentação do projeto