First commit

CLAUDE.md

@@ -0,0 +1,129 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a multi-domain Laravel application with Fortify/Sanctum authentication. The application supports 5 different domains with distinct themes and configurations:
+
+- **Admin Portal**: portal.b2in.test - Backend admin user interface (uses Livewire/Flux UI)
+- **B2in Main**: b2in.test - Frontend main page (uses TailwindCSS + Tailwind UI/Plus)
+- **B2A Secondary**: b2a.test - Frontend secondary page (uses TailwindCSS + Tailwind UI/Plus)
+- **Stileigentum**: stileigentum.test - Frontend landing page (uses TailwindCSS + Tailwind UI/Plus)
+- **Style2own**: style2own.test - Frontend landing page (uses TailwindCSS + Tailwind UI/Plus)
+
+## Development Commands
+
+### Setup & Installation
+```bash
+composer install
+npm install
+php artisan key:generate
+php artisan migrate
+```
+
+### Development Server
+```bash
+# Full development environment (server, queue, logs, vite)
+composer run dev
+
+# Individual components
+php artisan serve
+php artisan queue:listen --tries=1
+php artisan pail --timeout=0
+npm run dev
+```
+
+### Asset Compilation
+```bash
+# Development
+npm run dev
+
+# Production builds
+npm run build          # Main build
+npm run build:admin    # Admin portal assets
+npm run build:web      # Web assets
+```
+
+### Testing
+```bash
+composer run test
+# Or directly:
+php artisan test
+```
+
+### Code Quality
+```bash
+./vendor/bin/pint      # Laravel Pint (PHP CS Fixer)
+```
+
+### Domain Management
+```bash
+php artisan domains:generate-favicons    # Generate placeholder favicons for all domains
+```
+
+## Architecture
+
+### Multi-Domain System
+The application uses a sophisticated domain routing system:
+
+- Domain configuration is managed via `.env` variables (see `DOMAINS-CONFIG.md`)
+- Each domain can have custom themes, colors, and CSS
+- Domain simulation available for development (`DEV_SIMULATE_DOMAIN=true`)
+- Routes are organized by domain type (`routes/domains.php`, `routes/admin.php`, `routes/web.php`)
+
+### Frontend Architecture
+- **Vite**: Multiple configurations for different domains (`vite.config.js`, `vite.portal.config.js`, `vite.web.config.js`)
+- **TailwindCSS**: Version 4.x with domain-specific configurations (`tailwind.config.js`, `tailwind.portal.config.js`, `tailwind.web.config.js`)
+- **Backend (Portal)**: Livewire with Flux UI components and Volt for reactive components
+- **Frontend Sites**: Livewire with TailwindCSS + Tailwind UI/Plus components (no Flux UI)
+- **Alpine.js**: For lightweight frontend interactions
+
+### Backend Architecture
+- **Laravel Framework**: Version 12.x
+- **Authentication**: Laravel Fortify + Sanctum for API authentication
+- **Permissions**: Spatie Laravel Permission package
+- **Database**: Configured for multiple environments with migrations in `database/migrations/`
+- **Providers**: Custom providers for theme handling (`app/Providers/ThemeServiceProvider.php`)
+
+### Key Directories
+- `app/Livewire/`: Livewire components and actions
+- `resources/css/web/`: Domain-specific CSS themes
+- `resources/views/`: Blade templates with Flux components
+- `routes/`: Domain-separated route files
+- `config/`: Laravel configuration files
+
+### Development Tools
+- **Laravel Sail**: Docker development environment
+- **Laravel Pail**: Real-time log monitoring
+- **Laravel Debugbar**: Development debugging (barryvdh/laravel-debugbar)
+- **PestPHP**: Testing framework
+
+## Domain Configuration
+
+Domains are configured in `config/domains.php` with environment variables:
+- `DOMAIN_PORTAL`, `DOMAIN_B2IN`, `DOMAIN_B2A`, `DOMAIN_STILEIGENTUM`, `DOMAIN_STYLE2OWN`
+- Each domain has custom color schemes and font families defined in the config
+- Development simulation via `DEV_SIMULATE_DOMAIN` and `DEV_SIMULATED_DOMAIN`
+
+Domain-specific configurations include:
+- **portal.b2in.test**: Admin backend with Flux UI theme
+- **b2in.test**: Anthracite/Dynamic Blue color scheme, Inter/IBM Plex Sans fonts
+- **b2a.test**: Azur Blue/Liberty Red color scheme, Inter/Merriweather fonts
+- **stileigentum.test**: Style Blue/Style Sun color scheme, Inter/Ephesis fonts
+- **style2own.test**: Imperial Blue/Sand Gold color scheme, Inter/EB Garamond fonts
+
+For local development, add domains to your hosts file:
+```
+127.0.0.1   portal.b2in.test
+127.0.0.1   b2in.test
+127.0.0.1   b2a.test
+127.0.0.1   stileigentum.test
+127.0.0.1   style2own.test
+```
+
+## Important Files
+- `DOMAINS-CONFIG.md`: Detailed domain configuration guide
+- `FORTIFY-SANCTUM-SETUP.md`: Authentication setup guide
+- `composer.json`: Contains useful dev scripts (`composer run dev`, `composer run test`)
+- Multiple Vite/Tailwind configs for different build targets