---
title: "O código do seu site | Briks"
url: https://briks.dev/pt-br/docs/code
description: "Veja, edite e publique o código do seu site no File Explorer em todos os planos. Em plano pago, baixe qualquer versão em zip e veja o que ficou de fora."
last_updated: 2026-10-08
---

# O código do seu site

O Briks escreve código de verdade para cada site, e ele é seu para ler. O File Explorer mostra os arquivos escritos para o seu site como a versão publicada os mantém. Quem tem permissão de edição pode alterá-los e publicar, em todos os planos. Em um plano pago, qualquer pessoa do espaço de trabalho também pode baixá-los em zip.

6 min de leitura Conferido com o estúdio em 8 de outubro de 2026

## Abra o File Explorer

Onde

1. Projects
2. Your project
3. Settings
4. File Explorer

Ela tem duas telas: **Files**, onde você lê e edita, e **Settings**, onde você baixa em um plano pago. O título diz qual versão está no ar, por exemplo “The code written for this site, as version 14 is live.” Até o site ser publicado, não há nada para mostrar, e a página exibe “Nothing published yet”.

## Explorar os arquivos

Pastas e arquivos aparecem em árvore à esquerda, primeiro as pastas, cada uma em ordem de nome. Digite em **Filter files** para reduzir a lista por nome ou pasta. Embaixo, uma contagem mostra algo como “38 files written for this site”. O primeiro arquivo aberto é `content/site.ts`, que guarda os principais dados do site.

| Pasta | O que está incluído |
| --- | --- |
| `app/` | As páginas do site, uma pasta para cada endereço de página. |
| `components/custom/` | As seções escritas para o seu site, como a abertura, a lista de serviços e o rodapé. |
| `content/` | Os textos e os fatos do site. |
| `public/` | Arquivos que o site entrega como estão. |
| `api/` | O código de servidor do próprio site, se houver. |
| `db/` | A estrutura dos dados do site, se ele guardar algum. |

Clique em um arquivo para lê-lo com números de linha. **Wrap lines** evita que linhas longas saiam pela lateral, e **Copy** coloca o arquivo inteiro na sua área de transferência. Imagens e outros arquivos que não são texto aparecem na lista, mas não são exibidos, e fazem parte do download em um plano pago.

## Edite um arquivo e publique

Editors, Admins e Owners ganham um editor ao abrir um arquivo. Viewers veem todos os arquivos somente para leitura.

1. Abrir o arquivo

   Onde: Files

   Clique nele na árvore. O editor abre com o texto dele.

2. Faça sua edição

   Onde: Editor

   Digite como em qualquer editor de código. O arquivo fica marcado como **Edited**, e a pasta dele mostra um ponto enquanto está fechada. **Undo changes** devolve um arquivo ao que era antes.

3. Adicione ou exclua arquivos, se precisar

   Onde: Files

   **New file** pede um caminho dentro de `app/`, `components/custom/`, `content/`, `api/`, `db/` ou `public/`. **Delete** marca um arquivo para remoção, e **Keep file** desfaz a decisão.

4. Salvar e publicar

   Onde: Editor

   Pressione **Save and publish** na barra inferior, ou Ctrl+S (⌘S no Mac). A janela lista todos os arquivos alterados.

5. Adicionar uma nota

   Onde: Dialog

   Se quiser, diga o que mudou em **Note**. Isso fica no histórico de versões.

6. Confirmar

   Onde: Dialog

   Pressione **Save and publish**. A barra mostra, por exemplo, “Publishing 2 changed files.” com um link para acompanhar no Studio.

As edições existem só nesta aba

Até você publicar, suas alterações existem apenas nesta aba do navegador. Sair da página pergunta “Leave without publishing?”, e fechar a aba as descarta. O site no ar não é tocado até você publicar.

## O que acontece depois de salvar

A Briks compila o site com os seus arquivos e o publica, geralmente em poucos minutos. Nada é redesenhado nem reescrito, e nenhum crédito é reservado ou cobrado. O estúdio mostra **Verifying build** e **Publishing**, depois uma resposta como “Your code changes are live: 2 files changed in the File Explorer. Nothing else about the site changed.” De volta ao File Explorer, uma barra verde diz “Your changes are published and live.” com **Open the site**.

