Documentação Técnica Oficial

Documentação Webyte Hub

Guia completo de instalação, configuração e deploy para qualquer ambiente.

Changelog

v1.2.0
2026-01-11Novidade

Jogos Interativos

  • Adicionado jogo Webyte Explorer com sistema de conexões
  • Adicionado Dev Quiz para desenvolvedores (digite 'DEV')
  • Sistema de palpites para jogadores com dificuldade
  • Tela de parabéns com redirecionamento para HUB
  • Botões de acesso direto aos jogos no mobile
v1.1.0
2026-01-10Melhoria

Otimização de Performance

  • Partículas desabilitadas no mobile para melhor desempenho
  • Animações simplificadas em dispositivos móveis
  • Redução de blur effects e glow no mobile
  • Componentes do HUB otimizados (Timeline, Ecosystem Map)
  • Lazy loading implementado em componentes pesados
v1.0.5
2026-01-09Correção

Correções de Navegação

  • Corrigido scroll suave para links âncora
  • Corrigido link 'Início' no rodapé
  • Melhorado comportamento do header no scroll
  • Corrigido erro de build com Resend API
v1.0.0
2026-01-08Novidade

Lançamento Inicial

  • Landing page completa com countdown
  • Página HUB com ecossistema de empresas
  • Timeline interativa das empresas
  • Mapa do ecossistema com conexões
  • Formulário de contato funcional
  • Newsletter com Resend
  • Documentação técnica completa

Requisitos do Sistema

Desenvolvimento Local

  • Node.js 18.17 ou superior
  • npm, pnpm ou yarn
  • Git 2.0+
  • VS Code (recomendado)

Servidor VPS

  • Ubuntu 20.04+ ou Debian 11+
  • 1GB RAM (2GB recomendado)
  • Nginx 1.18+
  • Domínio configurado (DNS)

Instalação Local

1. Clonar o Repositório

git clone https://github.com/juniorwebyte/webyte-hub.git
cd webyte-hub

2. Instalar Dependências

Com npm:

npm install

Com pnpm (recomendado):

pnpm install

3. Configurar Variáveis de Ambiente

cp .env.example .env.local
nano .env.local

4. Executar o Projeto

Modo desenvolvimento:

npm run dev

Acesse: http://localhost:3000

Build de produção:

npm run build
npm run start

Variáveis de Ambiente

Crie um arquivo .env.local na raiz do projeto:

.env.local
# EMAIL (RESEND)
RESEND_API_KEY=re_xxxxxxxxxxxxxxxxxxxxxxxxx
RESEND_FROM_EMAIL=onboarding@resend.dev
CONTACT_EMAIL=seu@email.com

# SITE
NEXT_PUBLIC_SITE_URL=https://seudominio.com

# ANALYTICS (OPCIONAL)
NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX

Importante: Nunca commite o arquivo .env.local no Git.

Deploy em VPS

1Preparar o Servidor

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git build-essential

2Instalar Node.js 20

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
node --version

3Instalar PM2

sudo npm install -g pm2
pm2 --version

4Clonar e Configurar

mkdir -p ~/apps && cd ~/apps
git clone https://github.com/juniorwebyte/webyte-hub.git
cd webyte-hub
npm install
nano .env.local

5Build e Iniciar

npm run build
pm2 start npm --name "webyte-hub" -- start
pm2 save
pm2 startup

Configuração do Nginx

1. Instalar Nginx

sudo apt install -y nginx

2. Criar Configuração

sudo nano /etc/nginx/sites-available/seusite.com

Cole a configuração:

nginx.conf
server {
    listen 80;
    server_name seusite.com www.seusite.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

3. Ativar o Site

sudo ln -s /etc/nginx/sites-available/seusite.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

SSL/HTTPS

Certbot

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d seusite.com -d www.seusite.com
sudo certbot renew --dry-run

O Certbot renova automaticamente a cada 90 dias.

PM2 - Comandos Úteis

pm2 status          # Ver status
pm2 logs webyte-hub # Ver logs
pm2 restart webyte-hub
pm2 stop webyte-hub
pm2 monit           # Monitoramento

Deploy com Docker

Dockerfile

Dockerfile
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:20-alpine AS runner
WORKDIR /app
ENV NODE_ENV=production
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
COPY --from=builder /app/public ./public
EXPOSE 3000
CMD ["node", "server.js"]

Comandos

docker build -t webyte-hub .
docker run -d -p 3000:3000 --name webyte-hub webyte-hub
docker logs -f webyte-hub

Nossos Serviços

Oferecemos uma gama completa de serviços para atender todas as suas necessidades digitais.

Desenvolvimento Web

Criamos sites e aplicações web modernas utilizando as tecnologias mais avançadas do mercado.

  • React & Next.js
  • TypeScript
  • APIs RESTful
  • Integração com bancos de dados

Aplicativos Mobile

Desenvolvemos aplicativos nativos e híbridos para iOS e Android.

  • React Native
  • Flutter
  • Apps nativos
  • PWA (Progressive Web Apps)

UI/UX Design

Design centrado no usuário para criar experiências digitais memoráveis.

  • Prototipagem
  • Design System
  • Testes de usabilidade
  • Acessibilidade

Infraestrutura & DevOps

Soluções de infraestrutura escaláveis e automatizadas.

  • Cloud (AWS, GCP, Azure)
  • CI/CD
  • Docker & Kubernetes
  • Monitoramento

SEO & Performance

Otimização para mecanismos de busca e performance web.

  • Core Web Vitals
  • SEO técnico
  • Análise de dados
  • Otimização de conversão

Segurança Digital

Protegemos seus sistemas e dados contra ameaças cibernéticas.

  • Auditorias de segurança
  • LGPD compliance
  • SSL/TLS
  • Backup & Recovery

Tecnologias

Next.js 16(Frontend)
React 19(Frontend)
TypeScript(Linguagem)
Tailwind CSS v4(Estilização)
Node.js(Backend)
PostgreSQL(Banco de Dados)
Prisma(ORM)
Vercel(Deploy)
AWS(Cloud)
Docker(DevOps)

Precisa de ajuda?

Entre em contato pelo WhatsApp.

Built with v0