From 8c194afc2ecda6b01bcc9380ca23dc1862ea9f19 Mon Sep 17 00:00:00 2001
From: brymut <mutaiwork@gmail.com>
Date: Mon, 23 Jun 2025 20:37:12 +0300
Subject: [PATCH] add devcontainer config for codespaces

---
 .devcontainer/devcontainer.json         | 21 +++++++++++++++++++++
 .devcontainer/minimal/devcontainer.json | 22 ++++++++++++++++++++++
 README.md                               | 17 +++++++++++++++++
 sndev                                   | 10 +++++++++-
 4 files changed, 69 insertions(+), 1 deletion(-)
 create mode 100644 .devcontainer/devcontainer.json
 create mode 100644 .devcontainer/minimal/devcontainer.json

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 000000000..dfdd2bf88
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,21 @@
+{
+  "name": "sndev",
+  "hostRequirements": {
+    "cpus": 4,
+    "memory": "16gb",
+    "storage": "32gb"
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-azuretools.vscode-containers"
+      ]
+    }
+  },
+  "containerEnv": {
+    "CPU_SHARES_IMPORTANT": "1024",
+    "CPU_SHARES_MODERATE": "512",
+    "CPU_SHARES_LOW": "128"
+  },
+  "postAttachCommand": "./sndev start"
+}
diff --git a/.devcontainer/minimal/devcontainer.json b/.devcontainer/minimal/devcontainer.json
new file mode 100644
index 000000000..8681d6fea
--- /dev/null
+++ b/.devcontainer/minimal/devcontainer.json
@@ -0,0 +1,22 @@
+{
+  "name": "sndev MINIMAL",
+  "hostRequirements": {
+    "cpus": 4,
+    "memory": "16gb",
+    "storage": "32gb"
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-azuretools.vscode-containers"
+      ]
+    }
+  },
+  "containerEnv": {
+    "CPU_SHARES_IMPORTANT": "1024",
+    "CPU_SHARES_MODERATE": "512",
+    "CPU_SHARES_LOW": "128",
+    "COMPOSE_PROFILES": "minimal"
+  },
+  "postAttachCommand": "./sndev start"
+}
diff --git a/README.md b/README.md
index 6ba466410..c2143df03 100644
--- a/README.md
+++ b/README.md
@@ -167,6 +167,22 @@ To add/remove DNS records you can now use `./sndev domains dns`. More on this [h
 
 <br>
 
+## GitHub Codespaces
+
+<a href='https://codespaces.new/stackernews/stacker.news/tree/master'><img src='https://github.com/codespaces/badge.svg' alt='Open in GitHub Codespaces' style='max-width: 100%;'></a>
+
+You can also develop Stacker News in GitHub Codespaces.
+
+1.  **Open in Codespaces**: On the GitHub repository page, either click on the "Open in Github Codespaces" Badge or click on `Code` -> `Codespaces` in the Github UI and select the branch you would like to run the `DEFAULT` sndev Dev container configuration on.
+2.  **Wait for Setup**: The Codespace will automatically build the dev container and run the `./sndev start` command. This will take a several minutes before the services are ready
+4.  **Accessing Services**:
+    *   Web application (app): The `app` service runs on port 3000. GitHub Codespaces should automatically forward this port. You can open it from the "Ports" tab in VS Code.
+    *   Other services (database, MailHog, lnbits, etc.): will also be accessible in the ports tab, through their configured ports.
+5.  **Minimal Profile for Faster Startup**: For a quicker start and less resource usage in Codespaces is available as a separate `MINIMAL` Dev container configuration, that can be selected in step 1.
+6.  **Using `sndev`**: All other `sndev` commands (`./sndev logs <service>`, `./sndev psql`, `./sndev login <nym>`, etc.) should work as described in this README.
+
+<br/>
+
 # Table of Contents
 - [Getting started](#getting-started)
     - [Installation](#installation)
@@ -174,6 +190,7 @@ To add/remove DNS records you can now use `./sndev domains dns`. More on this [h
         - [Modifying services](#modifying-services)
             - [Running specific services](#running-specific-services)
             - [Merging compose files](#merging-compose-files)
+    - [Github Codespaces](#Github-Codespaces)
 - [Contributing](#contributing)
     - [We pay bitcoin for contributions](#we-pay-bitcoin-for-contributions)
     - [Pull request awards](#pull-request-awards)
diff --git a/sndev b/sndev
index fa38b2a24..83a218aef 100755
--- a/sndev
+++ b/sndev
@@ -481,6 +481,14 @@ sndev__login() {
   salt="202c90943c313b829e65e3f29164fb5dd7ea3370d7262c4159691c2f6493bb8b"
   # upsert user with nym and nym@sndev.team
   email="$1@sndev.team"
+
+  # Detect Codespaces and set the correct base URL
+  if [ -n "$CODESPACE_NAME" ]; then
+    BASE_URL="https://${CODESPACE_NAME}-3000.app.github.dev"
+  else
+    BASE_URL="http://localhost:3000"
+  fi
+
   docker__exec db psql -U sn -d stackernews -q <<EOF
     INSERT INTO users (name) VALUES ('$1') ON CONFLICT DO NOTHING;
     UPDATE users SET email = '$email', "emailHash" = encode(digest(LOWER('$email')||'$salt', 'sha256'), 'hex') WHERE name = '$1';
@@ -492,7 +500,7 @@ EOF
 
   echo
   echo "open url in browser"
-  echo "http://localhost:3000/api/auth/callback/email?token=SNDEV-TOKEN&email=$1%40sndev.team"
+  echo "$BASE_URL/api/auth/callback/email?token=SNDEV-TOKEN&email=$1%40sndev.team"
   echo
 }