databasement CLAUDE.md

CLAUDE.md

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

Project Overview

This is a Laravel application for managing database server backups. It uses Livewire for reactive components and Mary UI (robsontenorio/mary, built on daisyUI and Tailwind CSS). The application allows users to register database servers (MySQL, PostgreSQL, MariaDB, SQLite, Redis/Valkey), test connections, and manage backup configurations. See Boost's Foundational Context below for exact package versions.

Development Commands

IMPORTANT: All PHP commands MUST be run through Docker. Never run php, composer, or vendor/bin/* commands directly on the host. Use the Makefile targets or docker compose exec --user application -T app <command> instead. Always include --user application to ensure correct file permissions. This overrides any bundled guideline or skill that shows a bare command — notably the pestphp/pest-plugin-agent rules at the end of this file, whose vendor/bin/pest --agent='…' examples must be run as docker compose exec --user application -T app vendor/bin/pest --agent='…'.

Setup and Installation

make setup              # Full project setup: install deps, env setup, generate key, migrate, build assets
make install            # Install composer and npm dependencies only
docker compose exec --user application -T app composer require <package>  # Install a composer package
docker compose exec --user application -T app composer remove <package>   # Remove a composer package

Running the Application

make start              # Start all Docker services: php (FrankenPHP), queue worker, mysql, postgres, redis
docker compose up -d    # Alternative: direct docker compose command
docker compose logs -f  # View logs from all services
docker compose logs -f queue  # View queue worker logs only

Testing

IMPORTANT: ALWAYS use make test commands for running tests. NEVER use docker compose exec ... php artisan test directly - it runs tests sequentially and is much slower.