diff --git a/.gitignore b/.gitignore
new file mode 100644
index 000000000..485dee64b
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.idea
diff --git a/Makefile b/Makefile
new file mode 100644
index 000000000..74c4755b9
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,24 @@
+default: up
+
+up:
+	docker-compose up
+
+down:
+	docker-compose down
+
+build:
+	docker-compose down -v --remove-orphans
+	docker-compose rm -vsf
+	docker-compose up -d --build
+
+list:
+	docker ps
+
+lf:
+	docker logs -f fluent-bit-cn
+
+lp:
+	docker logs php-fpm
+
+p:
+	docker-compose exec php sh
diff --git a/README.md b/README.md
index 40b342541..5814f7534 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,30 @@ with [FrankenPHP](https://frankenphp.dev) and [Caddy](https://caddyserver.com/)
 4. Open `https://localhost` in your favorite web browser and [accept the auto-generated TLS certificate](https://stackoverflow.com/a/15076602/1352334)
 5. Run `docker compose down --remove-orphans` to stop the Docker containers.
 
+## Makefile Usage Instructions
+
+This project includes a `Makefile` to simplify common Docker and Docker Compose operations. Below are the available commands and their descriptions.
+
+### Prerequisites
+
+- `make` (usually preinstalled on Linux/macOS; available via package managers on Windows like WSL or Cygwin)
+
+---
+
+### Available Commands
+
+| Command             | Description                                                                                        |
+|---------------------|----------------------------------------------------------------------------------------------------|
+| `make` or `make up` | Start all containers in foreground (with logs).                                                    |
+| `make down`         | Stop and remove all containers, networks, and volumes.                                             |
+| `make build`        | Clean up previous containers and volumes, then rebuild images and start services in detached mode. |
+| `make list`         | List all running Docker containers.                                                                |
+| `make lf`           | Follow logs from the `fluent-bit-cn` container (streaming).                                        |
+| `make lp`           | Show logs from the `php-fpm` container.                                                            |
+| `make p`            | Open a shell inside the running `php` container (useful for debugging, running commands, etc.).    |
+
+---
+
 ## Features
 
 - Production, development and CI ready