vibeflow-n8n/docs/tutorial-subir-github.md

Tutorial: como subir o Vibeflow n8n no GitHub

Este guia foi feito para você publicar o projeto de forma prática, sem virar refém de um labirinto de menus.

Antes de começar

Tenha em mãos:

• uma conta no GitHub
• Git instalado no computador, se for usar terminal
• a pasta local do projeto ou o ZIP extraído
• um nome final para o repositório, por exemplo vibeflow-n8n

O GitHub permite criar um novo repositório pela interface web ou subir um projeto local pela linha de comando com GitHub CLI. A documentação oficial cobre os dois caminhos. citeturn863639search0turn863639search3turn863639search14

Caminho 1: subir pelo site do GitHub + Git local

1) Crie o repositório vazio

No GitHub:

• clique no canto superior direito em New repository
• escolha o nome do repositório, por exemplo vibeflow-n8n
• adicione uma descrição curta
• escolha Public
• não marque README, .gitignore ou licença, porque este projeto já contém esses arquivos
• clique em Create repository

Esses passos seguem o fluxo atual do GitHub para criação de repositórios. citeturn863639search0

2) Extraia o ZIP da V5 no seu computador

Descompacte o pacote em uma pasta local. Exemplo:

unzip n8n-workflow-skill-kit-v0.5.0.zip
cd n8n-workflow-skill-kit

3) Inicialize o Git localmente

Se a pasta ainda não for um repositório Git:

git init
git add .
git commit -m "feat: launch Vibeflow n8n v0.5.0"

4) Conecte ao repositório remoto

Copie a URL do seu repositório recém-criado e rode:

git branch -M main
git remote add origin https://github.com/SEU_USUARIO/vibeflow-n8n.git
git push -u origin main

A própria documentação do GitHub cobre o fluxo de adicionar código local a um repositório remoto. citeturn863639search9turn863639search19

Caminho 2: subir usando GitHub CLI

Se você usa gh, o caminho fica bem mais liso.

1) Entre na pasta do projeto

cd n8n-workflow-skill-kit

2) Inicialize e faça o primeiro commit

git init
git add .
git commit -m "feat: launch Vibeflow n8n v0.5.0"

3) Crie e publique com gh

gh repo create vibeflow-n8n --public --source=. --remote=origin --push

O GitHub CLI documenta esse fluxo oficialmente para criar um repositório e subir um projeto local existente. citeturn863639search3turn863639search14

Depois do push: arrumando a vitrine do repositório

1) Ajuste descrição e website

Na página principal do repositório:

• clique no ícone de engrenagem na área de About
• adicione a descrição
• opcionalmente, adicione um site ou link de demo

Sugestão de descrição:

Build complete n8n workflows through MCP with any coding agent.

2) Adicione topics

Topics ajudam o projeto a ser encontrado. O GitHub recomenda usá-los para classificar o repositório por assunto e finalidade. citeturn863639search5turn863639search11

Sugestão de topics:

n8n, mcp, automation, ai-agents, codex, claude-code, opencode, workflow-automation, vibe-coding

3) Configure a social preview

No GitHub:

• abra Settings
• procure a área Social preview
• envie uma imagem de capa

O GitHub suporta customização da imagem de preview social diretamente nas configurações do repositório. citeturn863639search2turn863639search8

4) Faça a primeira release

Na aba principal do repositório:

• clique em Releases
• clique em Draft a new release
• use a tag v0.5.0
• título sugerido: Vibeflow n8n v0.5.0
• cole as release notes com base em docs/release-notes-template.md
• publique

O fluxo de criação de release está documentado pelo GitHub na área de releases do repositório. citeturn863639search1

Ordem recomendada de publicação

Use esta sequência:

1. extraia o ZIP
2. ajuste nome final do projeto, se quiser
3. faça git init
4. commit inicial
5. crie o repo no GitHub
6. push da branch main
7. revise README e About
8. adicione topics
9. suba social preview
10. publique a release v0.5.0
11. compartilhe

Checklist de comando rápido

Via Git puro

cd n8n-workflow-skill-kit
git init
git add .
git commit -m "feat: launch Vibeflow n8n v0.5.0"
git branch -M main
git remote add origin https://github.com/SEU_USUARIO/vibeflow-n8n.git
git push -u origin main

Via GitHub CLI

cd n8n-workflow-skill-kit
git init
git add .
git commit -m "feat: launch Vibeflow n8n v0.5.0"
gh repo create vibeflow-n8n --public --source=. --remote=origin --push

Erros comuns

O GitHub rejeitou o push porque o repositório remoto já tinha arquivos

Isso normalmente acontece se você criou README ou .gitignore no GitHub na hora de criar o repositório. A saída mais limpa é criar outro repositório vazio, sem arquivos iniciais.

Subi arquivos sensíveis sem querer

Pare e remova imediatamente. O GitHub alerta para não commitar segredos ou credenciais em repositórios remotos. citeturn863639search4

O ZIP foi extraído com uma pasta a mais

Entre na pasta correta antes de rodar git init, senão você publica um matrioshka de diretórios.

Texto pronto para o About do repositório

Description

Build complete n8n workflows through MCP with any coding agent.

Website

Use seu futuro site, post, demo ou deixe em branco.

Topics

n8n
mcp
automation
ai-agents
workflow-automation
codex
claude-code
opencode
vibe-coding

Texto pronto para a primeira release

Tag

v0.5.0

Title

Vibeflow n8n v0.5.0

Summary

First public launch of Vibeflow n8n, a skill-first open-source kit for building complete n8n workflows through MCP with coding agents like Codex CLI, Claude Code, and OpenCode.