Lucas RayanandClaude Sonnet 5.5
4ad130a334
Drop the pull_request trigger (the branch push already validates the commit), drop the second npm run build from the lint job (the image build compiles it), and build the image on arm64 after the cheap checks pass. The CI publishes it as inputs-<hash>, so the merge to main only re-tags it. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
ESPDocs - Documentação ESP32 em Português
Documentação não oficial completa do ecossistema ESP32 em português brasileiro.
🚀 Funcionalidades
- 📚 Séries ESP32: Informações detalhadas sobre todas as séries de chips ESP32
- ⚡ Frameworks: Documentação de frameworks populares (ESP-IDF, Arduino, MicroPython, etc.)
- 📊 Comparação: Compare diferentes séries ESP32 lado a lado
- 🔌 Diagramas Interativos: Visualize conexões e componentes de forma interativa
- 💻 Exemplos de Código: Código de exemplo para diferentes frameworks
- 🛒 Catálogo de Placas: Encontre e filtre placas de desenvolvimento ESP32
🏁 Início Rápido
Instalação
# Clone o repositório
git clone https://git.lucasrguerra.dev.br/lucasrguerra/ESPDocs.git
# Entre no diretório
cd ESPDocs
# Instale as dependências
npm install
Configuração do Marketplace (Opcional)
# Copie o arquivo de exemplo
cp .env.local.example .env.local
# Edite o arquivo .env.local e adicione sua API Key do Google Sheets
# GOOGLE_SHEETS_API_KEY=sua_api_key_aqui
Executar em Desenvolvimento
npm run dev
Open http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying app/page.js. The page auto-updates as you edit the file.
This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.
📁 Estrutura do Projeto
ESPDocs/
├── app/
│ ├── api/
│ │ └── placas/
│ │ └── route.js # API do marketplace
│ ├── comparacao/
│ ├── frameworks/
│ ├── placas/ # Marketplace
│ │ └── page.jsx
│ ├── series/
│ ├── sobre/
│ └── page.jsx
├── components/
│ ├── BoardCard.jsx # Card de placa
│ ├── BoardFilters.jsx # Filtros (opcional)
│ ├── CodeExample.jsx
│ ├── ConnectionsDiagram.jsx
│ ├── Footer.jsx
│ ├── Header.jsx
│ └── SeriesTabMenu.jsx
├── public/
│ ├── frameworks.json
│ ├── series.json
│ ├── conexoes/
│ ├── exemplos/
│ └── placas/
├── .env.local.example # Exemplo de configuração
🛠️ Tecnologias
- Next.js 15: Framework React com App Router
- React 19: Biblioteca UI
- Tailwind CSS 4: Estilização
- Material-UI: Componentes
- Google Sheets API: Integração com planilhas
📚 Learn More
To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!
🚀 Deploy on Vercel
The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.
Importante: Ao fazer deploy, não esqueça de adicionar a variável de ambiente GOOGLE_SHEETS_API_KEY nas configurações do projeto na Vercel.
Check out our Next.js deployment documentation for more details.
📄 Licença
Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.
⚠️ Disclaimer
Este é um projeto de documentação não oficial e independente. Não possui nenhum tipo de afiliação com a Espressif Systems, fabricante dos chips ESP32.
👤 Autor
Lucas Rayan Guerra
- Website: Ciência Embarcada
- Gitea: @lucasrguerra
🤝 Contribuindo
Contribuições, issues e feature requests são bem-vindos!
Feito com ❤️ para a comunidade ESP32 brasileira