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:

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:

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