# Resenha Itapoá - Gerenciador de Listas de Compras

<div align="center">

![Next.js][]![TypeScript][]![Prisma][]![Tailwind CSS][][![Licença][]](./LICENSE)

Uma aplicação moderna para gerenciamento de listas de compras colaborativas, construída com as mais recentes tecnologias web.[Demonstração ao Vivo](https://resenhaitapoa.com.br) • [Reportar Bug](https://github.com/seu-usuario/resenhaitapoa/issues) • [Solicitar Funcionalidade](https://github.com/seu-usuario/resenhaitapoa/issues)

</div>

## 📋 Índice

- [Sobre o Projeto](#-sobre-o-projeto)
- [Tecnologias](#-tecnologias)
- [Funcionalidades](#-funcionalidades)
- [Começando](#-começando)
- [Estrutura do Projeto](#-estrutura-do-projeto)
- [Otimizações](#-otimizações)
- [Contribuindo](#-contribuindo)
- [Licença](#-licença)
- [Contato](#-contato)

## 🚀 Sobre o Projeto

Resenha Itapoá é um gerenciador de listas de compras moderno e intuitivo, desenvolvido para facilitar a organização de compras colaborativas. Com foco em performance, acessibilidade e experiência do usuário, a aplicação permite criar e gerenciar listas de compras compartilháveis em tempo real.

### 🎯 Objetivos Principais

- Simplificar a gestão de listas de compras
- Permitir colaboração em tempo real
- Oferecer interface intuitiva e responsiva
- Garantir alta performance e acessibilidade

## 🛠 Tecnologias

O projeto foi desenvolvido com as seguintes tecnologias:

- **Framework**: [Next.js 14](https://nextjs.org/)
- **Linguagem**: [TypeScript](https://www.typescriptlang.org/)
- **Banco de Dados**: [Prisma](https://www.prisma.io/)
- **Estilização**: 
  - [Tailwind CSS](https://tailwindcss.com/)  - [Shadcn/ui](https://ui.shadcn.com/)
- **UI/UX**:
  - [Lucide Icons](https://lucide.dev/)  - [Tailwind Merge](https://github.com/dcastil/tailwind-merge)
  - [Class Variance Authority](https://cva.style/docs)
- **Temas**: [next-themes](https://github.com/pacocoursey/next-themes)

## ✨ Funcionalidades

- 📝 Criação e gerenciamento de listas de compras
- 🔄 Atualização em tempo real
- 🌓 Tema claro/escuro
- 📱 Design responsivo
- ⚡ Performance otimizada
- ♿ Acessibilidade aprimorada
- 🔍 SEO otimizado

## 🚦 Começando

### Pré-requisitos

- Node.js (versão 18 ou superior)
- pnpm (versão 8 ou superior)

### Instalação

1. Clone o repositório:
```bash
git clone https://github.com/seu-usuario/resenhaitapoa.git
cd resenhaitapoa```

2. Instale as dependências:```bash
pnpm install```

3. Configure as variáveis de ambiente:```bash
cp .env.example .env.local```

4. Execute as migrações do banco de dados:```bash
pnpm prisma migrate dev
```

5. Inicie o servidor de desenvolvimento:```bash
pnpm dev
```

## 📁 Estrutura do Projeto```
resenhaitapoa/
├── app/
│   ├── components/        # Componentes React reutilizáveis
│   ├── actions/          # Server Actions do Next.js
│   ├── providers/        # Providers da aplicação
│   └── layout.tsx        # Layout principal
├── components/
│   └── ui/              # Componentes UI reutilizáveis
├── lib/
│   └── utils.ts         # Utilitários e helpers
├── prisma/
│   └── schema.prisma    # Schema do banco de dados
├── public/              # Arquivos estáticos
└── styles/             # Estilos globais
```

## ⚡ Otimizações

- **Performance**:
  - Code splitting com dynamic imports
  - Componentes memoizados
  - Lazy loading de componentes não críticos  - Otimização de imagens  
- **SEO**:
  - Meta tags otimizadas
  - Schema.org markup  - Sitemap dinâmico
  - Progressive Web App ready

- **Core Web Vitals**:  - FCP otimizado  - LCP minimizado
  - CLS zero
  - TTI reduzido

## 🤝 Contribuindo

Contribuições são sempre bem-vindas! Para contribuir:

1. Faça um Fork do projeto
2. Crie uma Branch para sua feature (`git checkout -b feature/AmazingFeature`)
3. Commit suas mudanças (`git commit -m 'Add: Amazing Feature'`)
4. Push para a Branch (`git push origin feature/AmazingFeature`)
5. Abra um Pull Request

### Scripts Úteis

```bash
# Desenvolvimento
pnpm dev

# Build de produção
pnpm build

# Análise de bundle
pnpm analyze

# Limpar dependências não utilizadas
pnpm clean:deps

# Lint
pnpm lint
```

## 📄 Licença

Distribuído sob a licença MIT. Veja `LICENSE` para mais informações.

## 📫 Contato

Evandro - [evandro.dev.br](https://evandro.dev.br)

Link do Projeto: [https://github.com/seu-usuario/resenhaitapoa](https://github.com/seu-usuario/resenhaitapoa)

---<div align="center">
  Desenvolvido com ❤️ por <a href="https://evandro.dev.br">evandro.dev.br</a>
</div>

Quer que eu faça algum ajuste ou adicione mais alguma seção à documentação?