# CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. ## Project Overview Maz UI is a comprehensive Vue 3/Nuxt 3 component library featuring 50+ UI components, composables, directives, and utilities. It's built as a monorepo using NX and pnpm workspaces. ## Development Commands ### Main Commands - `pnpm install` - Install dependencies (required pnpm) - `pnpm health` - Run full CI pipeline (lint, typecheck, test, build packages, build docs) - `pnpm build:packages` - Build all library packages - `pnpm build:apps` - Build demo applications (docs, nuxt-app, vue-app) - `pnpm lint:all` - Lint all packages - `pnpm lint:fix:all` - Auto-fix lint issues across all packages - `pnpm typecheck:all` - Type check all packages - `pnpm test:unit:all` - Run unit tests across all packages - `pnpm test:unit:coverage:all` - Run tests with coverage ### Package-Specific Commands Within individual packages (e.g., `packages/maz-ui/`): - `pnpm build` - Build the package (includes typecheck) - `pnpm lint` - Lint JavaScript and styles - `pnpm lint:fix` - Auto-fix linting issues - `pnpm test:unit` - Run unit tests - `pnpm test:unit:watch` - Run tests in watch mode - `pnpm test:unit:coverage` - Run tests with coverage - `pnpm typecheck` - Type check with vue-tsc ### NX Commands - `pnpm nx:cache:clear` - Clear NX cache ### Cleanup - `make clean` - Clean all generated files (node_modules, dist, coverage, etc.) ## Architecture ### Monorepo Structure - `packages/maz-ui/` - Main Maz UI library (Vue components, composables, directives) - `packages/icons/` - Icon package (@maz-ui/icons) based on Heroicons - `packages/themes/` - Theme management package (@maz-ui/themes) - `packages/translations/` - i18n support package (@maz-ui/translations) - `packages/utils/` - Utility functions package (@maz-ui/utils) - `packages/eslint-config/` - Shared ESLint configuration - `packages/nuxt/` - Nuxt 3 module (@maz-ui/nuxt) - `packages/node/` - Node.js utilities (also `setupAgents`, used by `npx @maz-ui/mcp init` and the Nuxt `agents` option) - `packages/vite-plugin/` - Vite plugins (@maz-ui/vite-plugin): `MazUiPurgeCss` removes the unused CSS of maz-ui, from the `purge-manifest.json` written by the build of maz-ui - `packages/mcp/` - MCP server and CLI for AI agents (@maz-ui/mcp): search, component APIs, icons, theme tokens, code review - `apps/docs/` - Documentation site - `apps/vue-app/` - Vue 3 demo application - `apps/nuxt-app/` - Nuxt 3 demo application - `tools/cli/` - Internal CLI tools - `tools/agent-docs/` - Generator of the agent knowledge bundle (see below) - `plugins/claude-code/` - Claude Code plugin (skill, MCP server, review hook), exposed by `.claude-plugin/marketplace.json` ### Main Library Structure (`packages/maz-ui/src/`) - `components/` - Vue 3 components with TypeScript props and emit definitions - `composables/` - Reusable composition functions (e.g., useFormValidator, useToast) - `directives/` - Vue directives (vClickOutside, vTooltip, vLazyImg, etc.) - `plugins/` - Vue plugins (toast, dialog, AOS animations, wait overlay) - `resolvers/` - Auto-import resolvers for bundlers - `css/` - Base CSS styles and animations - `tailwindcss/` - TailwindCSS integration and utilities ### Component Architecture - Each component is a single `.vue` file with TypeScript `