Use this when you want ProTask on your own computer for evaluation or development. Production still uses Installation.
PHP runtime
Pick one stack that can run PHP 8.2+ and MySQL/MariaDB:
| OS | Common choices |
|---|---|
| Windows | XAMPP (or equivalent), plus Composer |
| macOS | Laravel Valet + MariaDB/MySQL, or MAMP. Install Composer (Homebrew is fine). |
| Linux | PHP-FPM or php artisan serve, plus MySQL |
Confirm:
php -v
composer -V
If Homebrew has the wrong PHP linked, switch versions explicitly (example only):
brew unlink php@8.1 && brew link --force php@8.2
Node.js and Yarn
Front-end assets are built with Vite. Install Node.js, then:
npm install --global yarn
From the application root (not _documentation):
yarn install
yarn dev
Use yarn build when you need production assets. If you change Vue files, yarn dev watches; stopping the process stops the watcher.
Composer dependencies
composer install
If you changed PHP versions and extensions fail, run composer update only when you intend to refresh lockfile dependencies.
Serve the app
php artisan serve
Open http://127.0.0.1:8000 (or the URL Artisan prints). If the app is not installed, the installer wizard runs the same as on a server.
Create a local MySQL database first and use 127.0.0.1 / localhost in the wizard.
Cache after backend changes
When you change routes or config:
php artisan optimize && php artisan cache:clear && php artisan route:cache && php artisan view:clear && php artisan config:cache && php artisan route:clear
During active development, prefer php artisan optimize:clear so you are not serving a stale cached config.
Documentation site only
This _documentation folder is a separate VitePress app:
cd _documentation
npm install
npm run dev
← All ProTask – Project Management Software with Time Tracking & Team Collaboration documentation