diff --git a/README.md b/README.md
index 029719d..5e66054 100644
--- a/README.md
+++ b/README.md
@@ -56,4 +56,30 @@
     - 11: (reserved)
 - client responds with empty message to request the next frame
 
+# Building
 
+```bash
+# checkout repo and submodules
+git clone https://github.com/kaesaecracker/servicepoint-tanks.git
+cd servicepoint-tanks
+git submodule update --init
+cd tanks-backend/servicepoint
+git submodule update --init
+cd ../..
+
+# build with nix-shell
+nix-shell
+cd tank-frontent
+npm install
+npm run build
+cd ../tanks-backend
+dotnet build
+
+# build with docker/podman
+cd tanks-backend
+docker build .
+cd ../tank-frontend
+docker build .
+cd ..
+docker build .
+```
diff --git a/shell.nix b/shell.nix
index e453fac..3cd7d81 100644
--- a/shell.nix
+++ b/shell.nix
@@ -1,8 +1,16 @@
-{pkgs ? import <nixpkgs> {}}:
+{
+  pkgs ? import <nixpkgs> { },
+}:
 let
-rust-toolchain = pkgs.symlinkJoin {
+  rust-toolchain = pkgs.symlinkJoin {
     name = "rust-toolchain";
-    paths = with pkgs; [rustc cargo rustPlatform.rustcSrc rustfmt clippy];
+    paths = with pkgs; [
+      rustc
+      cargo
+      rustPlatform.rustcSrc
+      rustfmt
+      clippy
+    ];
   };
 in
 pkgs.mkShell {
@@ -16,6 +24,9 @@ pkgs.mkShell {
     gnumake
     iconv
 
+    typescript
+    nodejs
+
     dotnet-sdk_8
   ];