# Agents Guide for stats-hypixel

## Build Commands

- `bun run dev` - Start development server with turbopack
- `bun run build` - Build for production
- `bun run typecheck` - Type check with TypeScript
- `bun run lint` - Lint codebase with ESLint
- `bun run lint:fix` - Auto-fix ESLint issues
- `bun run fmt` - Format code with dprint

## Code Style

- **Formatting**: Use dprint with 4-space indentation, no semicolons (ASI), double quotes, line width 150
- **Imports**: Use `@/` for src imports, group by external libs → internal libs → relative imports
- **TypeScript**: Strict mode enabled, use proper type annotations, prefer `type` over `interface`
- **Components**: Use React 19 patterns, prefer function components with props destructuring
- **Styling**: TailwindCSS with `cn()` utility from `@/lib/utils`, use class-variance-authority for variants
- **File naming**: kebab-case for files, PascalCase for components, camelCase for functions
- **Environment**: Use `@t3-oss/env-nextjs` with Zod validation for env vars

## Key Patterns

- UI components use Radix UI primitives with custom styling
- Error handling with proper TypeScript error types
- No test framework detected - verify manually or ask user for test commands

## Don'ts

- Do not ever commit code without being asked to
- Do not run extra dev servers or builds without asking me, you can run a typecheck eslint and fmt
- In case of any type errors with nextjs run typegen