Desenvolvimento Local
Projetos conectados expõem dois targets para executá-los em sua máquina: serve e dev. A diferença é de escopo — quanto da sua aplicação é executado localmente versus apontando para a infraestrutura AWS implantada.
Considere um workspace com as seguintes conexões: um website que chama uma api tRPC, e também chama um agent que por sua vez chama um servidor mcp.
O target serve executa apenas o projeto alvo localmente. Todos os outros projetos aos quais ele se conecta devem estar implantados, e são acessados em sua URL AWS real.
pnpm nx serve websiteyarn nx serve websitenpx nx serve websitebunx nx serve websiteComo o projeto alvo se comunica com recursos implantados, ele precisa saber onde eles estão. Para um website, isso é fornecido por seu runtime-config.json (veja Local Runtime Config), que você carrega de uma aplicação implantada. Para projetos do lado do servidor (APIs e agents) que leem Runtime Configuration, defina a variável de ambiente RUNTIME_CONFIG_APP_ID para apontar para sua aplicação AppConfig implantada.
Use serve quando você quiser iterar em um único projeto contra as versões “reais” e implantadas de tudo de que ele depende.
O target dev executa o projeto alvo e todos os projetos conectados a ele transitivamente, todos em sua máquina. O gerador de conexão configura isso automaticamente — executar dev no website também inicia servidores locais para a api, o agent e o servidor mcp que ele alcança através do agent.
pnpm nx dev websiteyarn nx dev websitenpx nx dev websitebunx nx dev websiteQuando executado dessa forma, o runtime-config.json do website é automaticamente sobrescrito (via Vite’s MODE, definido como local-dev) para que ele aponte para seus servidores em execução local em vez de URLs implantadas.
Todos os projetos são executados localmente, então não há dependências implantadas.
Use dev quando você estiver trabalhando em vários projetos conectados ao mesmo tempo e quiser iterar rapidamente sem implantar sua infraestrutura.
Projetos com múltiplos componentes
Seção intitulada “Projetos com múltiplos componentes”Alguns tipos de projeto podem conter múltiplos componentes em um único projeto (por exemplo, um projeto TypeScript ou Python contendo vários agents e servidores MCP). Para estes:
- O target
devno nível do projeto inicia todos os componentes do projeto juntos. Cada componente é adicionado aodevconforme é gerado:
pnpm nx dev my-projectyarn nx dev my-projectnpx nx dev my-projectbunx nx dev my-project- Cada componente também expõe um target
<component-name>-dev, para que você possa executar um único componente por conta própria:
pnpm nx my-component-dev my-projectyarn nx my-component-dev my-projectnpx nx my-component-dev my-projectbunx nx my-component-dev my-projectPara mais detalhes sobre o servidor de desenvolvimento local de cada tipo de projeto, veja o guia relevante — por exemplo, o guia React Website.