kutovoys/xray-checker v1.2.1

on GitHub

✨ New Features

🎨 Web Interface Customization

Full customization support for the web interface. You can now replace the default template, add custom styles, change the logo, favicon, and add any other static files.

Configuration:

WEB_CUSTOM_ASSETS_PATH=/path/to/custom
# or
--web-custom-assets-path=/path/to/custom

Supported files:

• index.html — Full template replacement (Go template with access to all page data)
• logo.svg — Custom logo
• favicon.ico — Custom favicon
• custom.css — Additional styles (auto-injected after default styles)
• Any other files — Available at /static/{filename}

Docker example:

services:
  xray-checker:
    image: kutovoys/xray-checker:latest
    volumes:
      - ./custom:/app/custom:ro
    environment:
      - WEB_CUSTOM_ASSETS_PATH=/app/custom

CSS Variables for theming:

:root {
  --bg-primary: #0a0a0f;
  --bg-secondary: #12121a;
  --text-primary: #f4f4f5;
  --color-green: #22c55e;
  --color-red: #ef4444;
}

Custom assets are loaded and cached at startup. Invalid custom templates will prevent the application from starting.

📚 Documentation

• New page: Web Customization guide with Go template variables reference
• Reorganized: Public Status Page moved from Integrations to Configuration section

🔧 Technical Details

• New AssetLoader component for custom assets management
• Assets are loaded once at startup for optimal performance
• Custom files overlay embedded defaults (custom first, fallback to default)
• Automatic custom.css injection before tag