GitHub - thirawat27/CHAMP: CHAMP is a self-contained desktop application that provides a complete local web development environment.

CHAMP By Thirawat27

A modern, cross-platform local web development stack

Caddy + HTTP(S) + Adminer / phpmyAdmin + MySQL + PHP

Features • Installation • Usage • Keyboard Shortcuts • Developer Experience • Development • Configuration

📖 Overview

CHAMP is a self-contained desktop application that provides a complete local web development environment. Unlike traditional solutions like XAMPP, CHAMP is designed to run without administrator privileges by keeping all runtime binaries, configurations, logs, and data in the user's writable app data folder.

Note: This project is a fork of CAMPP by KarnYong, with enhancements and modifications by Thirawat27.

Key Highlights:

🚀 No Admin Required - Runs entirely in user space with non-default ports
📦 Self-Contained - All binaries bundled, no external dependencies
🎯 Cross-Platform - Windows, macOS, and Linux support
🔄 Version Management - Switch between multiple PHP, MySQL, and PostgreSQL versions, plus optional Node.js, Python, Go, and Ruby runtimes
🎨 Modern UI - Built with React and Tauri for a native experience
⚡ Fast & Lightweight - Rust-powered backend for optimal performance

🛠️ Tech Stack

Current Versions

Component	Version	Description
Caddy	2.11.4	Modern web server with HTTPS
PHP	8.5.7	Latest PHP runtime (switchable)
MySQL	9.7.1	LTS database server
PostgreSQL	18.4	Stable database server
phpMyAdmin	5.2.3	Database management interface
Adminer	5.4.2	Lightweight database interface

Alternative Options

PHP: 7.4.33 (EOL), 8.5.7 (Latest)
Database UI: phpMyAdmin 5.2.3 or Adminer 5.4.2
Databases: MySQL 9.7.1 or PostgreSQL 18.4

✨ Features

Core Functionality

✅ One-Click Service Management - Start/stop/restart all services with a single click
✅ System Tray Integration - Minimize to tray and control services from the system tray
✅ Auto-Start Services - Optionally start services automatically on app launch
✅ Real-Time Status Monitoring - Live service status updates and system metrics
✅ Port Configuration - Customize ports to avoid conflicts
✅ Project Management - Organize and access your web projects easily

Advanced Features

🔄 Multi-Version Support - Install and switch between different PHP, MySQL, and PostgreSQL versions
📦 Package Selection - Choose which components and optional runtimes to install during first run
🔒 Secure by Default - Isolated user environment, no system-wide changes
📊 System Metrics - Monitor CPU, memory, and disk usage
🗂️ Custom Configuration - Advanced users can customize runtime configs
🐛 Debug Mode - Developer menu with runtime folder access and reset options
⌨️ Keyboard Shortcuts - Control the app without touching the mouse

🌐 Default URLs

Service	URL
Web Server	http://localhost:8080
Database Tool	http://localhost:8080/phpmyadmin or http://localhost:8080/adminer
MySQL	127.0.0.1:3306
PostgreSQL	127.0.0.1:5432
PHP-FPM	127.0.0.1:9000 (internal)

Note: All ports can be customized in the Settings panel to avoid conflicts with other services.

📥 Installation

Download Pre-Built Binaries

Download the latest release for your platform from the Releases page:

Windows: CHAMP_x.x.x_x64_en-US.msi or .exe
macOS: CHAMP_x.x.x_aarch64.dmg (Apple Silicon) or CHAMP_x.x.x_x64.dmg (Intel)
Linux: CHAMP_x.x.x_amd64.AppImage or .deb

First Run Setup

Launch CHAMP
The First-Run Wizard will guide you through:
- System dependency checks
- Package selection (choose which components to install)
- Runtime binary downloads
- Initial configuration
Once complete, you're ready to start developing!

🚀 Usage

Starting Services

Open CHAMP
Click Start All to launch all services
Access your projects at http://localhost:8080
Manage your database at http://localhost:8080/phpmyadmin or http://localhost:8080/adminer, depending on the selected tool

Managing Services

Individual Control: Start/stop/restart each service independently
Bulk Operations: Use "Start All" or "Stop All" for convenience
Auto-Start: Enable in Settings to start services on app launch

Keyboard Shortcuts

CHAMP provides comprehensive keyboard shortcuts for efficient workflow:

Service Control

Shortcut	Action
`Ctrl / Cmd + S`	Start all services
`Ctrl / Cmd + R`	Restart all services
`Ctrl / Cmd + X`	Stop all services

Quick Access

Shortcut	Action
`Ctrl / Cmd + W`	Open website (localhost)
`Ctrl / Cmd + D`	Open database tool (phpMyAdmin/Adminer)
`Ctrl / Cmd + O`	Open projects folder
`Ctrl / Cmd + L`	Open logs folder
`Ctrl / Cmd + T`	Open a terminal with CHAMP runtimes on PATH

UI Navigation

Shortcut	Action
`Ctrl / Cmd + ,`	Toggle Settings panel
`?`	Show keyboard shortcuts help
`Esc`	Dismiss notification or close Settings

Language-Independent: All shortcuts use physical key positions (e.code) so they work regardless of keyboard language (Thai, English, etc.).

📖 View Complete Keyboard Shortcuts Documentation

System Tray

Minimize to Tray: Close the window to minimize to system tray
Quick Access: Right-click the tray icon for quick actions
Background Operation: Services continue running when minimized

Switching PHP Versions

Open Settings panel
Navigate to PHP Version section
Select desired version from dropdown
Click Switch Version (downloads if not installed)
Restart PHP-FPM service

💻 Development

Prerequisites

