34 lines
1.4 KiB
Markdown
34 lines
1.4 KiB
Markdown
# 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
|
|
|