A powerful desktop tool for managing local development environments
Streamline your development workflow with one-click project scaffolding, virtual host configuration, SSL certificate generation, and development tools management.
Features • Installation • Usage • Contributing • License
We stand in solidarity with our brave soldiers defending Cambodia's sovereignty and territorial integrity. Our hearts are with those protecting our homeland during these challenging times. We call upon the international community to support peaceful resolution and respect for Cambodia's borders.
🙏 កម្ពុជាត្រូវការសន្តិភាព • Together we stand for peace and sovereignty
Create Laravel, Vue, Nuxt, React, and WordPress projects with framework-specific options and starter kits. Includes recent projects tracking, favorites, and post-creation actions.
Configure Nginx virtual hosts with automatic PHP-FPM detection, SSL certificate support, and sidebar navigation. Manage existing sites with enable/disable controls and detailed configuration viewer.
Install and manage PHP (8.0-8.4), Composer, Node.js, Nginx, PostgreSQL, and MySQL with one-click installation and multi-version support.
Bilingual UI (English/Khmer), dark/light mode, keyboard shortcuts, command palette, operation monitor, onboarding tour, and auto-updates.
- Node.js ≥ 16.x
- npm ≥ 7.x
- OS: Linux, macOS, or Windows (tested on Ubuntu 20.04+)
- Permissions: sudo access (for tool installation)
Optional: Development tools (PHP, Nginx, MySQL, etc.) can be installed via the app's Manage Services tab.
# Clone the repository
git clone https://github.com/HELMAB/localforge.git
cd localforge
# Install dependencies
npm install
# Run in development mode
npm run electron:dev| Command | Description |
|---|---|
npm run electron:dev |
Start development server with hot reload |
npm run build |
Build Vue app for production |
npm run electron:build |
Build and package for distribution |
npm run build:linux |
Build for Linux (.deb, AppImage) |
npm run build:win |
Build for Windows (NSIS installer) |
npm run build:mac |
Build for macOS (DMG) |
npm run lint |
Check code quality with ESLint |
npm run format |
Format code with Prettier |
| Shortcut | Action |
|---|---|
Ctrl+K |
Command Palette |
Ctrl+1 |
Create Project |
Ctrl+2 |
Virtual Host Config |
Ctrl+4 |
Manage Services |
Ctrl+, |
Settings |
Ctrl+D |
Toggle Dark Mode |
Ctrl+L |
Switch Language |
- Frontend: Vue 3, Vue Router, Vue I18n, Tailwind CSS
- Desktop: Electron 28, IPC communication, electron-updater
- Build: Vite 5, ESLint, Prettier, electron-builder
localforge/
├── src/
│ ├── main/ # Electron main process
│ └── renderer/ # Vue 3 application
│ └── src/
│ ├── components/ # UI components
│ ├── composables/ # Business logic
│ ├── views/ # Route views
│ ├── router/ # Vue Router
│ └── i18n/ # Translations (km/en)
├── vite.config.js
├── tailwind.config.js
└── package.json
Contributions are welcome! Here's how to contribute:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m "feat: add amazing feature" - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
Guidelines:
- Follow existing code style (ESLint + Prettier)
- Test with
npm run electron:dev - Use Conventional Commits
- Update documentation if needed
Pre-commit hooks automatically lint and format code.
This project is licensed under the MIT License - see the LICENSE file for details.
Built with Electron, Vue 3, Vite, and Tailwind CSS.
- Issues: GitHub Issues
- Email: mabhelitc@gmail.com
- Website: helmab.netlify.app