Node.js 18+ and pnpm 11+
Rust 1.70+ (for Tauri backend)
Platform-specific requirements:
- Windows: WebView2 Runtime
- macOS: Xcode Command Line Tools
- Linux: webkit2gtk, libssl-dev

Setup

# Clone the repository
git clone https://github.com/thirawat27/CHAMP.git
cd CHAMP

# Install dependencies
pnpm install

# Run in development mode
pnpm tauri dev

Available Scripts

Frontend (React + Vite)

pnpm dev          # Start Vite dev server (http://localhost:1420)
pnpm build        # Build frontend for production
pnpm preview      # Preview production build
pnpm test         # Run tests with Vitest
pnpm test:ui      # Run tests with UI
pnpm lint         # Lint TypeScript files
pnpm lint:fix     # Fix linting issues
pnpm format       # Format code with Prettier

Backend (Rust + Tauri)

cd src-tauri

cargo build       # Build Rust backend
cargo test        # Run Rust tests
cargo clippy      # Lint Rust code
cargo fmt         # Format Rust code

Full Application

pnpm tauri dev    # Run full app in dev mode
pnpm tauri build  # Build production app with installers

Project Structure

CHAMP/
├── src/                      # React frontend
│   ├── components/           # UI components
│   │   ├── Dashboard.tsx     # Main dashboard
│   │   ├── ServiceCard.tsx   # Service control cards
│   │   ├── FirstRunWizard.tsx # Setup wizard
│   │   └── SettingsPanel.tsx # Settings UI
│   ├── hooks/                # Custom React hooks
│   ├── types/                # TypeScript definitions
│   └── App.tsx               # Main app component
├── src-tauri/                # Rust backend
│   ├── src/
│   │   ├── commands.rs       # Tauri IPC commands
│   │   ├── process/          # Service process management
│   │   ├── config/           # Configuration generation
│   │   ├── runtime/          # Binary download & locator
│   │   └── lib.rs            # Main library entry
│   ├── runtime-config.json   # Runtime binary definitions
│   └── tauri.conf.json       # Tauri app configuration
└── package.json              # Node.js dependencies

Architecture

Frontend (React + TypeScript)

Modern React 19 with TypeScript
Tailwind CSS for styling
Lucide React for icons
Tauri IPC for backend communication

Backend (Rust + Tauri)

Modular architecture with clear separation of concerns
Process management for service lifecycle
Configuration generation with Mustache templates
Runtime binary download and verification
Cross-platform path handling

⚙️ Configuration

User Data Directory

CHAMP stores all data in platform-specific user directories:

Windows:

%LOCALAPPDATA%\CHAMP\
├── config\           # Generated service configs
├── logs\             # Service logs
├── mysql\data\       # MySQL database files
├── projects\         # Your web projects
└── runtime\          # Downloaded binaries

macOS/Linux:

~/.campp/
├── config/
├── logs/
├── mysql/data/
├── projects/
└── runtime/

Runtime Configuration

Advanced users can customize binary versions and download URLs by editing:

runtime-config.json - Default configuration (bundled with app)
runtime-config.user.json - User overrides (optional)

See runtime-config.schema.json for the full configuration schema.

Settings

Accessible via the Settings panel in the app (or press Ctrl/Cmd + ,):

Ports: Customize service ports
Auto-Start: Enable/disable automatic service startup
Project Folder: Set default project directory
PHP Version: Switch between installed PHP versions
MySQL Version: Switch between installed MySQL versions
PostgreSQL Version: Switch between installed PostgreSQL versions
Additional Runtimes: Install and manage Node.js, Python, Go, and Ruby versions

🐛 Troubleshooting

Services Won't Start

Check if ports are already in use
Review service logs in logs/ directory
Verify runtime binaries are installed
Try "Reset Installation" from Debug menu (dev mode)

Port Conflicts

Open Settings panel
Change conflicting ports
Restart affected services

Reset Installation

In development mode:

Open Debug menu
Select "Reset Installation"
Re-run First-Run Wizard

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

License Holder: Thirawat Sinlapasomsak

🙏 Acknowledgments

Original Project: CAMPP by KarnYong - The foundation and inspiration for this project
Tauri - Desktop app framework
Caddy - Modern web server
PHP - Server-side scripting
MySQL - Database server
phpMyAdmin - Database management
React - UI framework

📞 Support

Issues: GitHub Issues
Repository: github.com/thirawat27/CHAMP

Made with ❤️ by Thirawat27

Name		Name	Last commit message	Last commit date
Latest commit History 50 Commits
.github/workflows		.github/workflows
.vscode		.vscode
public		public
scripts		scripts
src-tauri		src-tauri
src		src
tests		tests
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc.json		.prettierrc.json
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
eslint.config.js		eslint.config.js
index.html		index.html
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts
vitest.config.ts		vitest.config.ts

Folders and files

Latest commit

History

Repository files navigation

CHAMP By Thirawat27

📖 Overview

🛠️ Tech Stack

Current Versions

Alternative Options

✨ Features

Core Functionality

Advanced Features

🌐 Default URLs

📥 Installation

Download Pre-Built Binaries

First Run Setup

🚀 Usage

Starting Services

Managing Services

Keyboard Shortcuts

Service Control

Quick Access

UI Navigation

System Tray

Switching PHP Versions

💻 Development

Prerequisites

Setup

Available Scripts

Frontend (React + Vite)

Backend (Rust + Tauri)

Full Application

Project Structure

Architecture

⚙️ Configuration

User Data Directory

Runtime Configuration

Settings

🐛 Troubleshooting

Services Won't Start

Port Conflicts

Reset Installation

🤝 Contributing

📄 License

🙏 Acknowledgments

📞 Support

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 6

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages