Skip to content

DEPLOYMENT.md

Latest commit

 

History

History
61 lines (40 loc) · 2.59 KB

DEPLOYMENT.md

File metadata and controls

61 lines (40 loc) · 2.59 KB
Raw

🚀 Guia de Hospedagem & Deploy Gratuito

Aprenda como hospedar sua própria instância do GlassHub Quasar 100% grátis em menos de 2 minutos.

🏆 Por que a Vercel é a Melhor Escolha?

Para microsserviços que geram imagens SVG dinâmicas para o GitHub, a Vercel é a melhor opção do mercado pelos seguintes motivos:

  1. Criadora do Next.js: Suporte nativo e otimizado a Next.js 14 App Router.
  2. Sem Hibernação (Zero Cold Starts): Servidores em nuvem como Render ou Railway colocam a aplicação em modo de espera (sleep mode) quando inativos. A Vercel responde instantaneamente de qualquer lugar do mundo através de sua rede CDN Edge.
  3. Plano 100% Gratuito (Hobby Tier): Sem limite de tempo, com SSL (HTTPS) automático e deploys contínuos a cada git push.

📦 Deploy em 1 Clique na Vercel

Clique no botão abaixo para clonar e fazer deploy da sua própria instância imediatamente:

Deploy with Vercel

🛠️ Passo a Passo de Deploy Manual

Passo 1: Envie seu repositório para o GitHub

Se você editou ou personalizou o projeto, suba as alterações para o seu repositório pessoal no GitHub:

git add .
git commit -m "feat: customize GlassHub Quasar"
git push origin main

Passo 2: Conecte a Vercel

  1. Acesse vercel.com e faça login com sua conta do GitHub.
  2. No painel inicial, clique em Add New... → Project.
  3. Selecione o repositório GlassHubQuasar e clique em Import.

Passo 3: Configurar Variáveis de Ambiente (Opcional, porém Recomendado)

Para aumentar o limite de requisições da API do GitHub de 60 requisições/hora para 5.000 requisições/hora, adicione seu token pessoal:

  1. Acesse GitHub Personal Access Tokens.
  2. Gere um token clássico com permissão read:user ou public_repo.
  3. Na Vercel, abra a seção Environment Variables e adicione:
    • Name: GITHUB_TOKEN
    • Value: ghp_SeuTokenAqui

Passo 4: Concluir Deploy

Clique em Deploy. Em cerca de 45 segundos, seu link oficial estará no ar (ex: https://glasshub-quasar.vercel.app).

🌐 Opções Alternativas de Hospedagem

Cloudflare Pages / Workers

O projeto pode ser implantado no Cloudflare Pages usando a biblioteca @cloudflare/next-on-pages. A rede Edge da Cloudflare possui excelente desempenho global.

Netlify

Plataforma com plano gratuito de alta performance que suporta aplicações Next.js de forma transparente.