php-client/CLAUDE.md

CLAUDE.md

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

Project Overview

Laravel package providing the authenticated SaaS customer dashboard (Core\Front\Client). Extracted from the core/php monorepo. Part of a frontend tier hierarchy:

• Core\Front\Web — public/anonymous
• Core\Front\Client — authenticated customer (this package)
• Core\Front\Admin — privileged admin
• Core\Hub — SaaS operator control plane

Domain concepts: A Namespace is a user identity tied to a URI/handle. A Workspace is a management container (org/agency). A personal workspace maps 1:1 to a namespace for solo users.

Commands

composer install          # Install dependencies

No test suite, linter, or static analysis is configured in this package. Quality tooling is inherited from the lthn/php dependency in the monorepo context.

Architecture

Namespace: Core\Front\Client (PSR-4 mapped from src/Core/Front/Client/)

Boot.php — Laravel ServiceProvider that:

• Registers a 'client' middleware group (session, CSRF, auth, Core\Headers\SecurityHeaders)
• Loads Blade views under the 'client' namespace from Blade/
• Fires ClientRoutesRegistering lifecycle event so other packages can lazily register routes

Routes/client.php — Defines GET /dashboard pointing to the Dashboard Livewire component. Additional routes are injected via LifecycleEventProvider::fireClientRoutes().

View/Dashboard.php — Livewire component rendering client::dashboard inside client::layouts.app.

Blade/layouts/app.blade.php — Master layout using Tailwind CSS (dark theme), Flux UI components, and Font Awesome icons.

Key Dependencies

• lthn/php — core framework package (provides Laravel, Livewire, Flux, shared middleware)
• PHP ^8.2
• EUPL-1.2 licensed