README

Loom Spinner is a streamlined environment management tool for PHP developers.

It makes launching minimal, pre-configured Docker containers effortless, providing a fast, consistent, and hassle-free workflow for your projects.

Run simple commands from anywhere on your system to manage your environments.

This project is built for Linux and has not been fully tested on Windows or MacOS. Full Windows/MacOS support is planned for a future release.

At a Glance

Effortlessly create custom Docker environments for each of your PHP projects. A default Loom Spinner environment provides:

Your project directory is automatically mounted into the PHP container, and the public directory is served via Nginx at:

https://{project-name}.app

You can access the container directly from your terminal to run tests or other commands in an isolated environment.

Requirements:

To install globally, run:

composer global require cloudbase/loom-spinner

Optional HTTPS/SSL Support

For prettified https://{project-name}.app URLs, install mkcert before using Loom Spinner.

Linux example:

sudo apt install mkcert libnss3-tools
mkcert -install

Spin up your project and add the hosts entry in a single sequence:

cd /path/to/my-project
loom spin:up my-project .
sudo loom env:hosts:add my-project

✅ This will create the Docker containers (PHP, Nginx, MySQL) and ensure your system can resolve http://my-project.app for clean URLs.

Launch a new environment:

loom spin:up my-project /path/to/my-project

Or from the project directory:

cd /path/to/my-project
loom spin:up my-project .

To access your project via the browser, add an entry to /etc/hosts:

sudo loom env:hosts:add my-project

Your default database credentials are:

Username	Password
root	docker

To see which port your database container is using, run:

loom env:list

You can customise your credentials, see the Configuration section of the documentation for more details.

Happy spinning! 🧵