> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração do AppSignal para JavaScript

## Configurando o AppSignal

Para configurar o AppSignal para JavaScript no front-end, recomendamos criar um arquivo `appsignal.js` com a configuração do AppSignal no diretório raiz do seu projeto ou no diretório `src`.
Em seguida, faça `require` ou `import` do arquivo de configuração no código da sua aplicação antes de qualquer outro pacote ser requerido ou importado.

No exemplo abaixo, há um arquivo `appsignal.js` na raiz do diretório da aplicação. Na linha 8, adicionamos a opção de configuração `namespace`.

<CodeGroup>
  ```javascript JavaScript theme={null}
  // For ES Module via npm/yarn, or with import maps
  import Appsignal from "@appsignal/javascript";
  // For CommonJS module via npm/yarn
  const Appsignal = require("@appsignal/javascript").default;
  // With the JSPM.dev CDN
  import Appsignal from "https://jspm.dev/@appsignal/javascript";

  const appsignal = new Appsignal({
    key: "<YOUR FRONTEND API KEY>",
  });

  module.exports = { appsignal };
  ```
</CodeGroup>

## Personalizar a configuração

Você pode personalizar o relatório de erros da sua aplicação com as [opções de configuração do front-end](/front-end/configuration/options).

Veja um exemplo de como a [opção namespace](/front-end/configuration/options#namespace) é personalizada.

<CodeGroup>
  ```diff Example namespace option theme={null}
   const appsignal = new Appsignal({
     key: "<YOUR FRONTEND API KEY>",
  +  namespace: "frontend", // Configure the AppSignal namespace for front-end errors in this app
   });
  ```
</CodeGroup>

## Requerer a configuração do AppSignal

Quando terminar a configuração da sua aplicação, faça `require` do arquivo `appsignal.js` bem no topo do arquivo principal da sua aplicação, como no exemplo abaixo:

<CodeGroup>
  ```javascript JavaScript theme={null}
  // Place this at the top
  // Import the file created in the previous step
  const { appsignal } = require("./appsignal"); // Update to the location used in the previous step

  // Place your app code below this
  ```
</CodeGroup>

Depois que sua aplicação carregar a biblioteca JavaScript do AppSignal, certifique-se de seguir todos os [passos do guia de instalação](/front-end/installation), adicionando [integrações](/front-end/integrations), adicionando [plugins](/front-end/plugins) e personalizando sua [configuração](/front-end/configuration/options).