Plataforma privada de downloads, geração de imagens, stickers e transcrição de áudio.
Important
Projeto privado e confidencial da TheKingDevs. O acesso é restrito a pessoas autorizadas. É proibida a clonagem, cópia, distribuição, publicação ou qualquer uso não autorizado deste projeto. Consulte o arquivo LICENSE.
A Orbit API é um monorepo com duas aplicações independentes:
- Frontend em Next.js, hospedado na Vercel.
- Backend em Bun, hospedado no Render.
O frontend encaminha /api, /storage, /preview/ttp e os assets necessários para o backend por meio de rewrites do Next.js. Como os hosts são separados, o deploy e a disponibilidade de cada aplicação são independentes.
- Downloads de Instagram, TikTok (vídeo, áudio e imagens/slides), Pinterest (URL ou pesquisa), YouTube, Facebook, SoundCloud, Spotify, Threads, Google Drive, CapCut e Twitter/X.
- Inteligência artificial com GPT, Groq, Gemini, OCR local de imagens, resumo de texto e resumo de áudio com transcrição Whisper.
- Pesquisas de YouTube (
v1ev2) e wallpapers. - Geração de cards e imagens com Canvas (
welcome,goodbye,ttp,attpe efeitos). - Criação de stickers (
ttp,attp,brat,abrat) e conversão para GIF. - Transcrição de áudio e vídeo com Whisper via
sherpa-onnx. - Autenticação com Google OAuth, sessões e cookies.
- API keys com níveis público, admin e owner.
- Controle de uso, saldo e planos de usuário.
- Painel com documentação, novidades, chaves e métricas de uso.
flowchart TB
USER([Usuário]) --> FE
subgraph VERCEL["Vercel"]
FE["Frontend Next.js<br/>frontend/"]
RW["Rewrites<br/>/api · /storage · /preview/ttp"]
FE --> RW
end
subgraph RENDER["Render"]
BE["Backend Bun<br/>backend/"]
AUTH["Google OAuth<br/>sessões e cookies"]
DL["Downloads e IA<br/>devworldbr-sdk + btch-downloader"]
ART["Canvas e stickers<br/>@napi-rs/canvas + ffmpeg"]
TR["Transcrição<br/>sherpa-onnx Whisper"]
ST[("Storage<br/>backend/storage")]
BE --> AUTH
BE --> DL
BE --> ART
BE --> TR
BE --> ST
end
RW -->|HTTPS| BE
DL --> EXT["Plataformas externas"]
TR --> HF["Modelos Whisper<br/>Hugging Face"]
Diagramas adicionais:
| Camada | Tecnologias |
|---|---|
| Frontend | Next.js 16, React 19, Tailwind CSS 4, TypeScript |
| Backend | Bun, TypeScript, @napi-rs/canvas, ffmpeg, SDK DevWorld, sherpa-onnx, jose, zod |
| Infraestrutura | GitHub, Render, Vercel |
| Integrações | Google OAuth, Hugging Face, btch-downloader |
- 📁
backend➔ API REST Bun; estrutura detalhada embackend/README.md- 📁
src/routes➔ endpoints públicos, API, administração e owner - 📁
src/services➔ downloads, IA, sessões, MongoDB, storage, canvas e transcrição - 📁
assets/fonts➔ fontes para geração de mídia - 📁
models/whisper-tiny➔ arquivos do modelo local de transcrição - 📁
storage➔ mídias temporárias de execução - 📝
Dockerfileerender.yaml➔ imagem e configuração de deploy do backend
- 📁
- 📁
frontend➔ aplicação Next.js; estrutura detalhada emfrontend/README.md- 📁
src/app➔ landing page, dashboard, docs, planos e administração - 📁
src/components➔ interface, playgrounds e componentes de página - 📁
src/lib➔ autenticação, HTTP, catálogo de endpoints, SEO e novidades - 📁
public➔ logos e assets públicos
- 📁
- 📁
assets➔ identidade visual e documentação visual- 📁
images➔ logos e imagens - 📁
diagrams➔ arquitetura, deploy e fluxo de contribuição
- 📁
- 📁
scripts➔ scripts de build e deploy - 📝
Makefile➔ atalhos de desenvolvimento e produção - 📝
CONTRIBUTING.md➔ guia resumido de contribuição - 📝
COMO_COLABORAR.md➔ boas práticas, commits e fluxo de CI/CD - 📝
LICENSE➔ termos da licença - 📝
README.md➔ visão geral do monorepo
- Bun instalado (backend).
- Node.js 20.9 ou superior e npm (frontend).
ffmpegdisponível noPATHpara processamento local de mídia.- Git.
- Docker é opcional; o backend possui
backend/Dockerfile.
Crie os arquivos de ambiente a partir dos exemplos:
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.envPreencha os valores locais. Nunca versione arquivos .env.
| Variável | Descrição |
|---|---|
PORT |
Porta do servidor (padrão: 3000). |
BACKEND_URL |
URL pública/interna do backend. |
FRONTEND_URL |
URL do frontend usada nos redirecionamentos OAuth. |
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET |
Credenciais do Google OAuth. |
GOOGLE_REDIRECT_URI |
Callback OAuth encaminhado pelo proxy do frontend. |
SESSION_TTL_HOURS / SESSION_IDLE_MINUTES / SESSION_ROTATE_HOURS |
Política de sessão. |
COOKIE_SECURE |
Use true em produção com HTTPS. |
OWNER_API_KEY / ADMIN_API_KEY / PUBLIC_API_KEY |
Chaves de acesso da API. |
OWNER_EMAIL |
E-mail reservado ao papel owner; configure no ambiente, sem codificá-lo no projeto. |
CORS_ORIGIN |
Origens adicionais HTTP(S) para CORS, separadas por vírgula. FRONTEND_URL e BACKEND_URL também são permitidas automaticamente. |
PUBLIC_BASE_URL |
URL pública usada na geração de links (produção). |
DOCS_PREVIEW_DAILY_LIMIT |
Limite diário de pré-visualizações da documentação. |
MONGO_URI |
Connection string do MongoDB. Obrigatória em produção. |
MONGO_DB_NAME |
Nome do banco de dados MongoDB (padrão: orbit). |
MERCADO_PAGO_ACCESS_TOKEN |
Access token usado para criar e consultar pedidos da Orders API. |
MERCADO_PAGO_WEBHOOK_SECRET |
Segredo de assinatura do webhook de pedidos; configure a URL /api/webhooks/mercado-pago no painel do Mercado Pago. |
DATA_ENCRYPTION_KEY |
Chave Base64 de 32 bytes para criptografia e hashes; gere com openssl rand -base64 32 e não altere sem migração. |
AIHORDE_API_KEY |
Chave opcional para geração de imagens via AI Horde. |
| Variável | Descrição |
|---|---|
BACKEND_URL |
URL do backend usada pelos rewrites do Next.js. |
NEXT_PUBLIC_APP_NAME |
Nome exibido na interface. |
NEXT_PUBLIC_SITE_URL |
URL pública do site usada em SEO, Open Graph, sitemap e robots. |
NEXT_PUBLIC_API_URL |
URL pública da API nos exemplos de código. |
NEXT_PUBLIC_WHATSAPP_CHANNEL_URL |
URL do canal de atualizações. |
NEXT_PUBLIC_WHATSAPP_SUPPORT_URL |
URL de convite para o grupo de suporte. |
# backend
cd backend
bun install --frozen-lockfile
# frontend
cd ../frontend
npm installNa raiz do projeto:
make run-devOu em terminais separados:
# backend — http://localhost:3000
cd backend
bun run dev
# frontend — http://localhost:3001
cd frontend
npm run devAcesse http://localhost:3001.
make runO comando compila o backend e o frontend e inicia os dois em modo de produção.
| Comando | Descrição |
|---|---|
make run-dev |
Inicia backend e frontend em desenvolvimento. |
make run |
Compila e inicia backend e frontend em produção. |
make clean |
Remove dist, .next e node_modules. |
make clean-cache |
Limpa caches de build. |
./scripts/build-backend.sh |
Instala dependências e compila somente o backend. |
./scripts/deploy.sh |
Abre a CLI interativa para build e publicação no Render e na Vercel. |
cd backend && bun test |
Executa os testes do backend. |
cd frontend && npm run lint |
Executa o lint do frontend. |
# testes do backend
cd backend
bun test
# lint do frontend
cd frontend
npm run lint
# build de verificação
cd frontend
npm run buildA ferramenta em scripts/deploy.ts oferece menus, confirmações e mensagens de progresso para publicar frontend, backend ou ambos. Ela executa os CLIs oficiais e deixa os binários locais ignorados pelo Git:
cd scripts && npm install
./deploy.shO banner FIGlet é centralizado no terminal, e a CLI apresenta as etapas do fluxo com barra de progresso e atividade atual. O pacote vercel fica instalado localmente em scripts/node_modules/.bin. Para instalar o binário oficial do Render dentro de scripts/.tools/bin (Linux/macOS x64 e ARM64; requer curl e unzip), use cd scripts && npm run install-render. A ferramenta também reconhece um render já disponível no PATH.
Para localizar o serviço Render, a CLI lista os serviços do workspace autenticado e compara seus nomes com o name em backend/render.yaml (por padrão, orbit-backend). Se o nome não corresponder, mas houver apenas um serviço web acessível, usa esse serviço; com vários, permite escolher. RENDER_SERVICE_ID define um ID explícito e RENDER_SERVICE_NAME troca o nome usado na busca. IDs manuais são comparados com a lista acessível pela API key antes dos builds. Se o Render não responder por erro de rede/DNS, a CLI interrompe antes dos builds. Se a resposta de deploy indicar que o repositório GitHub conectado não foi encontrado, a CLI informa o ID do repositório e orienta a reconectar a integração no painel Render; esse caso não usa fallback para evitar mascarar o diagnóstico. Outros erros 404 de deploy ainda tentam o Render CLI como alternativa.
O frontend usa o projeto já vinculado em frontend/.vercel/project.json; se não houver vínculo local, o CLI da Vercel permite selecionar um projeto pela conta autenticada. Para aguardar a conclusão do deploy do Render, informe ou configure RENDER_SERVICE_ID; sem ID, a CLI do Render permite escolher o serviço e retorna assim que aceita o deploy. Os dois provedores precisam estar autenticados. Confirme cada publicação de produção quando solicitado.
O código e os metadados oficiais dos comandos estão em Render CLI e Vercel CLI.
- Runtime: Docker.
- Blueprint:
backend/render.yaml. - Dockerfile:
backend/Dockerfile(contextobackend). - A imagem instala
ffmpeg, fontes e os modelos Whisper usados pela transcrição; os downloads de mídia usam o SDK DevWorld. - Configure as variáveis de ambiente no painel do Render, principalmente
PUBLIC_BASE_URL,CORS_ORIGIN,FRONTEND_URL,BACKEND_URL,MONGO_URI,DATA_ENCRYPTION_KEYe as credenciais OAuth. - Usuários, sessões e histórico de uso ficam persistidos no MongoDB configurado por
MONGO_URI. - O build filter usa
backend/**, evitando redeploys causados por mudanças no frontend. - Se configurar manualmente pelo painel, use Dockerfile Path
backend/Dockerfilee Docker Contextbackend.
- Root Directory:
frontend. - Build Command:
npm run build. - Configure
BACKEND_URLapontando para o backend no Render. - Configure as variáveis
NEXT_PUBLIC_*no painel da Vercel. - Opcionalmente, use o Ignored Build Step para ignorar commits que não alteram o frontend:
git diff HEAD^ HEAD --quiet -- .Os rewrites de /api, /storage, /preview/ttp e /assets/html-to-image.js estão definidos em frontend/next.config.ts.
- Repositório privado, de propriedade exclusiva da TheKingDevs.
- Acesso permitido apenas a membros autorizados.
- Não commite
.env, tokens, chaves ou credenciais. - Use as variáveis de ambiente de cada host para segredos.
- Em caso de exposição acidental, revogue e rotacione as chaves imediatamente.
- É proibida a clonagem, cópia, distribuição ou uso não autorizado do projeto.
- Recomenda-se proteger
maincom Pull Request obrigatório, aprovação de code owner e checks de CI.
O fluxo resumido está em CONTRIBUTING.md. As boas práticas, o padrão de commits e o guia de CI/CD estão em COMO_COLABORAR.md.
Este projeto é proprietário e confidencial. Todos os direitos pertencem à TheKingDevs. Consulte LICENSE para os termos completos.
