A lightweight, portable, open-source local development environment for PHP developers.

Author: Nomad Programmer
Contact: shiv@srapsware.com
Repository: ProgrammerNomad/DevStackBox
Latest Release: v0.1.6
Docs & Issues: Please use GitHub Issues and GitHub Wiki for all documentation, feature requests, and bug reports.

• ✅ MSI Compatibility Fixed: Clean semantic versioning (v0.1.6) for Windows MSI installer
• ✅ Complete UI Restoration: Fixed accidentally deleted CSS and core files
• ✅ Both Installer Formats: MSI (288.9 MB) and NSIS (147.7 MB) available
• ✅ GitHub Actions Fixed: Resolved emoji encoding issues in CI/CD pipeline
• ✅ Project Structure Optimized: Clean codebase following Vite + React + Tauri best practices

• Windows MSI Installer: DevStackBox_0.1.6_x64_en-US.msi
• Windows NSIS Installer: DevStackBox_0.1.6_x64-setup.exe

Legend:
✅ Available 🔄 In Progress 🕓 Planned

DevStackBox is a next-generation, portable PHP development stack built using Tauri, Vite, React, Tailwind CSS, shadcn/ui, and Framer Motion.
It provides a fast, modern, cross-platform GUI for managing your entire PHP stack locally — all with minimal dependencies and a beautiful UI.

• Super lightweight: Tauri core is 5–30MB (excluding service binaries)
• Cross-platform: Windows 10/11, macOS, Linux
• Dark/Light Mode: Fully supported everywhere
• Auto-update: Releases and updates are managed via GitHub Releases and Tauri’s updater
• Community-first: All features, bugs, and documentation are handled on GitHub

• Windows 10/11, macOS, or Linux
• Node.js 18+
• Rust (for Tauri backend)
• Git
• pnpm or npm or yarn
• Tauri CLI

1. Clone the repository:

   git clone https://github.com/ProgrammerNomad/DevStackBox.git
   cd DevStackBox

2. Install dependencies:

   pnpm install
   # or
   npm install

3. Install Tauri CLI:

   cargo install tauri-cli

4. Run the application:

   pnpm tauri dev
   # or
   npm run tauri dev

DevStackBox/
├── src-tauri/ # Tauri (Rust) backend for process mgmt, IPC, native ops
├── src/ # Frontend (Vite + React + Tailwind + shadcn/ui + Framer Motion)
├── mysql/ # Portable MySQL setup
├── php/ # PHP 8.2 binaries (default)
├── apache/ # Apache portable setup (planned)
├── phpmyadmin/ # phpMyAdmin setup
├── apps/ # One-click app installers (planned)
├── config/ # Config files (php.ini, my.cnf, httpd.conf, etc.)
├── config-backups/ # Config backup files
├── logs/ # Log files (Apache, MySQL, PHP, etc.)
├── www/ # Web root directory (planned)
├── locales/ # Translation files (EN, HI, etc.)
└── package.json # Project config (frontend)

• Sidebar Navigation: Main sections (Dashboard, Projects, Services, Logs, Settings, About)
• Top Bar: Quick actions (theme switcher, language, user menu, updates)
• Command Palette: Fast action search/jump (Ctrl+P or Cmd+P, shadcn/ui’s Command component)
• Context Menus: Right-click per-item actions (shadcn/ui ContextMenu)
• Tabs: For sub-navigation within a page (e.g., "Overview | Logs" for a service)

• Integrated Terminal: Embedded xterm.js terminal using Tauri’s process management
• PHP Version Selector: (Planned) Change PHP version per session (other versions downloadable)
• Composer & MySQL CLI: Available in the app terminal
• Bundled Tools: Optionally ship with curl, git, node, npm, etc.

• Distribution: Releases and auto-updates are managed via GitHub Releases.
• Update: App will auto-update itself from GitHub (using Tauri's built-in updater).

• Config Backup/Restore: Automatic and manual backups for all configs
• Database Backup/Restore: One-click export/import for MySQL databases
• Full App Backup/Restore: Backup/restore all critical files and databases

• Real-time, searchable log viewer for MySQL, Apache, PHP, phpMyAdmin, and app logs

• User-initiated bug/crash reporting: Pre-filled GitHub issues from the app
• Security analyzer: (Planned) Scan configs and code for common issues
• HTTPS/SSL: One-click SSL for local projects (planned)
• MySQL user management: GUI for users/privileges

• No Custom CSS Required: Use Tailwind utility classes and shadcn/ui only (document rare exceptions)
• Consistent Design Language: Unified styling across all components
• Mobile-First Responsiveness: Adapts to any screen size
• Dark/Light Mode: Easy theming (shadcn/ui + Tailwind)
• Animation: Smooth transitions via Framer Motion

• All user-facing text must use i18next (EN, HI)
• Language switcher styled with icons and Unicode support
• Proper font handling for Devanagari/Hindi

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

MIT License – see LICENSE

• Inspired by Laragon, XAMPP, and the open-source community
• Built with Tauri, Vite, React, Tailwind CSS, shadcn/ui, and Framer Motion

• 🐛 Report bugs: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Email: shiv@srapsware.com

DevStackBox – Making local PHP & MySQL development simple, modern, and portable! 🚀