🎬 Superflix

Sua plataforma de streaming gratuita e open-source

Features • Demo • Começando • Contribuindo • Arquitetura

🎯 Sobre o Projeto

O Superflix é uma plataforma de streaming moderna desenvolvida em Next.js 16 que permite assistir filmes, séries, animes e TV ao vivo. O projeto utiliza a API do TMDB para metadados e a SuperflixAPI para reprodução de conteúdo.

Criado por @TheusNattan - Desenvolvedor apaixonado por criar experiências incríveis.

Por que Superflix?

🆓 100% Gratuito - Sem assinaturas, sem cobranças
🚀 Super Rápido - Otimizado com Next.js 16 e Turbopack
📱 Responsivo - Funciona perfeitamente em qualquer dispositivo
🌙 Dark Mode - Interface elegante e confortável
🔒 Open Source - Código aberto para a comunidade

✨ Features

🎬 Conteúdo

Filmes - Catálogo completo com milhares de títulos
Séries - Episódios organizados por temporada
Animes - Seção dedicada para fãs de anime
TV ao Vivo - Canais brasileiros em tempo real

🛠️ Funcionalidades

🔍 Busca Inteligente - Encontre qualquer conteúdo rapidamente
📅 Calendário de Lançamentos - Acompanhe novos episódios
❤️ Favoritos - Salve seus conteúdos preferidos
📊 Histórico - Continue de onde parou
👤 Sistema de Contas - Perfis personalizados
🔐 Painel Admin - Gerencie a plataforma

⚡ Tecnologia

Proxy Inteligente - Bypass de restrições com DNS over HTTPS
HLS Streaming - Reprodução suave e adaptativa
Cache Otimizado - Carregamento ultra-rápido
PWA Ready - Instale como aplicativo

🌐 Demo

Acesse a versão live do Superflix:

👉 superflix.omniwhats.com

🚀 Começando

Pré-requisitos

Node.js 18+ - Download
Git - Download
Conta TMDB - Criar conta (gratuito)

Instalação

# 1. Clone o repositório
git clone https://github.com/TheusN/superflix.git

# 2. Entre na pasta do projeto
cd superflix

# 3. Instale as dependências
npm install

# 4. Configure as variáveis de ambiente
cp .env.example .env.local

Configuração

Edite o arquivo .env.local:

# OBRIGATÓRIO - Pegue sua chave em: https://www.themoviedb.org/settings/api
NEXT_PUBLIC_TMDB_API_KEY=sua_chave_tmdb_aqui

# OPCIONAL - Banco de dados (sem isso, usa memória)
POSTGRES_URL=postgres://usuario:senha@host:5432/database

# OPCIONAL - Segredo para JWT (tem valor padrão para dev)
JWT_SECRET=seu_segredo_super_secreto

⚠️ IMPORTANTE: Nunca compartilhe seu arquivo .env.local ou faça commit dele no Git!

Rodando Localmente

# Modo desenvolvimento (com hot-reload)
npm run dev

# Acesse: http://localhost:3000

Build de Produção

# Gerar build otimizado
npm run build

# Iniciar servidor de produção
npm run start

📁 Estrutura do Projeto

superflix/
├── 📂 public/              # Assets estáticos (imagens, ícones)
├── 📂 src/
│   ├── 📂 app/
│   │   ├── 📂 (auth)/      # Login, Registro
│   │   ├── 📂 (main)/      # Home, Filmes, Séries, TV, etc
│   │   └── 📂 api/         # Rotas da API REST
│   │       ├── 📂 auth/    # Autenticação
│   │       ├── 📂 proxy/   # Sistema de proxy (embed, hls, asset)
│   │       └── 📂 tv/      # Canais de TV
│   ├── 📂 components/      # Componentes React reutilizáveis
│   ├── 📂 context/         # Providers (Auth, Theme, Toast)
│   ├── 📂 lib/             # Utilitários e configurações
│   ├── 📂 services/        # Integrações (TMDB, EmbedTV)
│   └── 📂 types/           # Definições TypeScript
├── 📄 .env.local           # Variáveis de ambiente (criar)
├── 📄 AGENT.md             # Instruções para agentes de IA
├── 📄 next.config.ts       # Configuração Next.js
├── 📄 tailwind.config.ts   # Configuração Tailwind
└── 📄 package.json         # Dependências

🤖 Desenvolvimento com IA (Vibe Coding)

Este projeto é compatível com ferramentas de vibe coding - desenvolvimento assistido por IA como Claude Code, Cursor, GitHub Copilot, etc.

