Publicando uma aplicação react no github pages

Você pode hospedar uma aplicação ReactJS no GitHub Pages e acessá-la diretamente pelo navegador. O processo é bastante simples, mas requer alguns ajustes específicos devido à natureza das aplicações ReactJS. Abaixo está o passo a passo para hospedar sua aplicação ReactJS no GitHub Pages:

1. Configurar o Repositório no GitHub

Se ainda não tiver um repositório GitHub para sua aplicação ReactJS, crie um novo repositório ou utilize um repositório existente.

2. Instalar o Pacote gh-pages

O GitHub Pages requer que o código estático seja publicado na pasta gh-pages do repositório. Para facilitar esse processo, vamos usar o pacote gh-pages. Primeiro, instale-o na sua aplicação ReactJS:

npm install --save gh-pages

3. Configurar o package.json

Agora, configure seu arquivo package.json para preparar a aplicação para ser publicada no GitHub Pages. Você precisará adicionar algumas linhas de configuração.

  1. Adicionar a URL da Homepage: Adicione uma chave homepage no arquivo package.json com a URL onde seu site será hospedado:
   "homepage": "https://<username>.github.io/<reponame>"

Substitua <username> pelo seu nome de usuário GitHub e <reponame> pelo nome do repositório.

  1. Adicionar Scripts de Deploy: Adicione os seguintes scripts na seção scripts do seu package.json:
   "scripts": {
     "predeploy": "npm run build",
     "deploy": "gh-pages -d build"
   }

Esses scripts garantem que, sempre que você rodar npm run deploy, a aplicação será construída e enviada para o branch gh-pages.

4. Fazer o Build da Aplicação

Antes de publicar, você precisa garantir que sua aplicação ReactJS esteja pronta para produção. Para isso, execute o comando de build:

npm run build

Isso irá criar uma versão otimizada da sua aplicação na pasta build.

5. Publicar no GitHub Pages

Agora, você pode publicar sua aplicação no GitHub Pages com o comando:

npm run deploy

Esse comando faz o build da sua aplicação (usando o script predeploy) e, em seguida, envia os arquivos para o branch gh-pages do seu repositório GitHub.

6. Acessar Sua Aplicação

Após a publicação, sua aplicação ReactJS estará disponível no GitHub Pages. O endereço será algo como:

https://<username>.github.io/<reponame>/

Por exemplo, se seu nome de usuário GitHub for usuario e o nome do repositório for meu-react-app, o link será:

https://usuario.github.io/meu-react-app/

7. Considerações Adicionais

  • Roteamento no ReactJS: Se sua aplicação ReactJS usa roteamento (por exemplo, com react-router), você pode encontrar problemas de navegação diretamente para URLs internas. Para resolver isso, adicione uma página 404 personalizada ou use o HashRouter em vez do BrowserRouter do react-router.
  • Atualizações: Sempre que você fizer mudanças na aplicação e quiser atualizá-la no GitHub Pages, basta rodar o comando npm run deploy novamente. Isso irá sobrescrever os arquivos no branch gh-pages e atualizar o site.

Conclusão

Agora você pode acessar e compartilhar sua aplicação ReactJS hospedada no GitHub Pages. Esse método é ideal para projetos pessoais, demonstrações e pequenos sites de aplicações estáticas.

category:

Blog

Tags:

No responses yet

Leave a Reply

Your email address will not be published. Required fields are marked *