# Contributing to AnimFX Store Thank you for contributing! This guide covers code standards, workflow, and how to add features safely. --- ## 🛠 Development Setup ```bash # 1. Fork & clone git clone https://github.com/yourusername/svga-store.git cd svga-store # 2. Install deps (with dev tools) composer install # 3. Copy env & configure cp .env.example .env # Edit .env for local dev (SQLite, baseURL=http://localhost:8080/) # 4. Fresh DB + seed php spark migrate --all php spark db:seed MainSeeder # 5. Run dev server php spark serve --port 8080 ``` --- ## 📝 Code Standards ### PHP (PSR-12 + CI4 Conventions) - **Indent**: 4 spaces (no tabs) - **Line length**: ≤ 120 chars - **Strict types**: `declare(strict_types=1);` at top of every PHP file - **Type hints**: Use wherever possible (PHP 8.1+ union types, `never`, `mixed`) - **Naming**: - Classes: `PascalCase` (`PaymentGateway`) - Methods/Properties: `camelCase` (`paddleCheckoutUrl`) - Constants: `SCREAMING_SNAKE` (`PAYPAL = 'paypal'`) - Views: `snake_case` (`orders/checkout.php`) ### Lint Before Commit ```bash # Check syntax on all changed PHP files php -l $(git diff --name-only -- '*.php') # Or all PHP files find app -name "*.php" -exec php -l {} \; ``` ### Database - **Migrations**: One per logical change, timestamped filename (`YYYY-MM-DD-HHMMSS_Description.php`) - **Never edit applied migrations** — create a new one - **Seeders**: Only for reference/demo data, not production data - **Foreign keys**: Use `$table->foreignKey()` in migrations --- ## 🌿 Git Workflow ### Branch Naming | Type | Prefix | Example | |------|--------|---------| | Feature | `feat/` | `feat/paypal-refund-api` | | Bugfix | `fix/` | `fix/webhook-idempotency` | | Refactor | `refactor/` | `refactor/payment-gateway-interface` | | Docs | `docs/` | `docs/deployment-guide` | | Chore | `chore/` | `chore/update-dependencies` | ### Commit Messages (Conventional Commits) ``` ():