Laravel Boilerplate

Note

It must:

• be on the latest version of Laravel
• be lightweight to run with Podman
• use modern technologies such as PHP 8.4, Go 1.24, Python 3.13, etc.

Requirements

• podman
• just, bun, dockerfmt, dprint

Statuses

Usage

# Pull newer images
just pull

# Build dev image
just build

# Copy Laravel environment variables file
cp --update=none dev-frontend.env apps/frontend/.env

# Up containers
just up

# Install dependencies, generate key, run migrations
just install

# Show logs
just logs

# Run queue worker
just queue

# Enter the apps container
just console

# Down containers
just down

Commands

Install asset deps:

just bun-install

Build assets:

just bun-dev
just bun-prod

Update locales:

just lang-update

Apply fixes by phpcs and check code by Larastan:

just check-code

Other useful commands:

just check-security
just lint
just fmt

How to update components

• In compose.yml check new versions of images
• In Containerfile check new version of php image
  • Check a new version of php-zmq, phpredis
  • Check a new version of Caddy
• In the apps container run composer update / composer outdated to check new versions
• Update frontend libraries: just update-frontend

Misc

• Access http://localhost/?SPX_KEY=dev&SPX_UI_URI=/ to enable PHP-SPX and see the profiling results;
• Use dive to analyze Podman images;
• Use grype to check security vulnerabilities.