Código-fonte de www.techinrio.com.br, o site da Tech In Rio, a comunidade de tecnologia mais carioca de todo Brasil.
O site é o ponto de partida para conhecer a comunidade, as atividades e os eventos, e tem uma galeria com as fotos dos nossos eventos em /galeria/. A página de membros (/comunidade/) está pausada por enquanto.
- Astro 7, com geração estática e zero JavaScript por padrão
- CSS puro com custom properties (um CSS Module por componente)
- JavaScript vanilla, só onde não há alternativa (hoje, o menu mobile, o menu de compartilhar e o pop-up da galeria)
- Hospedagem no GitHub Pages, com deploy por GitHub Actions
Mantemos o mínimo de JavaScript e de bibliotecas possível. Além do Astro, só usamos satori e sharp para gerar, no build, o cartão de compartilhamento de cada membro. As decisões estão em docs/.
Você precisa de Node.js 22.12 ou superior e do yarn.
yarn install
yarn devO site abre em http://localhost:4321.
| Comando | O que faz |
|---|---|
yarn dev |
Servidor local com recarga automática |
yarn build |
Gera o site estático em dist/ (também valida os dados da comunidade) |
yarn preview |
Serve o build de dist/ localmente |
yarn generate:og |
Regenera a imagem de compartilhamento (public/img/og-image.jpg) |
src/
├── components/ seções e blocos das páginas
├── data/ metadados, canais e membros da comunidade (data/comunidade/)
├── layouts/ estrutura base das páginas
├── lib/ leitura e validação dos dados da comunidade e da galeria
├── pages/ rotas do site
└── styles/ estilos globais e um CSS Module por componente
public/ imagens e outros arquivos estáticos
scripts/ utilitários de desenvolvimento
docs/ documentação do projeto
.github/ workflows, templates e regras de revisão
As imagens são servidas de https://fotos.techinrio.com.br. O repositório guarda só o índice de cada evento (src/data/gallery/<slug>.json), ligado ao evento pelo slug em src/data/events.js. Detalhes em docs/spec.md e CONTRIBUINDO.md.
A página está pausada (fora do menu e do sitemap), mas os perfis seguem no repositório. Cada membro é um arquivo Markdown em src/data/comunidade/<nome-sobrenome>.md, com nome, cargo, foto, tags, links e um texto livre, e ganha uma página em /comunidade/<nome-sobrenome>/. Para criar ou alterar o seu perfil, abra uma Pull Request: na página da comunidade, o botão Criar meu perfil abre o editor do GitHub com um modelo. O passo a passo está em CONTRIBUINDO.md.
Cada merge na master roda o build no GitHub Actions e publica o resultado no GitHub Pages. Pull Requests rodam só o build e as validações, sem publicar.
docs/spec.md: especificação do sitedocs/brand/brand-reference.md: identidade visualdocs/boas-praticas.md: boas práticas de códigodocs/git-workflow.md: fluxo de Git, commits e Pull Requestsdocs/ADR-001-stack.md,docs/ADR-002-comunidade-e-github-pages.mdedocs/ADR-003-perfil-de-membro.md,docs/ADR-004-cartao-de-compartilhamento.mdedocs/ADR-005-galeria-de-fotos.md: decisões de arquitetura
Toda contribuição é bem-vinda: entrar na comunidade, corrigir algo no site ou sugerir melhorias. Veja o CONTRIBUINDO.md.