Como usar: Gerador de package.json
- Digite o nome e a versão do pacote — o nome é verificado conforme as regras de nomenclatura do npm enquanto você digita.
- Escolha uma predefinição de scripts (Node, Vite, Next.js, biblioteca TypeScript) e o tipo de módulo.
- Adicione licença, autor, repositório e a versão do Node.js que o seu código precisa.
- Copie ou baixe o arquivo para a raiz do projeto e execute
npm installpara adicionar as dependências.
Os campos mais importantes do package.json
| Campo | O que faz |
|---|---|
name | Nome do pacote — minúsculo, máx. 214 caracteres, seguro para URL, pode ter escopo (@org/nome) |
version | Uma versão semântica como 1.4.2 |
type | "module" trata arquivos .js como módulos ES (import); o padrão é CommonJS |
main / exports | O(s) ponto(s) de entrada que outros códigos importam. exports também oculta arquivos internos |
scripts | Comandos para npm run dev, build, test… |
engines | Versões do Node.js suportadas pelo seu código |
private | true impede um npm publish acidental |
packageManager | Fixa o npm, pnpm ou Yarn via Corepack |
As dependências são adicionadas pelo gerenciador de pacotes
Não digite as versões das dependências manualmente — execute npm install react ou npm install -D vite e o npm as grava com o intervalo de versão correto (geralmente ^). Faça commit do arquivo de lock para que todos instalem as mesmas versões.
Próximos passos para um novo projeto
Adicione um .gitignore (no mínimo node_modules/ e .env), um .editorconfig, um README e um workflow do GitHub Actions que execute seus scripts test e build a cada push.
Também pesquisado como: exemplo de package.json, npm init, scripts do package.json, exports do package.json, package.json node, regras de nome de pacote npm, package.json type module.
Ferramentas que combinam com: Gerador de package.json
- Formatação JSON — Cole o JSON aqui para formatá-lo, compactá-lo ou validá-lo.
- Validador YAML — Cole um arquivo Docker Compose, manifesto Kubernetes, workflow do GitHub Actions ou qualquer YAML para localizar erros, evitar armadilhas comuns e obter uma versão bem formatada.
- Gerador de YAML Kubernetes — Preencha o nome, a imagem e a porta do seu app e receba YAML do Kubernetes pronto para produção: um Deployment com probes, limites de recursos e contexto de segurança reforçado, além do Service, do Ingress com TLS, do ConfigMap, do Secret e do HorizontalPodAutoscaler que você marcar, tudo em um arquivo pronto para kubectl apply.
- Gerador de systemd Service — Rode seu app como um serviço Linux de verdade, que inicia com o sistema e reinicia quando trava.
Perguntas frequentes
Quais são as regras para nomes de pacotes npm?
Apenas minúsculas, sem espaços, máx. 214 caracteres, não pode começar com ponto ou sublinhado, apenas caracteres seguros para URL (letras, dígitos, - . _ ~), e não pode ser o nome de um módulo nativo do Node.js como http. Nomes com escopo têm o formato @escopo/nome.
Devo usar "type": "module"?
Em projetos novos, sim — os módulos ES são o padrão e funcionam no Node.js 18+, no Vite e na maioria das ferramentas. Use CommonJS apenas se depender de ferramentas que exigem require().
O que faz "private": true?
Faz o npm recusar a publicação do pacote, o que protege aplicações e projetos internos de serem publicados por engano.
Para onde vão as dependências?
Instale-as com npm, pnpm ou Yarn; a ferramenta as grava automaticamente em dependencies ou devDependencies.
Posso instalar o Gerador de package.json como um aplicativo da web e usá-lo offline?
Sim. O Gerador de package.json é um aplicativo da web instalável (PWA) — instalado a partir do seu navegador, não baixado de uma loja de aplicativos. Clique em “Instalar aplicativo” na parte superior desta página no Chrome ou no Edge (Windows, macOS, Linux, ChromeOS) ou, no Android, use “Compartilhar” → “Adicionar à tela inicial” no iPhone e no iPad, ou “Arquivo” → “Adicionar ao Dock” no Safari 17+ em um Mac. Em seguida, ela se abre em uma janela própria com seu próprio ícone e, como é executada inteiramente no seu navegador, continua funcionando offline. O Firefox no desktop não permite a instalação de aplicativos da web. Como funciona a instalação.