+ This is Placed on the rigth side of the header as a slot
+
+```
+## ⚙️ Development
+### 🛠️ Setup
-The folder structure of a theme is exactly the same as the main structure. CSS files are loaded additionally to the default files so you can override properties. Images are replaced. You can also override JS files and PHP templates but we do not recommend that because you will need to adjust them after every update.
+#### 📦 Podman Dev Container
-You can also find a basic example here which you can build upon.
+Uses containerized Node environment
+
+simply run `make run-dev` to start a container, install dependencies and start the dev server.
+
+#### 🖥️ Without Container
+
+Make sure Node v20 is installed
+
+1. run `npm install` to install dependencies
+2. run `npm run dev` to start dev server
+
+### 🚀 Build
+#### 💻 local
+
+##### 📦 Container
+
+```shell
+make run-build
+```
+
+##### 🖥️ or without Container
+
+```shell
+npm run build
+```
+
+### 📏 Conventions
+
+The repository uses [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) for commit messages.
+
+Example:
+
+`