xDebug Helper Pro

A modern Chrome extension for managing Xdebug sessions with IDE profiles and per-domain state. This extension helps PHP developers quickly enable or disable Xdebug debugging sessions directly from their browser, with support for multiple IDEs and custom configurations.

• 🔄 Enable/disable Xdebug sessions with a single click
• 🛠️ Support for multiple IDE profiles:
  • PHPStorm
  • VS Code
  • Custom profiles with custom session keys
• 🌐 Per-domain state management
• 🔐 Secure implementation with strict CSP
• 🎨 Modern, user-friendly interface
• 🔒 Privacy-focused: no data collection, works offline

• Node.js (v18 or higher)
• npm (v9 or higher)
• Chrome browser

1. Clone the repository:

git clone https://github.com/yourusername/xdebug-helper-pro.git
cd xdebug-helper-pro

2. Install dependencies:

npm install

3. Start development server:

npm run dev

1. Build the extension:

npm run build

2. Load the extension in Chrome:
   • Open Chrome and navigate to chrome://extensions
   • Enable "Developer mode" in the top right
   • Click "Load unpacked" and select the dist directory
   • The extension icon should appear in your toolbar

To create a production build and package the extension:

npm run build:prod

This will:

1. Clean the dist directory
2. Build the extension for production
3. Create a xdebug-helper-pro.zip file ready for Chrome Web Store submission

1. Download the latest release from the releases page
2. Extract the ZIP file
3. Open Chrome and navigate to chrome://extensions
4. Enable "Developer mode" in the top right
5. Click "Load unpacked" and select the extracted directory

This project uses:

• TypeScript for type safety
• Vite for building
• ESLint and Prettier for code quality
• Modern JavaScript features
• Strict CSP for security

Available commands:

• npm run dev - Start development server
• npm run build - Build the extension
• npm run lint - Run ESLint
• npm run format - Format code with Prettier

xdebug-helper-pro/
├── src/                # Source files
│   ├── background.ts   # Service worker
│   ├── popup.ts        # Popup script
│   ├── popup.html      # Popup HTML
│   ├── types.ts        # TypeScript types
│   └── utils/          # Utility functions
├── public/             # Static assets
│   └── icon.png        # Extension icon
├── dist/               # Build output (not in repo)
└── ...config files

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

Please ensure your PR:

• Follows the existing code style
• Includes appropriate tests
• Updates documentation as needed
• Has a clear description of changes

1. Click the xDebug Helper Pro icon in your Chrome toolbar
2. Select your preferred IDE profile (PHPStorm, VS Code, or custom)
3. Toggle Xdebug sessions for each domain
4. For custom profiles, enter your desired Xdebug session key
5. The extension will maintain your preferences per domain

This extension implements:

• Strict Content Security Policy (CSP)
• Input validation and sanitization
• Secure cookie handling
• No external dependencies or tracking
• Regular security updates

MIT License - see LICENSE file for details

• Xdebug - The powerful PHP debugging tool
• Chrome Extensions Documentation - For development guidelines
• All contributors who help improve this project

If you find this project helpful, consider supporting us:

• ☕ Buy Me a Coffee
• 💜 GitHub Sponsors

Every bit of support helps us improve and maintain this tool for developers like you.