minikit-limpo-template/README.md

A minimal Next.js app starter template with WorldCoin MiniKit authentication integration

# minikit-limpo-template

Um modelo inicial mínimo de aplicativo Next.js com integração de autenticação WorldCoin MiniKit.

## Recursos

- 🔐 **Autenticação MiniKit**: Autenticação segura de carteira com MiniKit JS
- 🌐 **Internacionalização**: Suporte integrado para múltiplos idiomas
- 🎨 **Tailwind CSS**: Para estilização e personalização fácil
- 🚀 **Next.js App Router**: Estrutura moderna de aplicativo Next.js

## Sobre os Erros de TypeScript

Se você estiver visualizando os arquivos brutos do modelo, verá erros de TypeScript relacionados a declarações de tipo ausentes. Isso é esperado e normal para um projeto de modelo. Esses erros serão resolvidos automaticamente quando você instalar o modelo usando o comando `npx`, que instala todas as dependências necessárias com suas declarações de tipo.

## Início Rápido

Crie um novo aplicativo MiniKit com:

```bash
npx minikit-limpo-template meu-app
cd meu-app
```

Defina seu WorldCoin App ID no arquivo `.env.local`.

```
NEXT_PUBLIC_APP_ID=app_SEU_APP_ID_AQUI
```

Em seguida, inicie o servidor de desenvolvimento:

```bash
npm run dev
```

Visite http://localhost:3000 para ver seu aplicativo.

## O que está Incluído

- **Página de Login**: Autenticação de carteira MiniKit
- **Dashboard**: Exibe o nome de usuário logado
- **Navegação por Abas**: Três páginas padrão com navegação inferior
- **Alternância de Idioma**: Suporte para inglês, espanhol e português
- **Design Responsivo**: Layout otimizado para dispositivos móveis

## Estrutura

- `/src/app`: Páginas e rotas da API
- `/src/components`: Componentes reutilizáveis
- `/src/locales`: Arquivos de tradução
- `/src/minikit-provider.tsx`: Integração com MiniKit

## Fluxo de Autenticação

1. O usuário clica em "Entrar com World App"
2. O aplicativo busca um nonce do servidor
3. MiniKit solicita autenticação de carteira com o nonce
4. Em caso de sucesso, o usuário é redirecionado para o dashboard

## Personalização

- Edite as páginas em `/src/app` para modificar o conteúdo
- Atualize o componente TabBar para navegação diferente
- Modifique as traduções em `/src/locales`
- Adicione seus próprios componentes e recursos

## Licença

MIT