Skip to main content
Os Replit Apps são configurados com dois arquivos: .replit e replit.nix. Eles afetam como seu Replit App se comporta, desde a execução do código até as ferramentas de desenvolvimento e linguagens. Esses arquivos de configuração ficam ocultos por padrão. Exiba-os no seu Replit App selecionando “Mostrar arquivos ocultos” no menu da árvore de arquivos.
imagem

Arquivo replit.nix

O Replit usa Nix para gerenciar pacotes e ambientes. O arquivo replit.nix é usado para: Especificar dependências do sistema: Defina exatamente quais pacotes de software seu Replit App requer, gerenciados pelo Nix, um gerenciador de pacotes. Criar ambientes reproduzíveis: Garanta que seu ambiente de desenvolvimento seja consistente e reproduzível, ideal para projetos colaborativos e testes em múltiplos sistemas. Você pode gerenciar pacotes Nix visualmente por meio da ferramenta Dependencies. Saiba mais no guia de Dependências do Sistema. Para configurar pacotes com o arquivo replit.nix, você pode listar pacotes Nix no array deps, prefixados com pkgs.. Quaisquer alterações serão sincronizadas após o recarregamento do seu Shell.

Arquivo .replit

O arquivo .replit controla o comportamento do seu Replit App. Ele usa o formato de configuração toml. Aqui estão alguns dos principais aspectos que podem ser configurados: Comando de execução: Especifique o comando que é executado quando o botão Run é selecionado. Cada template tem um comando de execução padrão para permitir a execução do código imediatamente. Para apps mais personalizados e complexos, use os Workflows. Language Server Protocol (LSP): Fornece recursos como autocompletar, navegação de código, realce de código e linting e erros em tempo real. Variáveis de ambiente: Defina e gerencie variáveis de ambiente essenciais para o funcionamento correto das suas aplicações. Dependências e pacotes: Gerencie instalações e configurações de pacotes diretamente pelo arquivo .replit, garantindo que seu Replit App tenha todas as ferramentas necessárias disponíveis na inicialização. Você pode gerenciar dependências visualmente por meio da ferramenta Dependencies. Saiba mais no guia de Módulos do Sistema. Para aplicações Python, o arquivo .replit padrão é:
A tabela a seguir apresenta uma visão de cada configuração dentro do arquivo .replit, explicando o que cada configuração faz e seu impacto no ambiente do Replit App. Agora que você tem uma ideia das configurações padrão do arquivo .replit, use as próximas seções para entender como configurar definições básicas e avançadas para o seu Replit App.

Configurando definições básicas

Entrypoint

Este é o arquivo principal do seu projeto. Se você não definir uma propriedade run, o entrypoint é o arquivo executado pelo runtime.

Comando Run

A propriedade run no arquivo .replit é um recurso fundamental que determina o comando inicial ou a série de comandos executados quando o botão Run é selecionado em um ambiente Replit. O comando Run pode ser especificado como uma string representando o comando a executar, ou como um array de strings representando o comando e seus argumentos individuais. Algumas formas comuns de configurar o comando Run:
  • Comando único: Este exemplo mostra como passar um único comando para executar diretamente no Replit App. Com isso no seu arquivo .replit, pressionar o botão Run exibirá uma saudação no painel Console: Exemplo: run = "echo 'Hello, Replit!'"
  • Argumentos explícitos: Em algumas situações, pode ser útil ser mais explícito, evitando a necessidade de interpretar aspas ou regras de interpolação do Shell. Você pode reescrever o exemplo acima separando os argumentos. Note que você não precisa mais usar ' e " ao mesmo tempo, pois está passando explicitamente a saudação como o primeiro e único argumento para echo: Exemplo: run = ["echo", "Hello, Replit!"]
  • Múltiplos comandos: Este exemplo mostra como executar múltiplos processos simultaneamente, como um frontend e um backend. Isso pode ser útil ao desenvolver um backend em Python e um frontend em TypeScript, onde cada servidor se conecta a uma porta diferente: Exemplo: run = "python -m app & npm run start & wait"

Gerenciamento de processos

Embora múltiplos comandos possam ser executados simultaneamente com &, você pode querer uma melhor experiência para distinguir os logs entre os serviços. Você pode adicionar dependências do sistema como process-compose para orquestrar melhor múltiplos processos.

Fase de Build

Para algumas linguagens ou runtimes, há uma fase de compilação separada antes que o código possa ser executado com run. Isso se aplica tanto a linguagens compiladas como TypeScript, Golang ou Java, quanto para oferecer um parâmetro que você pode usar para redefinir seu ambiente, dados ou configuração antes que o próximo run seja invocado.
  • Compilação: Em um repositório TypeScript, pode ser necessário executar tsc antes de executar seu código. Exemplo:

Incluindo variáveis de ambiente

Para fornecer variáveis de ambiente ao seu serviço antes da execução, você pode expandir a propriedade run em uma tabela. Esta é uma mudança mais elaborada e provavelmente requer mover onde a propriedade run = "..." está localizada dentro do seu arquivo .replit. O diff a seguir mostra como fornecer o comando por meio dos args de [run], além da variável NAME fornecida em [run.env]:

Interatividade

Programas interativos também podem ser iniciados pelo botão Run, oferecendo uma forma de distinguir seu ambiente de desenvolvimento do terminal onde o programa está sendo executado. Considere o seguinte script de contagem: Exemplo

Opções de configuração avançada

Explore as opções de configuração detalhadas disponíveis para o seu Replit App. Você pode personalizar seu ambiente de desenvolvimento, gerenciar comandos de execução, integrar serviços de linguagem e lidar com dependências.

Notas sobre o Áudio em todo o sistema

Ao definir audio = true no seu arquivo .replit, pode ser necessário executar kill 1 em um Shell para forçar a nova configuração a ter efeito. Ao executar uma aplicação gráfica, você verá um par de fones de ouvido com uma caixa de seleção no canto inferior direito do painel Output. Devido a restrições do navegador, isso precisará ser ativado toda vez que você atualizar a página.

Configuração do gerenciador de pacotes

Exemplo de configuração .replit para o gerenciador de pacotes

Configuração de implantação

Exemplo de configuração .replit para implantação

A configuração do interpretador foi descontinuada e não está mais disponível no Replit. Em vez disso, recomenda-se usar os comandos Run para configurar como scripts e aplicações são executados no ambiente do seu Replit App.

Configuração de portas

Exemplo de arquivo de configuração .replit para gerenciamento de portas

Acessando metadados do ambiente do Replit App

Node.js

Para acessar todas as variáveis de ambiente: console.log(process.env); Para acessar uma única variável (REPL_SLUG): console.log(process.env.REPL_SLUG);

Python

Para acessar todas as variáveis de ambiente:
Para acessar uma única variável (REPL_SLUG):

Rust

Para acessar todas as variáveis de ambiente:
Para acessar uma única variável (REPL_SLUG):

Variáveis de ambiente

A seguir estão as variáveis de ambiente acessíveis dentro do seu Replit App: