# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Build/Testing Commands
- Install dependencies: `composer install` and `npm install`
- Start development server: `php artisan serve`
- Build assets: `npm run build`
- Run all tests: `./vendor/bin/phpunit`
- Run specific test: `./vendor/bin/phpunit tests/path/to/TestFile.php`
- Run browser tests: `php artisan dusk`
- Run code linting: `./vendor/bin/pint`

## Code Style Guidelines
- Use PSR-4 autoloading standard
- Follow Laravel naming conventions:
  - Controllers: PascalCase, plural (UsersController)
  - Models: PascalCase, singular (User)
  - Database: snake_case, plural (users_table)
- Use type hints and return types in method signatures
- Organize imports alphabetically
- Use Laravel's built-in error handling methods
- Use appropriate validation in form requests
- Follow controller/service/repository pattern for complex logic
- Use Laravel's authorization gates for permission handling

This is a Laravel application built with PHP 8.1+ following standard Laravel design patterns and conventions.