Arquivo AGENT.md

O arquivo AGENT.md contém todas as instruções que os agentes de IA precisam para entender e modificar o código corretamente:

Arquitetura do projeto
Comandos disponíveis
Estrutura de pastas
Convenções de código
Variáveis de ambiente
Fluxo de autenticação
Configuração do banco de dados

Como usar

Claude Code: O arquivo é lido automaticamente
Cursor: Adicione AGENT.md ao contexto ou use @AGENT.md
Copilot Chat: Mencione o arquivo nas conversas
Outros: Copie o conteúdo para o prompt inicial

Dicas para Vibe Coding

# Bons prompts para começar:
"Leia o AGENT.md e me explique a arquitetura do projeto"
"Adicione uma nova página de detalhes para atores"
"Corrija o bug de autenticação no middleware"
"Implemente cache de imagens no componente ContentCard"

Mantenha o AGENT.md atualizado! Quando fizer mudanças significativas na arquitetura, atualize o arquivo para que a IA continue entendendo o projeto.

🤝 Contribuindo

Contribuições são muito bem-vindas! O Superflix é um projeto da comunidade, para a comunidade.

Como Contribuir

Fork o repositório

# Clique em "Fork" no GitHub ou use:
gh repo fork TheusN/superflix

Clone seu fork

git clone https://github.com/SEU_USUARIO/superflix.git
cd superflix

Crie uma branch para sua feature

git checkout -b feature/minha-feature-incrivel

Faça suas alterações

# Desenvolva sua feature...
npm run dev  # Teste localmente
npm run lint # Verifique erros

Commit suas mudanças

git add .
git commit -m "feat: adiciona minha feature incrível"

Push para seu fork

git push origin feature/minha-feature-incrivel

Abra um Pull Request
- Vá para o repositório original
- Clique em "New Pull Request"
- Selecione sua branch
- Descreva suas mudanças

Padrões de Commit

Usamos Conventional Commits:

Tipo	Descrição
`feat:`	Nova feature
`fix:`	Correção de bug
`docs:`	Documentação
`style:`	Formatação (sem mudança de código)
`refactor:`	Refatoração
`test:`	Testes
`chore:`	Tarefas de manutenção

Ideias para Contribuir

🐛 Encontrou um bug? Abra uma issue
💡 Tem uma ideia? Proponha uma feature
📝 Melhorar docs? PRs são bem-vindos!
🌍 Tradução? Ajude a internacionalizar!
🎨 Designer? Proponha melhorias de UI/UX!

🏗️ Arquitetura

Stack Principal

Tecnologia	Versao	Uso
Next.js	16	Framework React com App Router
React	19	Biblioteca de UI
TypeScript	5	Tipagem estatica
Tailwind CSS	4	Estilizacao
PostgreSQL	-	Banco de dados (conexão direta)
JWT	-	Autenticação

APIs Utilizadas

API	Descrição
TMDB	Metadados de filmes/séries (posters, sinopses, etc)
SuperflixAPI	Reprodução de conteúdo via embed
EmbedTV	Canais de TV ao vivo

Sistema de Proxy

O Superflix utiliza um sistema inteligente de proxy para contornar restrições:

Cliente → Next.js API → DNS over HTTPS (Cloudflare) → Conteúdo

Cloudflare DoH - Resolução DNS segura
Interceptors JS - Reescrita de URLs em tempo real
HLS Proxy - Streaming adaptativo

Banco de Dados (PostgreSQL)

O Superflix usa PostgreSQL com conexao direta (sem ORM ou Supabase).

Sem Banco de Dados (Padrao)

Dados armazenados em memoria (perdem ao reiniciar)
Historico e favoritos salvos no localStorage do navegador
Ideal para testes e desenvolvimento local

Com Banco de Dados (Producao)

Dados persistentes no PostgreSQL
Sincronizacao entre dispositivos
Historico de visualizacao (filmes, series, TV)
Favoritos do usuario
Sistema de contas/autenticacao com JWT
Painel administrativo

Configurando o PostgreSQL

Tenha um servidor PostgreSQL disponivel (local, Docker, ou servico como Railway, Render, etc)
Configure o .env.local:

# PostgreSQL - URL de conexao completa
POSTGRES_URL="postgres://usuario:senha@host:5432/database"

# JWT - Segredo para tokens de autenticacao
JWT_SECRET="seu_segredo_super_secreto_minimo_32_caracteres"

Execute o script de setup para criar as tabelas:

npm run db:setup
# ou
node database/setup.js

