Skip to content

About

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Tech In Rio — Site institucional

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.

Stack

  • 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/.

Como rodar

Você precisa de Node.js 22.12 ou superior e do yarn.

yarn install
yarn dev

O 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)

Estrutura

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

Galeria

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.

Comunidade

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.

Deploy

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.

Documentação

Contribuindo

Toda contribuição é bem-vinda: entrar na comunidade, corrigir algo no site ou sugerir melhorias. Veja o CONTRIBUINDO.md.

Links

About

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages