Shadcn React Starter - React + Vite + Shadcn UI

Um boilerplate moderno e pronto para produção para construção de aplicações web, com foco em experiência do desenvolvedor, performance e acessibilidade.

🚀 Tecnologias

• Framework: React 19
• Ferramenta de Build: Vite 6
• Linguagem: TypeScript
• Estilização: Tailwind CSS
• Componentes UI: Shadcn UI (baseado em Radix UI)
• Roteamento: React Router 6
• Gerenciamento de Dados: TanStack Query v5
• Gerenciamento de Formulários: React Hook Form + Zod
• Ícones: Lucide React
• Notificações: Sonner

📂 Estrutura do Projeto

src/
├── components/     # Componentes de UI reutilizáveis (shadcn/ui + custom)
│   ├── ui/         # Componentes base do shadcn
├── hooks/          # Hooks customizados do React
├── lib/            # Funções utilitárias e configurações
├── pages/          # Páginas/rotas da aplicação
├── utils/          # Funções auxiliares
└── main.tsx        # Ponto de entrada da aplicação

🛠️ Primeiros Passos

Pré-requisitos

• Node.js (v18 ou superior recomendado)
• pnpm (gerenciador de pacotes preferencial)

Instalação

1. Clone o repositório:

   git clone <url-do-seu-repositorio>
   cd boilerplate

2. Instale as dependências:

   pnpm install

3. Inicie o servidor de desenvolvimento:

   pnpm dev

4. Build para produção:

   pnpm build

🎨 Funcionalidades

• Suporte a Dark Mode: Pré-configurado com next-themes.
• Design Responsivo: Abordagem mobile-first usando Tailwind CSS.
• Type Safety: Suporte total a TypeScript para componentes, hooks e interações com API.
• Performance Otimizada: Builds rápidos e HMR com Vite.
• Componentes Acessíveis: Componentes acessíveis por padrão usando primitivos do Radix UI.

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.