From e4ad310796ae1f989ed4fe0bdf93f24971d93b54 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Thu, 18 Jun 2026 18:43:24 +0000
Subject: [PATCH] docs: Add Coolify deployment instructions to README

Added documentation describing the deployment process using Coolify to the README.md file.

Co-authored-by: reprewindai-dev <252009447+reprewindai-dev@users.noreply.github.com>
---
 DEPLOYMENT.md | 20 ++++++++++++++++++++
 README.md     | 13 +++++++++++++
 2 files changed, 33 insertions(+)
 create mode 100644 DEPLOYMENT.md

diff --git a/DEPLOYMENT.md b/DEPLOYMENT.md
new file mode 100644
index 0000000..1294c02
--- /dev/null
+++ b/DEPLOYMENT.md
@@ -0,0 +1,20 @@
+# Deploying to Coolify on Hetzner
+
+This project is fully ready to be deployed to a Coolify instance (e.g., hosted on Hetzner) using the provided `Dockerfile` or Nixpacks.
+
+## Option 1: Docker (Recommended)
+Coolify can automatically detect the `Dockerfile` at the root of the repository.
+
+1. Connect your repository to your Coolify instance.
+2. Create a new Resource in Coolify and select **Project / Application**.
+3. Choose the repository and branch.
+4. Coolify will auto-detect the configuration. Under the **Build Pack** setting, select **Docker** (it might already be selected).
+5. Ensure the **Port** is set to `3000`.
+6. Deploy! The `Dockerfile` uses Next.js Standalone mode for a highly optimized, lightweight Node.js production image.
+
+## Option 2: Nixpacks
+If you prefer not to use the Dockerfile, Coolify uses Nixpacks by default which works seamlessly with Next.js.
+1. When setting up the Application in Coolify, select **Nixpacks** as the build pack.
+2. Coolify will automatically detect it as a Next.js application, install dependencies, run `npm run build`, and start it.
+
+*(Note: If you use Nixpacks, you might need to remove `output: "standalone"` from `next.config.mjs` depending on your preference, but it generally works fine either way).*
diff --git a/README.md b/README.md
index d9b9127..ac71572 100644
--- a/README.md
+++ b/README.md
@@ -78,3 +78,16 @@ The runtime seeds a realistic fleet (agents, capabilities, three-tier policies,
 ## Stack
 
 Next.js 14 (App Router) · TypeScript · Tailwind CSS · Framer Motion · Node `crypto`. Part of the **Veklom** ecosystem.
+
+## Deployment
+
+This project is fully ready to be deployed to a **Coolify** instance (e.g., hosted on Hetzner) using the provided `Dockerfile` or Nixpacks.
+
+### Deploying to Coolify
+
+1. Connect your repository to your Coolify instance.
+2. Create a new Resource in Coolify and select **Project / Application**.
+3. Choose the repository and branch.
+4. Coolify will auto-detect the configuration. Under the **Build Pack** setting, select **Docker** (it should automatically pick up the `Dockerfile` at the root).
+5. Ensure the **Port** is set to `3000`.
+6. Deploy! The `Dockerfile` uses Next.js Standalone mode for a highly optimized, lightweight Node.js production image.