> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Palavras que você vai ver

Definições em linguagem simples para os termos que os guias de configuração, as mensagens de erro e o próprio produto usam.

## Arquivos e pastas

Estas palavras descrevem o código que você baixou. Os guias de configuração as nomeiam sempre que pedem para você abrir ou editar um arquivo.

- Repository — a pasta do projeto mais o histórico completo de alterações, hospedada no GitHub e copiada para o seu computador.
- Clone — a sua própria cópia de um repositório no computador; o comando git clone a cria.
- Monorepo — um único repositório que guarda vários apps e pacotes compartilhados; o pacote All Platforms é um.
- package.json — o arquivo em cada app ou pacote que lista o seu nome, os seus comandos e as bibliotecas de que precisa.
- pnpm-workspace.yaml — o arquivo na raiz do monorepo que lista quais pastas pertencem ao workspace.
- Lockfile — o arquivo que registra a versão exata de cada biblioteca instalada, para que toda instalação saia igual.


## Ferramentas no seu computador

Programas que você instala uma vez antes da primeira execução. Os guias os nomeiam em comandos como node --version.

- Terminal — a janela onde você digita comandos, como o PowerShell no Windows ou o Terminal no macOS.
- Node.js — o programa que executa JavaScript fora do navegador; o servidor e os scripts do kit rodam nele.
- npm — o instalador de bibliotecas que vem com o Node.js; neste kit você o usa principalmente para chegar ao Corepack.
- Corepack — a ferramenta que ativa a versão exata do gerenciador de pacotes que o projeto fixa.
- pnpm — o gerenciador de pacotes que baixa bibliotecas e executa os scripts do projeto; acesse-o como corepack pnpm.
- Git — a ferramenta que baixa o seu repositório e registra cada alteração que você faz nele.
- Editor ou IDE — o app onde você abre pastas e edita arquivos; os guias usam o Visual Studio Code.


## Palavras de configuração

As configurações vivem em arquivos, não no terminal. Estas palavras cobrem onde elas ficam e como se chamam.

- Variável de ambiente — uma configuração com nome, como EMAIL_PROVIDER=local, que muda o comportamento do app.
- .env — o arquivo na raiz do repositório que guarda configurações para comandos como as migrações de banco de dados.
- .env.local — o arquivo de configurações de um app, como apps/web/.env.local para o servidor web.
- Secret — um valor que deve permanecer privado, como uma senha ou chave de assinatura; nunca faça commit dele nem o cole em chats.
- API key — uma string secreta que um serviço externo lhe dá para reconhecer o seu app como um chamador autorizado.
- Provider — um serviço externo que o kit pode usar para IA, e-mail, cobrança, armazenamento e tarefas parecidas.


## Palavras que o produto usa

O app em execução e as suas telas de configurações usam estes termos. Workspace aparece com dois significados diferentes — confira o contexto.

- Workspace — no produto, os usuários, dados e configurações separados de uma equipe; em comandos pnpm, uma pasta de pacote dentro do monorepo, selecionada com --filter.
- Entitlement — o registro no servidor de que um espaço de trabalho pode usar um recurso pago.
- Migration — uma alteração de banco de dados versionada que cria ou atualiza tabelas; você aplica migrações com um comando.
- Session — o estado de login que diz ao servidor quem está pedindo, até expirar ou você sair.
- Webhook — uma mensagem que um serviço externo envia ao URL do seu app quando algo acontece, como uma fatura paga.
- Account vs organization — uma account é o login de uma pessoa; uma organization é o espaço de equipe compartilhado em que os membros entram, também chamado de workspace.


## Palavras de desenvolvimento web

Termos que os guias de execução, build e implantação usam quando você abre o app num navegador.

Ctrl + C significa pressionar e segurar Ctrl, tocar em C e soltar — isso interrompe o comando em execução num terminal.

[Aprenda comandos, arquivos e configuração na prática](https://supastack.dev/pt/docs/web/terminal-basics.md)

[Como usar esta documentação](https://supastack.dev/pt/docs/web/using-the-docs.md)

- localhost — o nome deste computador num endereço de navegador; o seu app roda aí durante o desenvolvimento.
- Port — a porta numerada depois de localhost, como :3000; cada app em execução usa uma diferente.
- Dev server — o comando que fica recompilando e servindo o app enquanto você trabalha; pare-o com Ctrl + C.
- Build — o passo que transforma o seu código-fonte nos arquivos otimizados que um servidor implanta.
- Server rendering (SSR) — páginas que o servidor monta antes de enviá-las, para que a primeira visualização chegue completa.


## Seguinte

[Atualize a sua cópia quando o kit melhorar](https://supastack.dev/pt/docs/web/updating-the-kit.md)