hypixel-stats/AGENTS.md

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