From 6ba8e05afac894d6219a5e557b3f6afbdec5be64 Mon Sep 17 00:00:00 2001
From: Reppad <reppad@users.noreply.github.com>
Date: Wed, 11 Oct 2023 23:33:52 +0200
Subject: [PATCH] Codespace setup

---
 .devcontainer/devcontainer.json | 42 +++++++++++++++++++++++++++++++++
 README.md                       |  8 +++++++
 2 files changed, 50 insertions(+)
 create mode 100644 .devcontainer/devcontainer.json

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 0000000..04a7528
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,42 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/docker-existing-dockerfile
+{
+	"name": "Archlinux Dockerfile",
+	"build": {
+		// Sets the run context to one level up instead of the .devcontainer folder.
+		"context": "..",
+		// Update the 'dockerFile' property if you aren't using the standard 'Dockerfile' filename.
+		"dockerfile": "../Dockerfile"
+	},
+	"customizations": {
+		"vscode": {
+			"settings": {
+				"terminal.integrated.scrollback": 10000,
+				"git.allowForcePush": true,
+				"editor.minimap.enabled": false
+			}/*,
+			// Here are a few extensions suggestions for more serious development in this Codespace
+			"extensions": [
+				"eamodio.gitlens",
+				"ms-vscode.makefile-tools",
+				"ms-vscode.cpptools",
+				"ms-vscode.cpptools-themes"
+			]*/
+		}
+	}
+
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	// "features": {},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Uncomment the next line to run commands after the container is created.
+	// "postCreateCommand": "cat /etc/os-release",
+
+	// Configure tool-specific properties.
+	// "customizations": {},
+
+	// Uncomment to connect as an existing user other than the container default. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "devcontainer"
+}
diff --git a/README.md b/README.md
index e04acf0..192cb07 100644
--- a/README.md
+++ b/README.md
@@ -148,6 +148,14 @@ You may need to edit the bat file (path to make.exe) depending on where you inst
 
 I've left some notes in the win_make.bat file to maybe help with stuff.
 
+## Building from browser
+
+To build the firmware without installing any software you can run a full featured IDE and compiler in your browser using GitHub Codespace.
+The environment is build using the Archlinux Dockerfile provided in the project.
+
+You just need to clic on the green button `<> Code` -> `Codespace` -> `Create Codespace on ...`  
+After the Codespace is initialized, you can open and edit any file and build the firmware typing `make` in the terminal panel.
+
 # Credits
 
 Many thanks to various people on Telegram for putting up with me during this effort and helping: