A cross-platform local web development stack desktop application. CAMPP bundles Caddy (web server), PHP-FPM 8.3 (PHP runtime), MariaDB (database), and phpMyAdmin with no external dependencies after installation.

Download the latest release from GitHub Releases:

• Windows: Download CAMPP_x64-setup.exe (NSIS installer) or CAMPP_x64_en-US.msi
• Linux: Download CAMPP_amd64.AppImage and make it executable: chmod +x CAMPP_amd64.AppImage
• macOS: Download CAMPP_aarch64.dmg (Apple Silicon) or CAMPP_x64.dmg (Intel)

Note: macOS builds are available but need more testing volunteers. If you encounter any issues on macOS, please report them!

• Zero Configuration: Works out of the box with sensible defaults
• No Admin Required: Uses non-default ports to avoid conflicts
• Self-Contained: All binaries bundled, no separate installations needed
• Modern UI: Clean desktop interface built with Tauri + React + TypeScript
• Service Management: Start, stop, and restart services individually or all at once
• Port Configuration: Customize ports for each service via Settings panel
• Quick Actions: Open project folder, phpMyAdmin, or logs with one click
• PHP Version Choice: Select PHP 8.3 or PHP 7.4.33 (Windows) for legacy application support

Runtime binaries are downloaded from the following sources:

Note: The campp-runtime-binaries repository contains pre-compiled binaries packaged for CAMPP's specific requirements.

Default Database Credentials: root / (empty password)

Port Customization: You can change ports in Settings (⚙️). Running services will automatically restart when you save.

1. Install: Run the downloaded installer
2. First Run: The app will download required binaries on first launch (~500MB)
3. Start Services: Click "Start All" or start individual services from the dashboard
4. View Projects: Access http://localhost:8080 to view your projects
5. Manage Database: Access http://localhost:8080/phpmyadmin for database management

# Install dependencies
npm install

# Start development server
npm run tauri dev

# Build for production
npm run tauri build

cd src-tauri
cargo build    # Build Rust backend
cargo test     # Run Rust tests
cargo clippy   # Lint Rust code

campp/
├── src/                    # React + TypeScript frontend
│   ├── components/        # UI components
│   ├── hooks/             # Custom React hooks
│   └── types/             # TypeScript definitions
├── src-tauri/              # Rust backend
│   ├── src/
│   │   ├── process/       # Process management
│   │   ├── config/        # Configuration generation
│   │   ├── runtime/       # Binary download system
│   │   └── database/      # MariaDB integration
│   └── templates/         # Service config templates
└── DEVELOPMENT_PLAN.md    # Implementation roadmap

See DEVELOPMENT_PLAN.md for the full implementation roadmap.

• ✅ Phase 1: Project Foundation - Tauri + React setup
• ✅ Phase 2: Runtime Download System - First-run binary download wizard
• ✅ Phase 3: Process Manager - Service start/stop/restart
• ✅ Phase 4: Configuration Generation - Dynamic config files
• ✅ Phase 5: MariaDB Initialization - Database setup and credential management
• ✅ Phase 6: Enhanced Dashboard UI - Service control interface
• ✅ Phase 7: Settings Panel - Port configuration and project folder selection
• ✅ Phase 8: Cross-platform Support - Windows, Linux, macOS installers

• Windows: Windows 10/11 x64, WebView2 runtime (usually pre-installed)
• Linux: Ubuntu 22.04+ or similar distributions with webkit2gtk dependencies
• macOS: macOS 11+ (Big Sur or later), Apple Silicon or Intel

MIT

Contributions are welcome! Please read DEVELOPMENT_PLAN.md for project architecture details.

macOS testers needed! If you have a Mac and want to help test CAMPP, please download the latest release and report any issues you encounter.