Iluma Todo is an open-source project management and task tracking application.
The application allows you to create and track tasks, organize work into projects, and keep your daily workflow clear and productive.
- PHP 8.5 (FPM)
- Laravel 13
- Inertia.js v3
- Laravel Fortify (Authentication)
- MySQL 8.4
- Mailpit
- Vue 3
- Inertia.js v3
- Tailwind CSS v4
- TypeScript
- Vite
- Tiptap (Rich Text Editor)
- Docker & Docker Compose
- Pest (Testing)
- ESLint & Prettier
- Docker
- Docker Compose
- Start the containers with build:
docker compose up -d --build- Install PHP dependencies (if needed):
docker compose exec iluma composer install- Install Node.js dependencies (if needed):
docker compose exec iluma npm install- Copy the environment file (if needed):
cp .env.example .env- Generate the application key:
docker compose exec iluma php artisan key:generate- Run the migrations:
docker compose exec iluma php artisan migrate- Start the frontend development server:
docker compose exec iluma npm run dev| Service | URL |
|---|---|
| Application | http://localhost:8088 |
| Mailpit (UI) | http://localhost:8026 |
| Mailpit (SMTP) | localhost:1026 |
| MySQL (host) | localhost:3307 |
Start the environment:
docker compose up -dStart with rebuild:
docker compose up -d --buildStop containers:
docker compose stopTear down the environment:
docker compose downTear down and remove volumes (warning: deletes database data):
docker compose down -vCheck status:
docker compose psView logs:
docker compose logs -fRun Artisan:
docker compose exec iluma php artisan <command>Run migrations:
docker compose exec iluma php artisan migrateRollback migration:
docker compose exec iluma php artisan migrate:rollbackClear cache:
docker compose exec iluma php artisan optimize:clearAccess PHP container shell:
docker compose exec iluma shInstall dependencies:
docker compose exec iluma composer installUpdate dependencies:
docker compose exec iluma composer updateStart development server:
docker compose exec iluma npm run devBuild for production:
docker compose exec iluma npm run buildBuild with SSR:
docker compose exec iluma npm run build:ssrCheck code formatting:
docker compose exec iluma npm run format:checkFormat code:
docker compose exec iluma npm run formatRun linter:
docker compose exec iluma npm run lintRun tests:
docker compose exec iluma php artisan test --compactConfiguration used in .env:
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=iluma
DB_USERNAME=iluma
DB_PASSWORD=ilumaNote: Inside Docker, the database host is
mysql(service name), notlocalhost.
Configuration used in .env:
MAIL_MAILER=smtp
MAIL_HOST=mailpit
MAIL_PORT=1025The inbox can be accessed at http://localhost:8026.
Permission errors on storage or bootstrap/cache:
docker compose exec iluma sh -lc 'chmod -R ug+rw storage bootstrap/cache'Application not reflecting changes:
- Check if containers are running:
docker compose ps - Rebuild:
docker compose up -d --build - Clear Laravel cache:
docker compose exec iluma php artisan optimize:clear
Database connection issues:
- Confirm
.envhasDB_HOST=mysql - Restart services:
docker compose restart mysql iluma