convez.ai
AgenteUtilidadesIntermediário
Victorhumbert

D&D 5e — Gerenciador de Personagem

Victorhumbert/projetoD-D

Ficha digital D&D 5e com persistência local e cálculos automáticos

Ver no GitHub
InicialPluginScore · de 0 a 100

Aplicação web responsiva para criar e gerenciar fichas de personagem em Dungeons & Dragons 5a Edição, com persistência local, cálculos automáticos de atributos e perícias. Construída em Next.js 16 com TypeScript, Tailwind e Zustand, oferece abas para status, perícias, inventário e magias com validação de regras.

Instalação

$npx convez-ai Victorhumbert/projetoD-D

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Mestres e jogadores gerenciarem fichas de personagem entre sessões
  • Validação automática de modificadores, CA, iniciativa e slots de magia
  • Export/import de personagens em JSON para compartilhamento

Veredito

Projeto bem estruturado com regras D&D 5e corretamente implementadas e testes unitários. Embora seja um agent de teste do autor, demonstra domínio de Next.js, state management e design responsivo — aplicável como referência técnica ou MVP para ferramentas de tabuleiro digital.

README

A tradução para o português deste README ainda está na fila.

D&D 5e — Gerenciador de Personagem

Ficha digital de personagem para Dungeons & Dragons 5a Edição. Aplicação web responsiva com persistência local, sem backend.

Stack

  • Next.js 16 (App Router, SSR/SSG)
  • TypeScript estrito (strict: true, noUncheckedIndexedAccess: true)
  • Tailwind CSS v4 (tokens via @theme no globals.css)
  • Zustand (estado global por slices, debounce 500ms + flush em beforeunload)
  • Zod (disponível para validação de schema no import JSON)
  • Vitest (23 testes das funções de cálculo do domínio D&D)

Funcionalidades

  • Aba Status: atributos editáveis com modificadores calculados, bônus de proficiência, CA, iniciativa, deslocamento, PV com barra de cor dinâmica (verde/amarela/vermelha), testes de resistência, testes de morte
  • Aba Perícias: percepção passiva, 18 perícias com proficiência e especialidade (double prof), bônus calculados
  • Aba Inventário: CRUD de itens com modal, toggle de equipado, peso total
  • Aba Magias: slots de magia níveis 1-9 (clicáveis), caso especial Bruxo (Slots do Pacto — descanso curto), CD de magia e bônus de ataque calculados, magias agrupadas por nível (colapsáveis), habilidades de classe com tracker de usos
  • Export/Import JSON: serializa o personagem completo para download; importa com validação básica de campos
  • Personagem padrão: Tharivol Lúmen, Elfo da Floresta, Guerreiro nível 3 — carregado na primeira visita

Design

  • Tema escuro inspirado em pergaminho e pedra (fundo #0c0a09, acentos âmbar)
  • Responsivo: TabBar horizontal no desktop, bottom navigation no mobile
  • Modais viram bottom sheets em telas pequenas
  • Acessibilidade: HTML semântico, aria-label, role, aria-checked, aria-live, foco visível

Regras de negócio

  • NUNCA persiste valores calculados: modificadores, CD de magia, bônus de ataque e de perícia são sempre derivados na camada de render a partir dos valores brutos
  • Hydration gate: useHydration evita mismatch SSR/CSR ao ler o localStorage
  • Seletores granulares no Zustand: cada componente seleciona apenas o que precisa

Desenvolvimento

npm install
npm run dev        # http://localhost:3000
npm test           # Vitest (23 testes)
npm run build      # Build de produção

Estrutura

src/
├── app/                     # Rotas Next.js (App Router)
│   └── personagem/          # Abas: status, pericias, inventario, magias
├── components/
│   ├── ui/                  # Primitivos: Button, Input, Modal, Toggle, Card...
│   ├── status/              # AtributoCard, BarraVida, TestesMorte
│   ├── pericias/            # PericiaRow
│   ├── inventario/          # ItemCard, ItemForm
│   └── magias/              # SlotTracker, SpellCard, HabilidadeCard
├── domain/
│   ├── calc.ts              # Funções puras D&D 5e (testadas)
│   ├── constants.ts         # Configurações de perícias, atributos, XP
│   └── defaultCharacter.ts  # Tharivol Lúmen (personagem de exemplo)
├── store/                   # Zustand — slices + persistência
├── hooks/                   # useHydration
├── lib/                     # storage.ts, utils.ts
└── types/                   # character.ts (todos os tipos D&D)
Ver o original no GitHub

Bom para

Relacionados