O Bun suporta carregar opções de configuração de arquivos .npmrc, permitindo reutilizar configurações existentes de registro/escopo.

NOTE

Recomendamos migrar seu arquivo `.npmrc` para o formato [`bunfig.toml`](/pt/runtime/bunfig) do Bun, pois ele fornece opções mais flexíveis e permite configurar opções específicas do Bun.

---

Opções suportadas

Definir o registro padrão

O registro padrão é usado para resolver pacotes, seu valor padrão é o registro oficial do npm (https://registry.npmjs.org/).

Para alterá-lo, você pode definir a opção registry no .npmrc:

registry=http://localhost:4873/

A opção equivalente no bunfig.toml é install.registry:

install.registry = "http://localhost:4873/"

Definir o registro para um escopo específico

@<scope>:registry permite definir o registro para um escopo específico:

@myorg:registry=http://localhost:4873/

A opção equivalente no bunfig.toml é adicionar uma chave em install.scopes:

[install.scopes]
myorg = "http://localhost:4873/"

Configurar opções para um registro específico

//<registry_url>/:<key>=<value> permite definir opções para um registro específico:

# definir um token de autenticação para o registro
# ${...} é um placeholder para variáveis de ambiente
//http://localhost:4873/:_authToken=${NPM_TOKEN}


# ou você pode definir um nome de usuário e senha
# note que a senha é codificada em base64
//http://localhost:4873/:username=myusername

//http://localhost:4873/:_password=${NPM_PASSWORD}

# ou usar _auth, que é seu nome de usuário e senha
# combinados em uma única string, que é então codificada em base64
//http://localhost:4873/:_auth=${NPM_AUTH}

As seguintes opções são suportadas:

• _authToken
• username
• _password (senha codificada em base64)
• _auth (nome de usuário:senha codificado em base64, por exemplo btoa(username + ":" + password))

A opção equivalente no bunfig.toml é adicionar uma chave em install.scopes:

[install.scopes]
myorg = { url = "http://localhost:4873/", username = "myusername", password = "$NPM_PASSWORD" }

link-workspace-packages: Controlar instalação de pacotes do workspace

Controla como os pacotes do workspace são instalados quando disponíveis localmente:

link-workspace-packages=true

A opção equivalente no bunfig.toml é install.linkWorkspacePackages:

[install]
linkWorkspacePackages = true

save-exact: Salvar versões exatas

Sempre salva versões exatas sem o prefixo ^:

save-exact=true

A opção equivalente no bunfig.toml é install.exact:

[install]
exact = true