O salvamento vira uma nova versão marcada como **Change**, e a seta de desfazer acima da prévia a desfaz. As alterações que você pedir depois na conversa partem dos seus arquivos editados. As alterações publicadas pelo [Editor Visual](https://briks.dev/pt-br/docs/visual-editor) são gravadas nesses mesmos arquivos, então você as vê aqui quando estiverem no ar.

Se o seu código não compilar, nada é publicado e o site no ar continua como estava. Uma caixa vermelha diz “Nothing was published”, indica o arquivo em que parou e mostra abaixo as próprias linhas da compilação. Suas edições continuam lá: pressione o botão **Open** desse arquivo para ir até a linha, corrija e publique de novo.

| Limite | Valor |
| --- | --- |
| Arquivos em um salvamento | 50 |
| Um arquivo que você pode editar | 256 KB (arquivos maiores aparecem somente para leitura) |
| Todas as alterações em um só salvamento | 2 MB |
| A nota | 300 caracteres |

Um salvamento é recusado, com o motivo, se o site mudou desde que você abriu a página (“The site changed since you opened it: reload to see the new version.”), enquanto algo está sendo construído ou enquanto um teste A/B está em andamento. Alguns arquivos são escritos pelo estúdio antes de cada build, então não podem ser alterados aqui, e o File Explorer avisa isso se você tentar.

## Baixar o código

Baixar o código faz parte de um plano pago. No Free, o botão **Download code** e os botões **Download** em **Backups** não aparecem. Um aviso diz “Downloading the code comes with a paid plan.”, e **See what's included** abre a janela de upgrade em **Download your site's code**. Ver e editar os arquivos continua disponível em todos os planos.

1. Vá para a visualização Settings

   Onde: File Explorer

   Abra **Settings**, **File Explorer** e depois a visão **Settings** ao lado de **Files**.

2. Baixar

   Onde: Export

   Pressione **Download code**. Você recebe um zip com o nome do endereço e da versão do site, como `harbour-plumbing-version-14.zip`.

Onde

1. Settings
2. File Explorer
3. Settings
4. Download code

Para uma versão anterior, abra **Settings**, **Backups**: cada versão tem o seu próprio botão **Download**. A linha **Download code** traz uma etiqueta **Paid**.

## O que o zip contém e o que não contém

O zip contém os arquivos escritos para o seu site: suas páginas, seções, textos e arquivos próprios, exatamente como aquela versão os tinha. Ele deixa de fora os blocos de construção compartilhados que o estúdio fornece a todo site, os arquivos que configuram a construção e qualquer coisa secreta. Como essas peças compartilhadas não estão incluídas, o zip não roda nem compila sozinho.

Isso faz dele um registro e uma referência, não uma cópia portátil. As pessoas o usam para guardar um arquivo do que foi ao ar, mostrar a um desenvolvedor como uma seção foi feita ou pesquisar os textos do site no próprio editor.

Arquivar Agência de design

> Uma agência com seis sites de clientes baixa o zip de cada site após o lançamento e o arquiva junto ao contrato do cliente.

Cada zip guarda as páginas e os textos da versão lançada, para mostrar exatamente o que foi ao ar e quando.

Um pequeno ajuste manual Clínica de fisioterapia

> A administração da clínica encontra o arquivo com os horários de funcionamento, muda sexta-feira para 8h às 16h, adiciona a nota `Horário de inverno` e aperta **Save and publish**.

Alguns minutos depois, o site mostrava o novo horário. **Versions** o listou como um **Change**, e nenhum crédito foi usado.

### Viewers podem editar código?

Não. Elas podem ler todos os arquivos e, em um plano pago, baixar o zip.

### Posso baixar o código no Free?

Não. Baixar o código faz parte de um plano pago, a partir do Starter. No Free, você ainda pode ver todos os arquivos e, com direito de edição, editá-los e publicá-los.

### O Briks vai sobrescrever minhas edições?

As alterações que você pedir depois partem dos seus arquivos. Uma alteração ainda pode reescrever um arquivo que ela toca, então mencione a sua edição se pedir ao Briks para mudar a mesma seção.

### Posso adicionar imagens aqui?

Não. Imagens e outros arquivos que não são texto não podem ser criados no File Explorer. Use a aba **Media** ou **Storage**.

## Leia a seguir

- [Trabalhando em um projeto **Versões, desfazer e refazer** Cada build e alteração é salva como versão do seu site. Desfaça, refaça ou recoloque no ar qualquer versão anterior, exatamente como era, sem reter créditos.](https://briks.dev/pt-br/docs/versions)
- [Trabalhando em um projeto **Sincronização com o GitHub** Conecte um repositório do GitHub: cada versão publicada é enviada para lá em um commit e cada push na branch é verificado e publicado no seu site.](https://briks.dev/pt-br/docs/github)
- [Dados e automação **Backups** O que o Briks guarda de cada projeto: versões do código, pontos de restauração do banco e cópias noturnas. Como restaurar, baixar e o que cada cópia contém.](https://briks.dev/pt-br/docs/backups)
- [Dados e automação **Segredos** Guarde chaves de API e senhas do código no servidor do site, nunca em páginas ou downloads. Adicione, altere e remova, e veja as regras que o Briks aplica.](https://briks.dev/pt-br/docs/secrets)

Ainda travado?

Escreva para [hello@briks.dev](mailto:hello@briks.dev) com o nome do seu projeto e o que você esperava ver. Uma captura de tela ajuda.