TL;DR
- Primeiro, instale o Node.js na versão 20.9 ou superior.
- Em seguida, abra a pasta do projeto no VS Code.
- Depois, rode um único comando para criar o projeto.
- Por fim, inicie o servidor local e abra o navegador.
- Assim, você confirma a instalação em poucos minutos.
O Next.js, framework de React (biblioteca JavaScript para criar interfaces), está presente em 4,1% de todos os sites, segundo o W3Techs.
Além disso, a participação dele na web quase dobrou em um ano. Por isso, saber como instalar o Next.js é o primeiro passo para criar sites e aplicações com essa tecnologia. O processo leva poucos minutos.
Hoje, explicamos como instalar o Next.js no Windows e no macOS, usando o Visual Studio Code (VS Code) como editor.
O que você encontrará no conteúdo:
- Por que usar o Next.js no seu projeto?
- O que preciso ter antes de instalar o Next.js?
- Como instalar o Next.js no Windows?
- Como instalar o Next.js no macOS?
- Como configurar o VS Code para trabalhar com Next.js?
- Como rodar o projeto e conferir se funcionou?
- Quais erros comuns aparecem na instalação?
- Perguntas frequentes
Por que usar o Next.js no seu projeto?
O Next.js organiza o projeto e entrega recursos prontos para o dia a dia de desenvolvimento. Entre eles, estão:
- roteamento baseado em pastas;
- renderização no servidor;
- otimização de imagens;
- boa base para SEO (Search Engine Optimization, ou otimização para mecanismos de busca).
Com isso, a equipe reduz o tempo de configuração e foca na construção do produto. Além disso, o ecossistema é ativo e conta com muito material de apoio.
Por isso, aprender a instalar o Next.js é um investimento seguro para equipes e para quem está começando.
O que preciso ter antes de instalar o Next.js?
Antes de instalar o Next.js, confirme estes itens.
- Node.js: versão 20.9 ou superior, requisito mínimo da documentação oficial.
- npm (Node Package Manager): já vem junto com o Node.js.
- VS Code: o editor é opcional, mas facilita o trabalho.
- Sistema operacional: o Next.js funciona no Windows, no macOS e no Linux.
Como instalar o Next.js no Windows?
No Windows, o processo começa pela instalação do Node.js. Em seguida, você cria o projeto pelo terminal. Siga estes passos em ordem:
- Primeiro, acesse o site oficial do Node.js e baixe o instalador da versão LTS (Long Term Support, ou suporte de longo prazo).
- Em seguida, execute o instalador e mantenha as opções padrão.
- Depois, abra o PowerShell e confira a instalação com
node -venpm -v. Os dois comandos devem mostrar um número de versão. - Agora, instale o VS Code, crie uma pasta para seus projetos e abra essa pasta pelo menu Arquivo.
- Então, abra o terminal integrado em Terminal > Novo Terminal.
- Digite o comando abaixo e pressione Enter:
npx create-next-app@latest meu-projeto - Por fim, responda às perguntas do assistente. Informe o nome do projeto e escolha a opção “Yes, use recommended defaults”. Ela ativa TypeScript, ESLint, Tailwind e App Router.
Se preferir pular as perguntas, adicione --yes ao final do comando. Assim, o assistente usa as configurações recomendadas.
Como instalar o Next.js no macOS?
No macOS, o caminho é muito parecido. A diferença está na instalação do Node.js e no atalho do terminal. Veja os passos:
- Primeiro, baixe o instalador da versão LTS no site oficial do Node.js. Se você usa o Homebrew, também pode rodar
brew install node. - Em seguida, abra o aplicativo Terminal e confira a instalação com
node -venpm -v. - Depois, instale o VS Code, crie uma pasta de projetos e abra essa pasta no editor.
- Então, abra o terminal integrado com o atalho
Ctrl + `(acento grave). - Agora, rode o mesmo comando de criação:
npx create-next-app@latest meu-projeto - Por fim, escolha as configurações recomendadas e aguarde a instalação das dependências.
Como configurar o VS Code para trabalhar com Next.js?
O Next.js inclui um plugin de TypeScript que o VS Code usa para sugerir código e apontar erros. Para ativá-lo, siga estes passos:
- Primeiro, abra a paleta de comandos com Ctrl + Shift + P no Windows, ou ⌘ + Shift + P no macOS.
- Em seguida, pesquise por “TypeScript: Select TypeScript Version”.
- Por fim, escolha “Use Workspace Version”.
Assim, o editor passa a usar a versão do TypeScript do próprio projeto.
Como rodar o projeto e conferir se funcionou?
Depois da criação, entre na pasta do projeto e inicie o servidor local:
cd meu-projeto
npm run dev
Em seguida, abra o navegador e acesse http://localhost:3000. Se a página inicial do Next.js aparecer, a instalação funcionou.
Para testar uma alteração, abra o arquivo app/page.tsx e edite o texto. Ao salvar, o navegador atualiza a página sozinho.
Quais erros comuns aparecem na instalação?
Alguns erros aparecem com frequência durante a instalação. Veja os principais e como resolver cada um:
- Versão antiga do Node.js: se o comando falhar logo no início, rode
node -v. Caso a versão seja inferior à 20.9, instale a versão LTS atual. - Scripts desabilitados no PowerShell (Windows): use o Prompt de Comando no lugar do PowerShell. Outra opção é liberar a execução de scripts para o seu usuário.
- Nome de projeto inválido: evite espaços e letras maiúsculas no nome da pasta. Use algo como
meu-projeto. - Porta 3000 ocupada: outro programa pode estar usando a porta. Nesse caso, o Next.js costuma sugerir uma porta livre, como a 3001. Basta acessar o endereço indicado no terminal.
Perguntas frequentes
As dúvidas abaixo aparecem com frequência na instalação do Next.js.
O Next.js precisa do Node.js?
Sim. O Node.js executa o servidor de desenvolvimento e as ferramentas de build. A versão mínima é a 20.9.
Dá para instalar o Next.js sem o VS Code?
Dá. O editor é opcional. Qualquer editor de código e um terminal são suficientes.
Qual versão do Node.js devo usar?
Use a versão LTS mais recente, desde que seja 20.9 ou superior. Ela recebe suporte por mais tempo.
O Next.js funciona no Linux?
Sim. A documentação oficial lista suporte para Windows, macOS e Linux.
Chegou a hora de atualizar os seus projetos?
A Orbital desenvolve produtos digitais e atua com squads de tecnologia. Isso inclui a escolha da stack, a arquitetura e a entrega de aplicações web prontas para crescer.
Fale com a gente. Podemos ajudar você a rodar o seu próximo projeto com o Next.js já conectado a um CMS (Content Management System) headless, como o Payload CMS.
Clique aqui, mande uma mensagem e vamos tirar a sua ideia da cabeça.
