🛠️ my-component-library

Note

🇺🇸 Read the English version below | 🇧🇷 Leia a versão em português abaixo

---

🇧🇷 Versão em Português

Uma biblioteca pessoal de componentes de interface (UI) reutilizáveis, modulares e focados em produção. Este repositório serve como fundação técnica e acelerador de código para os meus projetos principais do portfólio (E-commerce, Dashboard Escolar, App Educacional e Quiz Técnico).

🚀 Tecnologias e Ferramentas

• Core: React, Next.js (App Router), TypeScript
• Estilização: Tailwind CSS, Shadcn/ui
• Validação: Zod
• Gerenciamento de Dados: TanStack Query

📐 Organização por Fases de Aprendizado

O projeto é estruturado de forma incremental para demonstrar evolução técnica:

1. fase-1-ui: Componentes visuais isolados (Slide/Carrossel, Filtros).
2. fase-2-state: Tratamento de formulários, validação em tempo real (Zod) e estados locais.
3. fase-3-global: Gerenciamento de estado global (Zustand) e persistência em cache (LocalStorage).
4. fase-4-async: Chamadas assíncronas simulados (TanStack Query) e controle de Skeletons.

---

🇺🇸 English Version

A personal library of reusable, modular, and production-ready UI components. This repository serves as a technical foundation and code accelerator for my main portfolio projects (e-commerce, School Dashboard, Educational App, and Technical Quiz).

🚀 Tech Stack

• Core: React, Next.js (App Router), TypeScript
• Styling: Tailwind CSS, Shadcn/ui
• Global State: Zustand
• Validation: Zod
• Data Management: TanStack Query

📐 Project Structure & Phases

The project is structured incrementally to demonstrate technical growth:

1. fase-1-ui: Isolated visual components (Carousel/Slide, Filter Bar).
2. fase-2-state: Form handling, real-time validation (Zod), and local state.
3. fase-3-global: Global state management (Zustand) and cache persistence (LocalStorage).
4. fase-4-async: Simulated asynchonous data fetching (TanStack Query) and Skeleton screens.