homebridge-config-ui-x 5.4.2-beta.10 → 5.4.2-beta.11

package/CLAUDE.md

@@ -1,112 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Common Development Commands
-
-### Build and Development
-
-- `npm run build` - Build both server and UI components
-- `npm run build:server` - Build only the Node.js server (TypeScript compilation)
-- `npm run build:ui` - Build only the Angular UI
-- `npm run watch` - Start development mode with hot reload (Angular dev server on :4200, backend on :8581)
-- `npm run watch:server` - Watch and rebuild server code only
-- `npm run watch:ui` - Watch and rebuild UI code only
-- `npm start` - Start server in development mode using ts-node
-
-### Testing and Quality
-
-- `npm test` - Run the test suite (Vitest e2e tests)
-- `npm run test-coverage` - Run tests with coverage report
-- `npm run lint` - Run ESLint with zero warnings tolerance
-- `npm run lint:fix` - Auto-fix linting issues
-
-### UI Development
-
-- `cd ui && npm install` - Install UI dependencies
-- `cd ui && npm run build` - Build UI for production
-- `cd ui && npm start` - Start Angular dev server
-
-## Architecture Overview
-
-### Backend (NestJS + Fastify)
-
-The server is built with **NestJS** framework using **Fastify** as the HTTP adapter. Key architectural components:
-
-- **Entry Point**: `src/main.ts` - Configures Fastify, security headers, CORS, and bootstraps the NestJS application
-- **App Module**: `src/app.module.ts` - Root module that imports all feature modules
-- **Core Services**:
-  - `src/core/config/` - Configuration management and startup config
-  - `src/core/auth/` - JWT authentication with guards for admin/user roles
-  - `src/core/logger/` - Custom logging service
-  - `src/core/homebridge-ipc/` - IPC communication with Homebridge instances
-
-### Feature Modules (src/modules/)
-
-- **accessories/** - HomeKit accessory management and control
-- **plugins/** - Plugin installation, configuration, and management
-- **config-editor/** - Homebridge config.json editing with validation
-- **backup/** - Backup and restore functionality
-- **status/** - System status and monitoring
-- **users/** - User management and authentication
-- **platform-tools/** - Platform-specific tools (Docker, Linux, terminal access)
-- **custom-plugins/** - Special integrations for popular plugins (Hue, deCONZ)
-
-### Frontend (Angular)
-
-The UI is an **Angular 20** application located in the `ui/` directory:
-
-- **Modular Architecture**: Feature modules mirror backend structure
-- **State Management**: Services with RxJS for reactive data flow
-- **Real-time Updates**: WebSocket connections for live data
-- **UI Framework**: Bootstrap 5 with custom SCSS theming
-- **Code Editor**: Monaco editor integration for config editing
-- **Internationalization**: Full i18n support with 25+ languages
-
-### Key Technologies
-
-- **Backend**: NestJS, Fastify, TypeScript, Socket.IO
-- **Frontend**: Angular, Bootstrap 5, RxJS, Socket.IO client
-- **Testing**: Vitest for e2e testing
-- **Build**: TypeScript compiler, Angular CLI
-- **Code Quality**: ESLint with @antfu/eslint-config
-
-## Development Workflow
-
-### Setting Up Development Environment
-
-1. `npm install && cd ui && npm install && cd ..` - Install all dependencies
-2. `npm run build` - Initial build
-3. `npm link` - Link for global development
-4. `npm run watch` - Start development servers
-
-### File Structure Patterns
-
-- **Controllers**: Handle HTTP endpoints and validation
-- **Services**: Business logic and external integrations
-- **Gateways**: WebSocket event handlers
-- **DTOs**: Data transfer objects with validation decorators
-- **Guards**: Authentication and authorization logic
-
-### Code Style
-
-- Uses **@antfu/eslint-config** with strict import sorting
-- **1tbs** brace style enforced
-- No unused imports/variables allowed
-- Consistent quote-props style
-- Zero ESLint warnings policy
-
-## Testing
-
-- E2e tests located in `test/e2e/`
-- Tests use Vitest with SWC compilation
-- Coverage reporting available via `npm run test-coverage`
-- Tests cover all major modules and API endpoints
-
-## Special Considerations
-
-- **Security**: Helmet.js for security headers, JWT authentication, CSP policies
-- **Multi-platform**: Supports Linux, macOS, Windows, Docker environments
-- **Plugin System**: Dynamic plugin loading and configuration UI generation
-- **Child Bridges**: Support for isolated plugin execution
-- **Real-time**: WebSocket integration for live system monitoring