Veja mais detalhes em database/README.md

Tabelas

Tabela	Descricao
`users`	Usuarios registrados
`watch_history`	Historico de filmes e series
`favorites`	Favoritos de filmes e series
`tv_favorites`	Canais de TV favoritos
`tv_history`	Historico de canais assistidos
`system_settings`	Configuracoes do sistema
`admin_logs`	Logs de acoes administrativas

Seguranca

Variaveis de Ambiente

Variavel	Tipo	Exposicao
`NEXT_PUBLIC_TMDB_API_KEY`	Publica	Exposta no cliente (normal para TMDB)
`JWT_SECRET`	Privada	Nunca exposta - apenas servidor
`POSTGRES_URL`	Privada	Nunca exposta - apenas servidor

Boas Práticas

Nunca faça commit de .env.local - já está no .gitignore
Use JWT_SECRET forte em produção - mínimo 32 caracteres aleatórios
POSTGRES_URL é sensível - contém usuário e senha do banco
Senhas são hasheadas - usando bcrypt com salt

Gerando JWT_SECRET Seguro

# Linux/Mac
openssl rand -base64 32

# Node.js
node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"

O que NÃO é exposto

✅ Credenciais do banco de dados (POSTGRES_URL)
✅ Segredo JWT (JWT_SECRET)
✅ Senhas dos usuários (hasheadas com bcrypt)
✅ Tokens de autenticação (HttpOnly cookies)

O que É exposto (e é seguro)

⚠️ NEXT_PUBLIC_TMDB_API_KEY - API pública do TMDB (por design)

A chave do TMDB é pública por design - ela só permite leitura de metadados públicos de filmes/séries.

🚀 Deploy

Vercel (Recomendado)

Clique no botão acima
Configure as variáveis de ambiente
Deploy!

Variaveis na Vercel

Variavel	Obrigatorio	Descricao
`NEXT_PUBLIC_TMDB_API_KEY`	Sim	Chave da API TMDB
`POSTGRES_URL`	Sim	URL de conexao PostgreSQL
`JWT_SECRET`	Sim	Segredo para tokens JWT (min. 32 caracteres)

Outras Plataformas

O Superflix funciona em qualquer plataforma que suporte Next.js:

Railway
Render
DigitalOcean
AWS Amplify
Docker

Scripts Disponiveis

npm run dev      # Servidor de desenvolvimento
npm run build    # Build de producao
npm run start    # Iniciar producao
npm run lint     # Verificar codigo
npm run db:setup # Configurar banco de dados

🙏 Agradecimentos

TMDB - Pela incrível API de metadados
Next.js - Framework extraordinário
Vercel - Hospedagem e infraestrutura
Comunidade Open Source - Por todo o suporte

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

📬 Contato

TheusNattan - Criador do Superflix

GitHub: @TheusN

⭐ Se você gostou do projeto, deixe uma estrela!

Feito com ❤️ por TheusNattan e contribuidores

Name		Name	Last commit message	Last commit date
Latest commit History 28 Commits
database		database
public		public
src		src
.env.example		.env.example
.gitignore		.gitignore
AGENT.md		AGENT.md
LICENSE		LICENSE
README.md		README.md
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json
vercel.json		vercel.json

Folders and files

Latest commit

History

Repository files navigation

🎬 Superflix

🎯 Sobre o Projeto

Por que Superflix?

✨ Features

🎬 Conteúdo

🛠️ Funcionalidades

⚡ Tecnologia

🌐 Demo

👉 superflix.omniwhats.com

🚀 Começando

Pré-requisitos

Instalação

Configuração

Rodando Localmente

Build de Produção

📁 Estrutura do Projeto

🤖 Desenvolvimento com IA (Vibe Coding)

Arquivo AGENT.md

Como usar

Dicas para Vibe Coding

🤝 Contribuindo

Como Contribuir

Padrões de Commit

Ideias para Contribuir

🏗️ Arquitetura

Stack Principal

APIs Utilizadas

Sistema de Proxy

Banco de Dados (PostgreSQL)

Sem Banco de Dados (Padrao)

Com Banco de Dados (Producao)

Configurando o PostgreSQL

Tabelas

Seguranca

Variaveis de Ambiente

Boas Práticas

Gerando JWT_SECRET Seguro

O que NÃO é exposto

O que É exposto (e é seguro)

🚀 Deploy

Vercel (Recomendado)

Variaveis na Vercel

Outras Plataformas

Scripts Disponiveis

🙏 Agradecimentos

📄 Licença

📬 Contato

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages