minikit-limpo-template/template/README.md

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

# MiniKit Limpo Template

Um modelo inicial mínimo para aplicativos Next.js com integração WorldCoin MiniKit.

> **Nota:** Se você estiver vendo erros de TypeScript após a instalação, execute `npm install` para garantir que todas as dependências e suas declarações de tipo sejam instaladas corretamente.

## Recursos

- 🔑 **Integração MiniKit**: Autenticação simplificada com WorldCoin MiniKit
- 🌐 **Suporte i18n**: Pronto para múltiplos idiomas (Inglês, Espanhol, Português)
- 📱 **Amigável para Dispositivos Móveis**: Design responsivo com navegação móvel
- 🎨 **Tailwind CSS**: Para estilização e personalização fácil
- 🚀 **Next.js App Router**: Estrutura moderna de aplicativo Next.js

## Começando

### Variáveis de Ambiente

Crie um arquivo `.env.local` na raiz do seu projeto com:

```
NEXT_PUBLIC_APP_ID=app_...
```

Substitua `app_...` pelo seu World ID App ID do [World ID Developer Portal](https://developer.worldcoin.org/).

### Desenvolvimento

```bash
# Inicie o servidor de desenvolvimento
npm run dev
```

### Build

```bash
# Build for production
npm run build

# Start the production server
npm start
```

## Structure

- `/src/app`: Pages and API routes using Next.js App Router
- `/src/components`: Reusable React components
- `/src/locales`: Translations for multiple languages
- `/src/minikit-provider.tsx`: MiniKit initialization

## Authentication Flow

This template uses MiniKit for wallet authentication:

1. User clicks "Sign in with World App"
2. App fetches a nonce from the server
3. MiniKit requests wallet authentication with the nonce
4. On successful authentication, the user is redirected to the dashboard

## Customization

- Edit the pages in `/src/app` to customize the content
- Modify the TabBar component in `/src/components/TabBar.tsx` to change navigation
- Update translations in `/src/locales` for multilingual support

## License

MIT