--- name: azion-crie-apps-com-o-next-js-static-boilerplate description: >- O Next.js Static Boilerplate fornece uma solução de automação para criar uma application Next.js estática na Azion. --- # Crie apps com o Next.js Static Boilerplate O **Next.js Static Boilerplate** da Azion facilita a criação e implantação de uma **Next.js Single-Page Application (SPA)** diretamente na infraestrutura distribuída da Azion. Ao executar o boilerplate, várias etapas são automatizadas, desde o gerenciamento de repositório até a implantação da aplicação de uma única página. Este template usa o Next.js versão `14.1.4`. --- ## Sobre static exports O núcleo do Next.js oferece suporte a exportações estáticas. Isso permite que você inicie seu projeto como um site estático ou uma SPA e, em seguida, adicione recursos que requerem um servidor. Ao usar esses recursos avançados, o Next.js gera um arquivo HTML por rota, dividindo um SPA estrito em arquivos HTML individuais, e seu projeto pode ser implantado e hospedado em qualquer servidor web que possa servir ativos estáticos HTML/CSS/JS. Esse recurso inclui *recursos suportados e não suportados*, listados abaixo, que você deve levar em consideração ao desenvolver e gerenciar seu projeto. Acesse a documentação do Next.js para obter mais detalhes sobre [static exports](https://nextjs.org/docs/app/building-your-application/deploying/static-exports). ### Recursos suportados - Componentes do servidor - Componentes do cliente - Otimização de imagem - Otimização de imagem (através de `next/image` pode ser usada com uma exportação estática definindo um carregador de imagem personalizado em `next.config.js`) - Manipuladores de rota - APIs do navegador ### Recursos não suportados Esses recursos exigem um servidor Node.js ou uma lógica dinâmica que não pode ser computada durante o processo de compilação e não têm suporte: - Rotas dinâmicas com `dynamicParams: true` - Rotas dinâmicas sem `generateStaticParams()` - Manipuladores de rotas que dependem de requisição - Cookies - Rewrites - Redirecionamentos - Cabeçalhos - Middleware - Regeneração estática incremental - Otimização de imagem (com o loader padrão) - Modo draft --- ## Pré-requisitos - Uma [conta no GitHub](https://github.com/signup) para conectar com a Azion e criar seu novo repositório. - Cada push será implantado automaticamente neste repositório para manter seu projeto atualizado. - O template usa [Functions](/pt-br/documentacao/plataforma/functions/). Isso pode gerar custos relacionados ao uso. Consulte a [página de preços](/pt-br/documentacao/fundamentos/precos/) para mais informações. --- ## Implante o template Você pode obter e configurar seu template pelo Azion Console. Para implantá-lo facilmente na Azion, selecione o botão abaixo. [Implantar](https://console.azion.com/create/nextjs/next-static-boilerplate) --- No formulário de configuração, forneça as informações para configurar sua aplicação. Preencha os campos apresentados. Os campos identificados com asterisco são obrigatórios. 1. **Conecte a Azion com sua conta do GitHub** - Uma janela pop-up será aberta para confirmar a instalação da [Azion GitHub App](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/automacao/azion-github-app/), uma ferramenta que conecta sua conta do GitHub com a plataforma da Azion. - Defina suas permissões e acesso ao repositório conforme desejado. 2. **Selecione o Git Scope** Selecione o **Git Scope** com o qual trabalhar. 3. **Defina um nome para sua application** - O bucket para armazenamento e a function usarão o mesmo nome. - Use um nome único e fácil de lembrar. Se o nome já tiver sido usado, a plataforma retornará uma mensagem de erro. 4. **Selecione Deploy** Selecione o botão **Deploy** para iniciar o processo de implantação. Durante a implantação, você poderá acompanhar o processo através de uma janela mostrando os logs. Quando estiver concluída, a página mostra informações sobre a aplicação e algumas opções para continuar sua jornada. > **nota** > > O link para sua application permite que você veja como ela fica no navegador. No entanto, leva um certo tempo para propagar e configurá-la na infraestrutura distribuída da Azion. Pode ser necessário aguardar alguns minutos para que a URL seja ativada e para que a página da aplicação seja efetivamente exibida no navegador. ### Principais configurações A aplicação passa por um processo de criação otimizado, enfatizando no melhor desempenho e a eficiência aproveitando os recursos da **Azion Web Platform**. O script cria um [repositório do GitHub](https://github.com/aziontech/azion-samples/tree/dev/templates/nextjs/nextjs-static-boilerplate-14) para gerenciar o código-fonte e, em seguida, instala todas as dependências necessárias. Além disso, sua aplicação é implantada na plataforma da Azion e ao mesmo tempo define múltiplas configurações, como o setup da application e do seu domínio para hospedar seu projeto Next.js e uma function para lógica personalizada. O script também confirma os detalhes da implantação no repositório do GitHub do usuário para manter um histórico transparente e rastreável, incluindo informações relacionadas à versão implantada e um registro de data e hora da implantação. O template também inclui uma GitHub Action para habilitar a implantação contínua. --- ## Gerencie o template Considerando que essa configuração inicial pode não ser ideal para sua aplicação, todas as configurações podem ser personalizadas sempre que você precisar usando o Azion Console. Para gerenciar e editar as configurações da sua aplicação, siga estas etapas: 1. **Acesse Azion Console** [Acesse o Azion Console](https://console.azion.com). 2. **Selecione Applications** No canto superior esquerdo, selecione **Products menu** > **Applications**. - Você será redirecionado para a página de **Applications**. Ela lista todas as applications que você criou. 3. **Selecione sua application** Encontre a application relacionada ao **Next.js Static Boilerplate** e selecione-a. - A lista é organizada em ordem alfabética. Você também pode usar a **barra de busca** localizada no canto superior esquerdo da lista; atualmente, ela é filtrada apenas pelo **Application Name**, ou nome da application. Depois de selecionar a aplicação em que você trabalhará, você será direcionado para uma página que contém todas as configurações que você pode ajustar. > **dica** > > Leia a documentação sobre o [gerenciamento de applications](/pt-br/documentacao/plataforma/applications/primeiros-passos/) para obter mais detalhes. ### Adicione um domínio personalizado A application criada tem um Azion Workload Domain atribuído para torná-la acessível através do navegador. O domínio tem o seguinte formato: `xxxxxxxxxx.map.azionedge.net`. No entanto, você pode adicionar um domínio personalizado para que os usuários acessem sua aplicação por meio dele. Para mais informações, consulte [Adicione um domínio a um workload](/pt-br/documentacao/guias/plataforma/migracao/configurar-dominio/).