Saltar al contenido
Jefferson Gonçalves
← Volver a proyectos

Blog C3

Craft & Code Club - Blog! Our community blog, but you can also use it for your community or as your personal blog :)

#Craft & Code Club Blog

Este é o repositório do blog da comunidade Craft & Code Club, uma comunidade dedicada ao artesanato de software, onde compartilhamos conhecimento sobre Algoritmos, Estruturas de Dados, System Design, Engenharia de Software Moderna, Domain-Driven Design, Clean Architecture e outros tópicos avançados de desenvolvimento de software.

#🌟 Sobre a Comunidade

O Craft & Code Club é uma comunidade de desenvolvedores apaixonados por qualidade de código e boas práticas de desenvolvimento. Nosso objetivo é compartilhar conhecimento e experiências através de:

  • 📝 Artigos técnicos no blog
  • 🎥 Conteúdo no YouTube
  • 💬 Discussões no Discord
  • 🤝 Eventos e encontros
  • 📖 Clube do Livro

#:rocket: Faça parte da Comunidade

Link para participar no Discord:
https://craftcodeclub.io/join

#📋 Usando este Template

Este blog foi desenvolvido como um template open source, e você está convidado a usá-lo! Se você tem uma comunidade de tecnologia ou quer criar seu blog pessoal, sinta-se à vontade para fazer um fork e adaptar às suas necessidades.

#Como Usar

  1. Faça um fork deste repositório
  2. Personalize como quiser
  3. Os posts eventos são escritos em Markdown e ficam na pasta _content/

#🛠 Tecnologias Utilizadas

  • Next.js 15 - Framework React com suporte a SSG
  • TypeScript - Tipagem estática
  • Tailwind CSS - Estilização e design system
  • next-themes - Suporte a tema claro/escuro
  • remark - Renderização de Markdown
  • gray-matter - Parsing de frontmatter dos posts

#🚀 Como Executar

#Desenvolvimento Local

# Instalar dependências
npm install

# Executar em modo de desenvolvimento
npm run dev

O site estará disponível em http://localhost:3000

#Build Estático

Este blog usa exportação estática do Next.js, permitindo hospedagem em qualquer servidor estático:

# Gerar build estático
npm run build

# Os arquivos estáticos estarão na pasta 'out'

#Configuração

  1. Crie seus posts em Markdown na pasta _content/posts/
  2. Crie seus eventos em Markdown na pasta _content/events/
  3. Configure os metadados do site em src/app/layout.tsx
  4. Ajuste as cores e tema em tailwind.config.js
  5. Personalize os componentes e páginas em src/components/ e src/app/

#📝 Criando conteúdo

Para a ajudar na indexação e SEO, os posts e eventos devem seguir um formato específico dos slugs. O slug é a parte da URL que identifica o post ou evento. O slug deve ser escrito em letras minúsculas, com palavras separadas por hífens. Para manter a consistência, vamos também seguir um padrão de nomenclatura para os arquivos Markdown. A seguir, mostraremos cada um dos padrões de slug tanto para posts quanto para eventos.

#Posts

Os posts devem ser criados na pasta _content/posts/ seguindo o formato:

---
title: 'Título do Post'
date: '2024-03-20'
description: 'Descrição do post que aparecerá na listagem'
topics: ['tag1', 'tag2', 'tag3']
authors:
  - name: 'Nome do Autor'
    link: 'https://github.com/nomedautor'
---

Conteúdo do post em Markdown...

Mais exemplos de posts

#Slug

<context>-<titulo-do-post>

## Exemplo:

`dsa-dijkstra.md`
  • Algoritmos e Estruturas de Dados
    • ds-<titulo>.md
  • System Design
    • sd-<titulo>.md
    • sd-<titulo>-<parte>.md
  • Outros
    • <titulo>.md

#Eventos

Documentação completa de configuração de eventos:

#Roadmaps

Os roadmaps são recursos de aprendizado estruturados que ajudam a comunidade a navegar por tópicos complexos de forma organizada. Atualmente, temos o Roadmap de Algoritmos e Estruturas de Dados, hospedado em dsa.craftcodeclub.io.

#📍 Acessando o Roadmap

#🤝 Contribuindo

Contribuições são bem-vindas! Se você encontrou um bug ou tem uma sugestão de melhoria:

  1. Abra uma issue descrevendo o problema/sugestão
  2. Fork o repositório
  3. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
  4. Commit suas mudanças (git commit -m 'Adiciona nova feature')
  5. Push para a branch (git push origin feature/MinhaFeature)
  6. Abra um Pull Request
  7. Acompanhe o PR até fechar: responda os comentários de review, resolva as threads e deixe os checks verdes

#🤖 Trabalhando com agentes de IA

Este repositório traz skills em .agents/skills/, que agentes como o Claude Code carregam sozinhos quando a tarefa se encaixa.

Skill Quando roda
pr-watch Sempre que um PR é aberto, e quando pedirem para checar ou fechar comentários de PR
validacao-visual Quando precisa ver uma página renderizada: layout, quebra de texto, contraste, tema, mobile

Ao abrir um PR, a pr-watch é obrigatória. Ela cobre o ciclo até o fim: conferir comentários de review e checks de CI, verificar cada alegação antes de agir (bot erra), responder com evidência, resolver as threads e reportar. Alguns pontos que ela fixa:

  • todo comentário postado no PR começa com (Claude Code), para quem lê a thread saber que quem respondeu foi um agente;
  • comentar na thread antes de resolver, e depois citar o commit que endereçou o ponto, nunca resolver em silêncio;
  • comentário de bot pode ser fechado na hora; comentário de humano só depois de a pessoa concordar;
  • comentário que questiona o desenho da mudança, e não a implementação, volta para quem abriu o PR decidir.

#📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

Desenvolvido com 💙 pela comunidade Craft & Code Club

Nueva versión disponible.