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