Você não precisa saber programar pra publicar um bom portfólio. Precisa especificar o que importa, limitar cada mudança e exigir prova do que foi verificado. Este workspace, um painel de trabalho que salva seu progresso, transforma isso em processo: seis etapas de entrega, uma área de manutenção e três rotas com consequências diferentes para site novo, base existente ou site pronto pra publicar.
Separe cerca de 45 minutos para ler e configurar o workspace. Executar a rota completa leva de 5,5 a 8,5 horas quando conteúdo e imagens precisam ser organizados; a rota de publicação leva de 1,5 a 2,5 horas se a verificação não revelar falhas. Tudo o que você marcar fica salvo neste navegador, sem cadastro.
Antes de entrar, tenha acesso de administrador ao computador, conta no GitHub (o serviço que guarda a pasta e o histórico do projeto), conta no Netlify (o serviço que publica o site na internet), acesso pago ao Claude Code ou créditos de API, a forma técnica de pagar pelo uso conforme o consumo, e a pasta do seu projeto. Se vai começar do zero, leve também conteúdo de pelo menos dois projetos. O workspace não inventa case, resultado nem responsabilidade que você não forneceu.
Guia verificado em 6 de agosto de 2026. O GitHub Free oferece quantidade ilimitada de repositórios públicos e privados, as pastas de projeto guardadas com histórico, e bloqueia arquivos acima de 100 MB. Contas novas do Netlify Free recebem 300 créditos mensais; cada deploy de produção, a publicação de uma nova versão, usa 15 créditos, cada GB de banda, um gigabyte de dados entregue aos visitantes, usa 20 e o site pausa sem cobrança ao esgotar. O Claude Code exige plano pago da Anthropic, a partir do Pro, ou créditos de API. O plano gratuito do Claude não inclui a ferramenta. As fontes oficiais mandam se os valores mudarem.
Do conteúdo cru ao portfólio no ar
Seis etapas de entrega e uma de manutenção, cada uma com objetivo, prompt e critério de validação. Resultado esperado: um site seu, publicado num endereço que qualquer pessoa consegue abrir na internet, com um recibo do que foi verificado. Seu progresso fica salvo neste navegador, sem cadastro.
De onde você está partindo?
Rota: quero construir um site novo
Ainda não tenho código ou quero recomeçar numa pasta vazia.
Você começa pela etapa 1
Tempo de execução estimado: 5,5 a 8,5 horas, normalmente divididas em dois blocos.
Tenha em mãos
- Conteúdo de pelo menos dois projetos ou tempo reservado pra organizá-lo
- Acesso de administrador ao computador pra instalar ferramentas
Risco principal
Começar pelo visual e deixar o Claude preencher lacunas com conteúdo genérico.
Rota: tenho um site ou template
Quero preservar, corrigir ou adaptar uma base que já existe.
Você começa pela etapa 2
Tempo de execução estimado: 4 a 7 horas, conforme o estado e a complexidade da base.
Tenha em mãos
- Pasta local do projeto e permissão de uso do template, quando houver
- Uma cópia segura ou histórico em Git antes da primeira alteração
Risco principal
Sobrescrever código útil, remover dependências necessárias ou violar a licença do template.
Rota: meu site está pronto
Quero verificar a base e publicar no GitHub e no Netlify.
Você começa pela etapa 2
Tempo de execução estimado: 1,5 a 2,5 horas, se a verificação não revelar falhas.
Tenha em mãos
- Site abrindo localmente e conteúdo final revisado
- Acesso às contas do GitHub e do Netlify
Risco principal
Enviar credenciais, escolher o repositório errado ou publicar uma build que só funciona localmente.
Glossário rápido dos termos que este guia usa
- Terminal
- A janela onde você digita instruções de texto pro computador. É por onde o Claude Code trabalha.
- Git
- O sistema que registra versões dos arquivos na sua máquina.
- URL
- O endereço exato de uma página na internet.
- Repositório
- A pasta do projeto hospedada no GitHub, com as versões registradas em commits.
- Commit
- Um ponto de salvamento com descrição. Cada commit é uma versão à qual dá pra voltar.
- Push
- Enviar seus commits da sua máquina pro GitHub.
- Build
- O processo que transforma o código na versão final do site.
- Deploy
- Publicar: pegar o build e disponibilizar na internet, numa URL.
- Framework
- Kit pronto de estrutura de código (Next.js, Astro). O Claude escolhe e justifica; você não precisa dominar.
- Domínio
- O endereço do site (seunome.com). Começa com um endereço gratuito do Netlify; domínio próprio é compra à parte.
- API
- A interface técnica usada por programas para conversar entre si. Créditos de API pagam esse uso conforme o consumo.
- Token de acesso
- Chave de acesso em formato de texto. Funciona como senha: nunca entra em código, repositório ou print.
- MCP
- Ponte padronizada entre a IA e serviços externos (com sua autorização). Opcional neste fluxo inteiro.
- Variável de ambiente
- Configuração que vive fora do código (ex: uma chave), definida na sua máquina ou no painel do Netlify.
- SEO
- Dados e estrutura que ajudam buscadores e cartões de compartilhamento a entender uma página.
- Open Graph
- Dados usados para montar o cartão de uma página quando o link é compartilhado.
- Sitemap
- Arquivo que lista as páginas públicas do site para mecanismos de busca.
- Favicon
- O pequeno ícone que identifica o site na aba do navegador.
- GB de banda
- Um gigabyte de dados entregue pelo site aos visitantes.
Progresso
0 de 6 etapas validadas na sua rota
Etapa 1 de 7 · 1 a 2 h · opcional na sua rota
Conteúdo
Objetivo: separar bio, projetos, imagens e contato antes de abrir qualquer ferramenta.
Por que importa: é a única parte que nenhuma IA faz por você. Conteúdo pronto evita rodadas desnecessárias e tende a consumir menos limite de uso: o Claude não precisa voltar pra perguntar o que escrever.
Ação
Crie uma pasta pro projeto, copie o checklist abaixo para um arquivo chamado CONTEUDO.md dentro dela e preencha. Não precisa ficar perfeito. Precisa existir no lugar que o Claude vai ler durante a construção.
Remova credenciais, dados pessoais de terceiros, nomes protegidos e qualquer material coberto por acordo de confidencialidade. Troque detalhes sensíveis por [CONFIDENCIAL].
PREPARAÇÃO DE CONTEÚDO Identidade [ ] Nome como quero aparecer [ ] Título profissional em uma linha [ ] Bio curta: 3 a 5 frases [ ] Foto ou imagem de apresentação [ ] Email profissional [ ] Links: LinkedIn e o que mais fizer sentido Trajetória [ ] Experiências principais: empresa, cargo, período, uma linha do que fiz [ ] Formação relevante Projetos (2 a 4) Para cada um: [ ] Nome + uma frase de resumo [ ] Imagem de capa [ ] Contexto (produto, empresa ou estudo, momento) [ ] Problema que existia [ ] Minha responsabilidade específica [ ] 2 ou 3 decisões importantes e o porquê [ ] Resultado com fonte, ou aprendizado honesto [ ] 3 a 6 imagens de processo ou solução Direção [ ] 3 referências visuais (links) [ ] O que quero delas e o que NÃO quero
Ainda não tem conteúdo? Abra o kit inicial
Três ferramentas pra sair do zero. Nenhuma inventa nada por você: elas puxam o que já está na sua memória e na sua pasta de projetos antigos.
Sou [NOME], [TÍTULO] com [X anos ou "experiência em"] [ÁREA]. Trabalho principalmente com [TIPO DE PRODUTO OU PROBLEMA]. Me interessa [O QUE TE MOVE NO DESIGN, uma frase concreta]. No momento, busco [OPORTUNIDADE].
Sobre aquele projeto que você lembra mas não documentou: 1. Qual era o produto e pra quem? 2. O que estava quebrado ou faltando quando você chegou? 3. O que VOCÊ fez, especificamente? (não o time: você) 4. Qual decisão gerou discussão? Como se resolveu? 5. O que mudou depois que entregou? (número, feedback, consequência) 6. Que imagem, print ou arquivo ainda existe disso?
Vou colar notas soltas sobre um projeto meu. Organize no formato: resumo, contexto, desafio, minha responsabilidade, decisões, resultado. Use somente o que está nas notas: não invente nada. O que faltar vira [FALTA: o quê]. No final, me faça as 3 perguntas que mais fortaleceriam o case. Notas: [COLE AQUI]
Um item de decisão bem escrito soa assim: "Optei por fluxo de cadastro em 2 telas em vez de 5 porque o funil mostrava 60% de abandono na tela 3; negociei com o time de dados a coleta progressiva depois do primeiro login". Esse exemplo é inventado e serve só de régua de especificidade: o seu precisa ser verdadeiro.
Funcionou se
Etapa validada.
Problema mais comum
Travar buscando o projeto perfeito. Dois projetos honestos e bem contados valem mais que quatro pela metade. Escolha os dois que você defenderia numa entrevista e siga em frente: dá pra adicionar o terceiro com um prompt de manutenção depois.
Etapa 2 de 7 · ~30 min · opcional na sua rota
Contas e ambiente
Objetivo: Claude Code instalado, contas GitHub e Netlify criadas, cada peça testada.
Por que importa: erro de ambiente descoberto agora custa minutos; descoberto no meio da construção, custa a tarde.
GitHub Free (abre em nova aba): repositórios públicos e privados ilimitados; arquivos acima de 100 MB são bloqueados (abre em nova aba). Netlify Free (abre em nova aba): contas novas recebem 300 créditos por mês; cada deploy de produção usa 15 e cada GB de banda usa 20. Ao esgotar, o site pausa sem cobrança. Claude Code (abre em nova aba): exige plano pago, a partir do Pro, ou créditos de API. O plano gratuito do Claude não inclui.
Ação 1: contas
- Criar ou acessar conta no GitHub (abre em nova aba)
- Criar ou acessar conta no Netlify (abre em nova aba) (dá pra entrar com a conta do GitHub, o que já deixa os dois conectados)
Ação 2: instalar o Claude Code
Abra o Terminal (Cmd + Espaço, digite "Terminal") e cole:
curl -fsSL https://claude.ai/install.sh | bash
Abra o PowerShell (menu Iniciar, digite "PowerShell") e cole:
irm https://claude.ai/install.ps1 | iex
O instalador nativo oficial não exige Node.js. Depois, confirme que instalou:
claude --version
Este fluxo também usa Git, o sistema que registra versões. Confira antes de começar:
git --version
Comandos conferidos na documentação oficial de instalação (abre em nova aba) em agosto de 2026; se algo divergir, a documentação manda.
O modo padrão pode executar ações de leitura sem pedir confirmação a cada uma. Para inspecionar e planejar sem editar arquivos, inicie a primeira sessão assim:
claude --permission-mode plan
Durante uma sessão, Esc interrompe a ação atual e /rewind abre o histórico de etapas pra voltar a um estado anterior. Esses controles ajudam, mas não substituem commits revisados no Git.
E o MCP? Preciso conectar alguma coisa?
Não precisa. MCP é a ponte que deixa o Claude operar serviços externos (como o Netlify) direto, com a sua autorização. É opcional: o Claude Code conversa com GitHub e Netlify pelo terminal sem ponte nenhuma, e este guia funciona inteiro assim.
Se quiser ligar a ponte do Netlify mesmo assim, use o guia oficial do Netlify pra Claude Code (abre em nova aba). A autenticação é por login autorizado no navegador. Nunca cole token ou senha em arquivo do projeto, código ou print.
Funcionou se
Etapa validada.
Problema mais comum
"Comando não encontrado" depois de instalar: feche o terminal por completo e abra de novo (a instalação só registra o comando em janelas novas). Se persistir, cole a mensagem de erro no chat do Claude no navegador e peça o diagnóstico: vale usar a IA pra destravar a instalação da própria IA.
Etapa 3 de 7 · ~30 min · opcional na sua rota
Briefing e plano
Objetivo: CONTEUDO.md e BRIEFING.md preenchidos, um plano aprovado no chat e a versão final salva em PLANO.md.
Por que importa: um briefing específico tende a consumir menos limite de uso que uma conversa caótica com cinquenta correções, e o plano é sua primeira etapa de revisão: corrigir rumo em texto custa uma frase.
Diagnóstico antes de publicar
Objetivo: um diagnóstico de publicação revisado, sem alterar nem enviar nada.
Por que importa: a verificação separa um site pronto na sua máquina de um site seguro pra enviar: destino, build, arquivos grandes e credenciais precisam estar explícitos antes da publicação.
Ação 1: gere seu prompt inicial
O CONTEUDO.md da etapa 1 continua como fonte. Aqui, o gerador cria BRIEFING.md e o prompt de diagnóstico sem sobrescrever sua matéria-prima. Nada do que você digita é enviado, salvo ou processado por IA.
Como esta rota pode ter pulado a preparação, o gerador cria CONTEUDO.md, BRIEFING.md e o prompt de diagnóstico. Nada do que você digita é enviado, salvo ou processado por IA.
Não cole credenciais, dados pessoais de terceiros, nomes protegidos nem material coberto por acordo de confidencialidade. Troque detalhes sensíveis por [CONFIDENCIAL] antes de preencher.
Refinar a direção visual
Três adjetivos valem mais que um parágrafo
Nome ou código. Em branco, a decisão fica aberta no briefing.
Links e o critério que você quer aproveitar de cada um
Crie esse arquivo dentro da pasta do projeto. Ele mantém a matéria-prima real separada das decisões de estrutura e direção.
Salve o briefing na mesma pasta de CONTEUDO.md. O Claude poderá reler os dois em outra sessão, sem depender da memória da conversa.
Campo vazio vira [PREENCHER] de propósito. Troque o que faltar e confirme que o prompt manda parar antes de implementar. O plano é uma proposta. A aprovação continua sendo sua.
Complemento: direção visual em dez respostas
Cole no seu BRIEFING.md e responda. É o que dá critério visual ao Claude em vez do gosto médio da internet.
DIREÇÃO VISUAL 1. Três adjetivos que o site deve transmitir: [ ] 2. Três referências e o que aproveitar de cada uma: [ ] 3. Animação: nenhuma, sutil ou presente? [ ] 4. Densidade: arejada ou compacta? [ ] 5. Contraste: suave ou marcado? [ ] 6. Cor principal e por quê: [ ] 7. Fonte: com serifa, sem serifa ou uma de cada? [ ] 8. Fotografia real, ilustração ou nenhuma? [ ] 9. O que o visitante deve sentir em 5 segundos: [ ] 10. O que o site NÃO pode parecer de jeito nenhum: [ ]
Ação 2: planeje no chat
Crie uma pasta pro projeto e abra o terminal dentro dela: digite cd seguido de um espaço, arraste a pasta pra dentro da janela do terminal (o caminho se preenche sozinho) e aperte Enter. Depois rode claude --permission-mode plan. Confirme que CONTEUDO.md e BRIEFING.md estão nessa pasta, depois cole o diagnóstico gerado. O Claude deve ler os dois arquivos, devolver o plano no chat e parar sem criar nem alterar arquivos.
Abra a pasta do projeto existente e abra o terminal dentro dela: digite cd seguido de um espaço, arraste a pasta pra dentro da janela do terminal (o caminho se preenche sozinho) e aperte Enter. Depois rode claude --permission-mode plan. Confirme que CONTEUDO.md e BRIEFING.md estão nessa pasta, depois cole o diagnóstico gerado. O Claude deve ler os dois arquivos, devolver o plano no chat e parar sem criar nem alterar arquivos.
Esse é o momento mais barato de todo o processo pra mudar de ideia. Se o plano propõe cinco páginas e você pediu uma, corrija agora, em português: "refaça o plano com uma página só".
Ação 3: salve o plano aprovado
Quando o plano estiver certo, pressione Shift+Tab até voltar ao modo padrão, no qual alterações pedem aprovação. Só então cole este prompt. Ele salva a versão aprovada em PLANO.md sem começar a construção.
Saí do modo de planejamento e aprovei o plano apresentado no chat. Salve exatamente esse plano em um arquivo chamado PLANO.md dentro da pasta atual. Não implemente nenhuma etapa, não instale nada e não altere outro arquivo. Ao terminar, informe apenas o caminho do PLANO.md criado e pare.
Funcionou se
Etapa validada.
Problema mais comum
Aprovar o plano sem ler, "porque a IA sabe o que está fazendo". Ela sabe construir; o que construir é decisão sua. Muitos problemas caros das próximas etapas começam num plano aprovado no piloto automático.
Ação: diagnostique sem alterar
Abra o terminal na pasta do site, inicie o Claude Code em Plan Mode, o modo de planejamento que permite inspecionar sem editar, e cole o diagnóstico abaixo. Ele deve devolver as evidências no chat e parar antes de qualquer envio.
Você vai fazer a verificação de um site pronto antes da publicação. 1. Confirme a pasta atual, a base técnica e o comando de build existente. 2. Verifique o estado do Git, arquivos acima de 100 MB, arquivos .env, credenciais e dados pessoais. Não repita nenhum segredo. 3. Identifique o comando de build já definido, mas não o execute nesta etapa de leitura. 4. Liste a pasta de publicação, as variáveis de ambiente apenas pelo nome e as rotas que precisam ser abertas. 5. Mostre o repositório do GitHub e o site do Netlify que pretende usar como destino e aguarde minha confirmação. Não altere o código, não crie arquivos, não instale nada e não faça envio nem deploy. Devolva o diagnóstico no chat e pare.
O diagnóstico precisa mostrar a pasta atual, o repositório do GitHub e o site do Netlify que pretende usar. Um destino ambíguo não é detalhe. É motivo pra parar.
Funcionou se
Etapa validada.
Problema mais comum
Ler um build verde como autorização de publicação. O build prova que o projeto foi montado; não prova que o destino está certo nem que o repositório está livre de dados que não deveriam sair da sua máquina.
Etapa 4 de 7 · 2 a 4 h · opcional na sua rota
Construção
Objetivo: o escopo aprovado implementado em etapas fechadas, com sua revisão entre elas.
Por que importa: prompts com escopo limitado evitam o efeito 'pedi um ajuste no rodapé, recebi um site redesenhado' e mantêm o consumo de uso sob controle: se o limite acabar, o progresso está salvo nos arquivos e você continua na sessão seguinte.
Rode um prompt por vez. Entre um e outro, abra o site no navegador e revise. O padrão dos seis: objetivo declarado, escopo limitado, reutilizar o que existe, proibir o resto, validar antes de concluir.
A regra de ouro da etapa
Faça assim
Um prompt, uma revisão sua no navegador, o próximo prompt.
Evite
Colar os seis prompts de uma vez e voltar em uma hora pra ver no que deu.
Execute esta etapa apenas se a fundação visual estiver no PLANO.md aprovado. Implemente tipografia, escala de espaçamento, cores com contraste adequado, grid e navegação. Use o BRIEFING.md como fonte das decisões visuais. Preserve toda estrutura existente que o plano não colocou no escopo. Não crie conteúdo nem páginas além do esqueleto de navegação. Não altere arquivos fora do projeto. Ao terminar, rode o projeto localmente e informe a URL exata pra abrir no navegador. Não avance pra próxima etapa. Ao terminar, entregue um recibo curto com: - arquivos alterados; - comando de verificação executado e código de saída, o número que indica sucesso ou falha; - o que você verificou no navegador; - o que não conseguiu verificar e ainda depende de revisão humana.
Execute esta etapa apenas se a página inicial estiver no PLANO.md aprovado. Implemente a página com o conteúdo real de BRIEFING.md e CONTEUDO.md: apresentação, projetos em destaque, resumo de experiência e contato. Não invente texto, número, cargo ou resultado. Onde faltar conteúdo, insira [PREENCHER] e liste todos os marcadores no final. Reutilize a fundação visual pronta. Preserve toda estrutura existente que o plano não colocou no escopo. Não altere tipografia nem cores. Abra a página no navegador e verifique navegação, conteúdo e erros no console, a área que mostra mensagens técnicas do site. Ao terminar, entregue um recibo curto com: - arquivos alterados; - comando de verificação executado e código de saída, o número que indica sucesso ou falha; - o que você verificou no navegador; - o que não conseguiu verificar e ainda depende de revisão humana.
Execute esta etapa apenas se projetos estiverem no PLANO.md aprovado. Leia BRIEFING.md, CONTEUDO.md e a arquitetura aprovada no plano. Se o plano define página única, crie ou complete a seção de projetos e estudos de caso nessa mesma página. Se define arquitetura completa, crie a listagem e as páginas individuais previstas. Use estas seções quando houver material: resumo, contexto, desafio, minha responsabilidade, decisões, evidências e resultado. Preencha apenas com o conteúdo de CONTEUDO.md. Texto que não existe vira [PREENCHER], nunca invenção. Preserve toda estrutura existente que o plano não colocou no escopo. Não altere a fundação visual. No final, liste as seções ou páginas criadas, os endereços de acesso e os marcadores pendentes. Ao terminar, entregue um recibo curto com: - arquivos alterados; - comando de verificação executado e código de saída, o número que indica sucesso ou falha; - o que você verificou no navegador; - o que não conseguiu verificar e ainda depende de revisão humana.
Revise o site inteiro em três larguras de tela: 375 px, 768 px e 1280 px. Corrija apenas problemas de layout, sem redesenhar. Faça uma revisão de acessibilidade: navegação por teclado, foco visível, contraste, texto alternativo em imagens, hierarquia correta de títulos e respeito a prefers-reduced-motion, a preferência do sistema por menos animação. Não declare que um leitor de tela foi testado se você não tiver executado esse teste. Ao terminar, entregue um recibo curto com: - arquivos alterados; - comando de verificação executado e código de saída, o número que indica sucesso ou falha; - o que você verificou no navegador; - o que não conseguiu verificar e ainda depende de revisão humana.
Configure o básico de SEO, o conjunto de dados que ajuda buscadores e cartões de compartilhamento a entender o site, sem instalar dependências novas. Inclua título e descrição únicos por página, Open Graph para o cartão de preview, sitemap.xml para listar as páginas, favicon para o ícone da aba e URLs limpas. Aponte textos confusos ou genéricos, mas não os reescreva sem me mostrar antes. Ao terminar, entregue um recibo curto com: - arquivos alterados; - comando de verificação executado e código de saída, o número que indica sucesso ou falha; - o que você verificou no navegador; - o que não conseguiu verificar e ainda depende de revisão humana.
Rode o build de produção, a geração da versão final do site, e corrija apenas erros causados ou pertencentes a este projeto. Depois verifique links quebrados, imagens ausentes, marcadores [PREENCHER], páginas órfãs e erros no console do navegador. Não adicione nenhuma funcionalidade nova. Se encontrar um problema fora do escopo ou não relacionado, pare e reporte antes de mudar. Entregue um recibo de prontidão com: 1. comando executado e código de saída; 2. rotas verificadas e resultado de cada uma; 3. larguras de tela abertas no navegador; 4. erros de console encontrados; 5. pendências que dependem de mim; 6. qualquer item que não conseguiu verificar. Não trate ausência de teste como aprovação.
Funcionou se
Etapa validada.
Problema mais comum
O Claude "melhorar" coisas que você não pediu. Não brigue: reforce o escopo. "Você alterou X e eu não pedi. Desfaça só isso e mantenha o resto". Depois, confira a lista de arquivos alterados e o resultado no navegador.
Etapa 5 de 7 · ~1 h · opcional na sua rota
Revisão
Objetivo: passar o site pelas cinco lentes que separam 'no ar' de 'pronto': conteúdo, experiência, acessibilidade, desempenho, SEO.
Por que importa: o prompt 7 audita o que é automatizável; esta etapa cobre o que só olho humano pega, tipo um case que tecnicamente funciona mas não convence.
Antes da revisão humana: prove o build
O diagnóstico anterior aconteceu em Plan Mode. Pressione Shift+Tab até voltar ao modo padrão, depois rode o prompt 7. Ele executa o build de produção e separa o que foi verificado do que ainda depende de você, sem publicar nada.
Rode o build de produção, a geração da versão final do site, e corrija apenas erros causados ou pertencentes a este projeto. Depois verifique links quebrados, imagens ausentes, marcadores [PREENCHER], páginas órfãs e erros no console do navegador. Não adicione nenhuma funcionalidade nova. Se encontrar um problema fora do escopo ou não relacionado, pare e reporte antes de mudar. Entregue um recibo de prontidão com: 1. comando executado e código de saída; 2. rotas verificadas e resultado de cada uma; 3. larguras de tela abertas no navegador; 4. erros de console encontrados; 5. pendências que dependem de mim; 6. qualquer item que não conseguiu verificar. Não trate ausência de teste como aprovação.
Revisão de qualidade
Marque apenas o que você verificou.
Conteúdo Completa
Experiência Completa
Acessibilidade Completa
Desempenho Completa
SEO e compartilhamento Completa
Etapa validada.
Problema mais comum
Marcar "acessibilidade ok" sem testar. O teste mínimo honesto: desligue o mouse e navegue o site inteiro com Tab e Enter. Se você se perder ou o foco sumir, seu visitante também vai. Leve o problema pro Claude com o prompt de acessibilidade da etapa de manutenção.
Etapa 6 de 7 · ~30 min · opcional na sua rota
Publicação
Objetivo: repositório no GitHub conectado ao Netlify, primeiro deploy verde, URL pública no ar.
Por que importa: se a publicação contínua, a conexão que refaz o site a cada envio ao GitHub, estiver configurada, cada atualização futura pode acionar uma nova publicação. É o circuito que mantém o portfólio atualizável.
- Vocêdecide e revisa
- Claude Codelê, cria e testa
- Arquivos locaiso site no seu computador
- GitHubguarda o histórico
- Netlifycompila e hospeda
- Site no arsua URL pública
Ação 1: valide a revisão
Antes de conectar no Netlify, revise os destinos e rode a validação:
Vou conectar este projeto ao Netlify. Me responda: 1. Confirme a pasta atual, o repositório do GitHub e o site de destino no Netlify. Pare se algum destino for ambíguo. 2. Qual é o comando de build e qual pasta contém o site pronto? 3. Rode o build de produção local e reporte o comando e o código de saída. 4. Alguma variável de ambiente é necessária? Liste só os nomes, nunca os valores. 5. Algo depende de uma versão específica do Node, o programa que executa a montagem de muitos sites? Mostre onde está definido. 6. Liste as rotas que eu preciso abrir depois do deploy. Se encontrar problema, reporte a causa e a correção proposta. Não altere nem envie nada antes da minha confirmação.
Ação 2: publique com confirmação
Depois de ler a validação e resolver qualquer pendência, use o prompt de publicação. Ele exige confirmação dos destinos antes de cada envio.
Prepare o projeto pra publicação. Confira se o .gitignore, o arquivo que impede o envio de itens locais, exclui node_modules, a pasta de pacotes instalados, arquivos .env de configuração local e qualquer credencial. Revise os arquivos procurando segredos ou dados pessoais que não devem ser públicos. Se encontrar uma credencial, informe o tipo e o arquivo, sem repetir o valor. Confirme a pasta atual, o repositório do GitHub e o site de destino no Netlify. Mostre os três destinos e espere minha confirmação. Depois me guie, um passo de cada vez, para registrar a versão em Git, enviar ao GitHub e conectar o repositório ao Netlify. Espere minha confirmação antes de cada envio. Nunca desative proteções, nunca exponha valores de variáveis de ambiente e nunca publique em outro destino por suposição. Ao terminar, entregue um recibo curto com: - arquivos alterados; - comando de verificação executado e código de saída, o número que indica sucesso ou falha; - o que você verificou no navegador; - o que não conseguiu verificar e ainda depende de revisão humana.
No Netlify: Add new project, importar do GitHub, escolher o repositório, conferir os dois campos que a validação te deu (comando de build e pasta de publicação) e confirmar. O Netlify mostra o estado da tentativa e, quando terminar, entrega a URL pública. Abra essa URL antes de considerar a publicação concluída.
Deu errado? Os 8 problemas clássicos e o conserto de cada um
O build falhou no Netlify
Abra o log do deploy, o registro textual da tentativa, e localize o primeiro erro. Antes de copiar, apague tokens, valores de variáveis, emails e dados pessoais.
O deploy no Netlify falhou. Base técnica: [INFORME]. Primeiro erro do log, já sem credenciais ou dados pessoais: [COLE]. Diagnostique a causa antes de editar, explique em linguagem simples e proponha a menor correção. Aguarde minha aprovação.
A página abre em branco
Abra o console do navegador, a área de mensagens técnicas em Inspecionar, e localize o primeiro erro. Remova qualquer dado sensível antes de copiar.
O site publicou mas abre em branco. Base técnica: [INFORME]. Primeiro erro do console, já sem dados sensíveis: [COLE]. Identifique a causa antes de editar e proponha a menor correção. Aguarde minha aprovação.
Uma rota funciona na home, mas dá 404 ao recarregar
Esse sintoma pode vir da estratégia de geração de páginas ou da configuração de rotas. Descubra qual delas o projeto usa antes de adicionar redirecionamentos.
A rota [URL] abre pela navegação, mas dá 404 ao recarregar no Netlify. Identifique a base técnica e se o projeto usa páginas estáticas, geradas antes da visita, renderização no servidor, gerada a cada pedido, ou página única. Diagnostique a causa e mostre a correção proposta antes de editar.
Imagens não carregam no site publicado
Compare o endereço pedido pelo navegador com o nome e a localização reais do arquivo. Maiúsculas, pasta pública e configuração de imagem são hipóteses, não diagnóstico.
A imagem [URL] funciona localmente mas não no site publicado. Verifique o pedido de rede, o caminho, maiúsculas no nome, pasta pública e configuração da base técnica. Diga qual hipótese foi provada antes de corrigir.
Erro citando variável de ambiente ausente
Configuração que existe na sua máquina mas não no Netlify. Adicione no painel: Site configuration, Environment variables. Nunca resolva colando o valor no código.
O build reclama de variável de ambiente ausente: [NOME]. Me diga pra que ela serve, onde configurá-la no Netlify e confirme que o valor não está escrito em nenhum arquivo do repositório.
Erro de versão do Node
Node é o programa que executa a montagem de muitos sites. Compare a versão local, a exigida pelo projeto e a usada no Netlify antes de fixar qualquer número.
O deploy indica versão do Node incompatível: [ERRO]. Compare a versão local, package.json, o arquivo que lista pacotes e comandos do projeto, arquivos de configuração e o log do Netlify. Proponha onde registrar a versão compatível e aguarde minha aprovação.
Dependência ausente no build
Dependência é um pacote que o projeto usa. Descubra se ela está ausente da lista do projeto, se o nome está errado ou se o arquivo foi importado por engano.
O build no Netlify falha por módulo não encontrado: [NOME]. Verifique package.json, a lista de pacotes e comandos, o arquivo que fixa versões e a importação que falhou. Diga qual causa foi provada antes de instalar, remover ou alterar qualquer pacote.
Funciona na minha máquina, quebra em produção
Ambiente local e produção podem divergir em versão, configuração, arquivos e letras maiúsculas. Compare evidências antes de escolher uma causa.
O site funciona localmente mas quebra em produção: [DESCREVA]. Compare versão do Node, variáveis apenas pelos nomes, arquivos enviados, caminhos e log do Netlify. Teste uma hipótese por vez e só corrija a causa comprovada.
Funcionou se
Etapa validada.
Problema mais comum
Deploy verde, site com cara de quebrado: duas causas comuns são imagem com caminho errado e rota que dá 404 ao recarregar. Não escolha por palpite. Os dois sintomas estão no bloco de problemas aqui em cima, com um diagnóstico guiado.
Etapa 7 de 7 · contínua · opcional na sua rota
Manutenção
Objetivo: atualizar o site sem reconstruí-lo do zero: cada mudança é um prompt pequeno de escopo fechado.
Por que importa: portfólio desatualizado envelhece mal. Com o circuito montado, um projeto novo vira uma alteração pequena, revisável e publicada pelo mesmo caminho.
Os dez pedidos mais comuns do dia a dia, prontos pra copiar. O padrão de todos: alterar só o necessário, build verde antes de concluir.
Adicionar um projeto
Adicione um novo projeto usando o template de case existente. Conteúdo: [COLE]. Inclua na listagem e, se merecer, um destaque na home. Não altere os outros projetos nem o layout. Rode o build e confirme.
Atualizar a bio
Atualize minha bio em todos os lugares onde ela aparece pra: [NOVA BIO]. Não mude mais nada. Liste os arquivos alterados.
Trocar uma imagem
Substitua a imagem [QUAL, ONDE] por [NOVO ARQUIVO]. Otimize o peso, mantenha as dimensões do layout e confira o texto alternativo. Não toque em mais nada.
Atualizar o currículo ou experiência
Atualize a seção de experiência com: [MUDANÇA]. Mantenha o formato das entradas existentes. Me mostre a lista exata de alterações antes de finalizar.
Criar uma página nova
Crie uma página nova: [PROPÓSITO]. Reutilize a fundação visual e a navegação existentes. Adicione o link no menu. Não redesenhe nada do que já existe.
Corrigir um bug
Em [ONDE], acontece [O QUÊ] quando [AÇÃO]; deveria [COMPORTAMENTO ESPERADO]. Diagnostique a causa antes de mexer, corrija só o necessário e me diga o que era. Build verde antes de concluir.
Melhorar SEO
Faça uma revisão de SEO: títulos e descrições únicos, Open Graph, sitemap atualizado, links internos. Me devolva a lista do que mudou e por quê. Não altere o conteúdo visível sem me mostrar.
Revisar acessibilidade
Rode uma revisão de acessibilidade: teclado, foco visível, contraste, texto alternativo, hierarquia de títulos e preferência por menos movimento. Corrija o que for objetivo e me liste o que exige decisão minha.
Atualizar dependências
Atualize as dependências do projeto com segurança: uma de cada vez nas críticas, rodando o build entre elas. Se algo quebrar, reverta e me explique. No final, resumo do que subiu de versão.
Publicar uma nova versão
Revise as alterações desde o último commit (segredos, arquivos desnecessários), rode o build, prepare um commit descritivo e me guie no push. Confirmo o destino antes do envio.
Guia completo. O site é seu: a partir daqui, ele evolui no seu ritmo, um prompt de cada vez.
O método por trás do workspace
Este guia é a versão operacional de um argumento maior sobre trabalhar com IA sendo designer: o valor não está em decorar prompts, está em organizar contexto, limitar escopo e revisar com olho de dono. O resultado é um portfólio operável, cujo conteúdo você controla, cuja publicação você consegue explicar e cuja verificação você consegue provar. O raciocínio completo, com os quatro vícios do portfólio feito por IA e o modelo de estudo de caso que foge do formato escolar, está no artigo Como criar e publicar seu portfólio com Claude Code, mesmo sem saber programar.
Pra continuar dali:
- Biblioteca de prompts para designers: prompts de auditoria e geração pro dia a dia, além do portfólio
- Vocabulário de frontend para designers: os termos certos mudam a qualidade do que o agente gera
- Referências de design com IA: a biblioteca de referências citada no guia, por categoria
Continue lendo
Figma com Claude: MCP oficial remoto e opção local
Conecte o Figma ao Claude por MCP e peça auditorias de tokens, frames e variantes por prompt. Setup guiado em 5 passos, com checklist de validação em cada um.
Vocabulário de frontend para designers
134 termos de CSS, layout, acessibilidade e rendering organizados por camada do problema, com exemplos de prompt pra dirigir agentes de código.