Pesquisando a documentação do React Router
Estamos com o navegador aberto, na aba de endereços com o google.com digitado. Vamos procurar pela documentação do React Router para entender como iniciar um novo projeto e explorar outros modos, já que utilizaremos a documentação para compreender a portabilidade do nosso projeto.
No Google, clicamos na barra de pesquisas e digitamos "React Router", pressionando "Enter". O primeiro resultado é o site reactrouter.com. Ao clicar, acessamos a documentação do React Router, que, diferentemente de outras documentações como a do React, não possui tradução em andamento. No entanto, é fácil se orientar no site, mesmo sem conhecimento em inglês. Se estivermos usando o Google Chrome, podemos clicar com o botão direito na página e selecionar a opção "Traduzir para o português". Embora a tradução seja literal, ela oferece uma orientação útil para quem não domina o inglês.
Explorando a documentação do React Router
Na página inicial do React Router, clicamos na aba "Documentos". Com a página traduzida, vemos o início do guia do React Router, que explica como começar, os modos disponíveis (declarativo, de dados e estrutura). O modo estrutura é o modo framework, enquanto o modo de dados é baseado em dados para navegação. O modo declarativo, mais conhecido, é o browser router, utilizado em projetos React sem frameworks para roteamento.
Na aba lateral esquerda, ao clicar em "Instalação", encontramos os guias de instalação. Para iniciar um projeto, basta digitar npx create-react-router@latest, utilizando a versão mais recente, que é a 7.9.4. Versões anteriores, como 6.30.1, 4, 5 e 3, também estão disponíveis, mas funcionam de maneira diferente. Ao clicar, por exemplo, na versão 5, somos redirecionados para a documentação antiga do React Router, focada no modo de navegação declarativa, a forma padrão conhecida.
Utilizando templates do Remix e React Router
Utilizando a versão mais nova, temos o conteúdo atualizado de Remix e React Router. Descendo um pouco na tela, após o título de introdução, encontramos dois links que redirecionam para o GitHub, onde há um demo de uma aplicação Remix e modelos prontos para implantação. Clicamos no segundo link para mostrar algo importante que o Remix oferece, essencial para nosso progresso. O Remix está ganhando popularidade em relação ao Next. Se preferir, pode compartilhar sua preferência entre Team Remix ou Team Next em nosso grupo no Discord ou comunidades.
No GitHub, na página do React Router Templates do Remix Run, vemos os templates disponíveis. O template original, que utilizaremos, já vem com server-side rendering configurado, TypeScript, Tailwind CSS e suporte a Docker. Isso significa que ele é completo e não precisamos de ferramentas externas, exceto para configuração do servidor, que estará fora do repositório. O template oficial do React Router v7/Remix é tão completo que não precisamos de mais nada.
Explorando opções de templates e funcionalidades
Além disso, há um template mínimo, com apenas o essencial para o funcionamento, e o restante do React Router precisará ser instalado por partes. Para quem prefere JavaScript, há essa opção, embora atualmente trabalhemos apenas com TypeScript. Existem também dois modos com servidor Node pronto para implementação: um com Node configurado, permitindo acesso a middlewares e configuração do back-end, e outro com Node e PostgreSQL instalados e configurados, oferecendo suporte a banco de dados SQL com PostgreSQL, tudo dentro do Remix, sem necessidade de recursos externos.
No repositório do GitHub, temos guias de deploy para Cloudflare, Netlify e Vercel, que são amplamente utilizados, principalmente de forma gratuita, para fazer deploys de aplicações. Além disso, há templates da comunidade, mas não entraremos em detalhes sobre eles. Destacamos a utilização do ShadCN com o Vite, que é muito interessante, pois o ShadCN é uma biblioteca que apreciamos utilizar em projetos, especialmente em trabalhos freelance. O ShadCN é uma excelente biblioteca para incluir nos projetos. Também há suporte ao Zustand e outras funcionalidades, tornando este um template muito interessante da comunidade. Já realizamos alguns testes com ele, utilizando o deploy do ShadCN junto com o Vite para fazer o build e todo o suporte do React Router 7. É um ótimo template para utilizar, e vamos até deixar uma estrela no repositório do React Router Templates.
Criando e configurando o projeto React Air Max
No guia de instalação, já temos o comando npx create-react-router-latest-my-react-router-app. Vamos apenas alterar o final do nome do projeto para rmx. Copiaremos o comando e, no editor de texto, com a aba do projeto aberta, criaremos o projeto com o rmx. Analisando a base de código, temos o React Air Max, a pasta database com um servidor JSON para retornar modelos de carros, fotos e especificações. No React Air Max, a estrutura funcional do projeto utiliza Vite, React puro, TypeScript e Tailwind. Na pasta assets, estão os recursos do projeto, e na pasta public, algumas imagens para facilitar o carregamento do lado do servidor, além do favicon.
Na pasta src, temos componentes como banner, breadcrumbs para navegação, card para visualização de detalhes de carro, e skeletons separados dos componentes para facilitar alterações. Há também um card de categorias, um skeleton do card de categorias, um error boundary simples e padrão, com poucas alterações para adequá-lo ao projeto. O restante do funcionamento é um error boundary padrão do React. Temos também um header e um campo de busca. Além disso, há um index.ts para exportação dos componentes, e utilizamos o React context para ter um contexto de carros e categorias no projeto, algo que não teremos da mesma forma no projeto Remix.
Executando e testando o projeto
As páginas incluem a página inicial, a página de detalhes, a página de veículo, a página de categorias, a página de detalhes de uma categoria e a página de retorno dos dados de busca. No terminal, rodaremos npm run server na raiz do projeto. Se a porta 3001 já estiver em uso, provavelmente o servidor já está rodando. No terminal, acessaremos cd react-rmax e digitaremos npm run dev, que abrirá na porta 5173. Clicando na porta 5173, o servidor já estará rodando, permitindo visualizar os carros e seus detalhes, juntamente com as especificações retornadas pelo servidor JSON. A página de categorias também está funcional, mostrando as categorias e redirecionando para a busca de carros dentro das categorias, com informações como valor da diária, aluguel de veículo e quantidade de veículos disponíveis.
O site está totalmente funcional. Nosso desafio é melhorar a experiência do usuário ao acessar o site, especialmente em relação à performance. Algumas reclamações indicam que, com uma internet ruim, o site pode demorar para carregar informações, especialmente imagens e pré-carregamentos. O objetivo é trabalhar na performance da aplicação. Vamos rodar o Google Lighthouse para medir as métricas de performance do site. Na aba do desenvolvedor, com o Lighthouse instalado, faremos uma análise rápida da página para identificar pontos de melhoria que podem não ser observados na primeira navegação.
Analisando a performance e SEO com Google Lighthouse
O Lighthouse indicou uma performance de 64 e um SEO de 83. O SEO de 83 não é ruim, mas pode melhorar, especialmente para uma locadora de veículos, onde a otimização para motores de busca é crucial. O cliente deseja que a aplicação se destaque nos motores de busca. Entendemos a estrutura do projeto e suas particularidades no Vite. Temos uma pasta de services com api.ts para busca no servidor JSON e uma pasta types com index.ts para tipagens do projeto, como category e car.
Para iniciar a estrutura com Vite, Remix e React Router v7, pararemos a execução, voltaremos uma pasta e colaremos o comando copiado para criar o site. O comando npx create-react-router-latest será utilizado para o projeto Remix Air Max. Utilizaremos Remix, pois é a forma comum de se referir ao React Router v7. Houve questionamentos na comunidade sobre a união dos times do Remix e React Router, mas o nome React Router v7 prevaleceu, o que pode confundir. Chamaremos o projeto de Remix Air Max para deixar claro que estamos utilizando Remix na versão 3, que é o React Router v7.
Configurando o projeto Vite e React Router
Durante a instalação, surgiram duas perguntas: se queremos iniciar um repositório do Git e se queremos instalar as dependências com NPM. Optamos por não inicializar o Git, pois já estamos em um repositório, e sim instalar as dependências com NPM, apesar de utilizarmos o PNPM em outros projetos. Enquanto as dependências são instaladas, nos encontraremos na sequência para ver a estrutura criada e fazer o nosso Hello World em tela, pois é importante mostrar que o projeto iniciou. Vamos juntos na sequência.
Agora, vamos começar a configurar nosso projeto. Primeiro, precisamos criar um novo projeto Vite. Para isso, utilizamos o seguinte comando:
Após criar o projeto Vite, o próximo passo é instalar o React Router, que será utilizado para gerenciar as rotas da nossa aplicação. Para isso, executamos o comando:
Inicializando a aplicação React com BrowserRouter
Com o React Router instalado, podemos configurar o ponto de entrada da nossa aplicação. Vamos importar os módulos necessários e configurar o BrowserRouter para gerenciar as rotas. Aqui está o código inicial:
import React from "react";
import ReactDOM from "react-dom/client";
import { BrowserRouter } from "react-router-dom";
import App from "./App";
const root = document.getElementById("root");
ReactDOM.createRoot(root).render(
<BrowserRouter>
<App />
</BrowserRouter>
);
Esse código inicializa a aplicação React e envolve o componente App com o BrowserRouter, permitindo que o React Router gerencie as rotas.
Adicionando rotas específicas à aplicação
Para adicionar mais funcionalidades, como rotas específicas, podemos expandir o código para incluir Routes e Route. Veja como fazemos isso:
import React from "react";
import ReactDOM from "react-dom/client";
import { BrowserRouter, Routes, Route } from "react-router-dom";
import App from "./App";
const root = document.getElementById("root");
ReactDOM.createRoot(root).render(
<BrowserRouter>
<Routes>
<Route path="/" element={<App />} />
</Routes>
</BrowserRouter>
);
Com essa configuração, definimos uma rota padrão que renderiza o componente App quando o caminho da URL é /. Isso nos dá uma base sólida para começar a adicionar mais rotas e funcionalidades à nossa aplicação React.