feat: migrate hello_world and who_am_i to icp-cli, add Codespaces and CI support

.devcontainer/CODESPACE.md

@@ -0,0 +1,33 @@
+# ICP Codespace
+
+> **Setup in progress:** The ICP local network is starting and canisters are being deployed automatically. Check the terminal panel for status. Access URLs will be printed once deployment is complete.
+
+The network starts and canisters are deployed automatically when this Codespace opens. Access URLs are printed in the terminal once deployment completes.
+
+## Access URLs
+
+`icp deploy` prints URLs using `localhost:8000`, which do not work inside a Codespace. Run the following command to get the correct forwarded URLs:
+
+```bash
+bash /workspaces/examples/.devcontainer/scripts/show-urls.sh
+```
+
+## Deploy / Redeploy
+
+Deploys or redeploys all canisters, preserving their state. This also runs automatically every time the Codespace starts.
+
+```bash
+icp deploy
+```
+
+## Reset & Redeploy
+
+Reinstalls all canisters from scratch, wiping their state. The network keeps running.
+
+```bash
+icp deploy --mode reinstall -y
+```
+
+## Note for non-SPA frontends
+
+Frontend URLs use a `?canisterId=` query parameter for routing. This works correctly for single-page apps (all navigation stays client-side). If your frontend uses real path-based navigation where clicking a link triggers a new browser request (e.g. navigating to `/page2`), the query parameter will be dropped and the gateway will not know which canister to serve. Subdomain-based routing is not available in Codespaces because GitHub's TLS certificate only covers one subdomain level, making `<canisterId>.<codespace>-8000.app.github.dev` invalid.

.devcontainer/devcontainer.json

@@ -0,0 +1,31 @@
+{
+  "name": "ICP Examples (Motoko + Rust)",
+  "image": "ghcr.io/marc0olo/icp-dev-env-all:dev",
+  "workspaceFolder": "/workspaces/examples",
+  "forwardPorts": [8000, 5173],
+  "portsAttributes": {
+    "8000": {
+      "label": "ICP",
+      "onAutoForward": "ignore"
+    },
+    "5173": {
+      "label": "Vite",
+      "onAutoForward": "openBrowser"
+    }
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "dfinity-foundation.vscode-motoko",
+        "rust-lang.rust-analyzer"
+      ],
+      "settings": {
+        "git.openRepositoryInParentFolders": "always",
+        "workbench.startupEditor": "none",
+        "workbench.editorAssociations": {
+          "*.md": "vscode.markdown.preview.editor"
+        }
+      }
+    }
+  }
+}

.devcontainer/motoko-hello-world/devcontainer.json

@@ -0,0 +1,32 @@
+{
+  "name": "Hello World (Motoko)",
+  "image": "ghcr.io/marc0olo/icp-dev-env-motoko:dev",
+  "workspaceFolder": "/workspaces/examples/motoko/hello_world",
+  "forwardPorts": [8000, 5173],
+  "portsAttributes": {
+    "8000": {
+      "label": "ICP",
+      "onAutoForward": "ignore"
+    },
+    "5173": {
+      "label": "Vite",
+      "onAutoForward": "openBrowser"
+    }
+  },
+  "postStartCommand": "bash /workspaces/examples/.devcontainer/scripts/postStart.sh",
+  "postAttachCommand": "bash /workspaces/examples/.devcontainer/scripts/postAttach.sh",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "dfinity-foundation.vscode-motoko"
+      ],
+      "settings": {
+        "git.openRepositoryInParentFolders": "always",
+        "workbench.startupEditor": "none",
+        "workbench.editorAssociations": {
+          "*.md": "vscode.markdown.preview.editor"
+        }
+      }
+    }
+  }
+}

.devcontainer/motoko-who-am-i/devcontainer.json

@@ -0,0 +1,32 @@
+{
+  "name": "Who Am I? (Motoko)",
+  "image": "ghcr.io/marc0olo/icp-dev-env-motoko:dev",
+  "workspaceFolder": "/workspaces/examples/motoko/who_am_i",
+  "forwardPorts": [8000, 5173],
+  "portsAttributes": {
+    "8000": {
+      "label": "ICP",
+      "onAutoForward": "ignore"
+    },
+    "5173": {
+      "label": "Vite",
+      "onAutoForward": "openBrowser"
+    }
+  },
+  "postStartCommand": "bash /workspaces/examples/.devcontainer/scripts/postStart.sh",
+  "postAttachCommand": "bash /workspaces/examples/.devcontainer/scripts/postAttach.sh",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "dfinity-foundation.vscode-motoko"
+      ],
+      "settings": {
+        "git.openRepositoryInParentFolders": "always",
+        "workbench.startupEditor": "none",
+        "workbench.editorAssociations": {
+          "*.md": "vscode.markdown.preview.editor"
+        }
+      }
+    }
+  }
+}

.devcontainer/rust-hello-world/devcontainer.json

@@ -0,0 +1,32 @@
+{
+  "name": "Hello World (Rust)",
+  "image": "ghcr.io/marc0olo/icp-dev-env-rust:dev",
+  "workspaceFolder": "/workspaces/examples/rust/hello_world",
+  "forwardPorts": [8000, 5173],
+  "portsAttributes": {
+    "8000": {
+      "label": "ICP",
+      "onAutoForward": "ignore"
+    },
+    "5173": {
+      "label": "Vite",
+      "onAutoForward": "openBrowser"
+    }
+  },
+  "postStartCommand": "bash /workspaces/examples/.devcontainer/scripts/postStart.sh",
+  "postAttachCommand": "bash /workspaces/examples/.devcontainer/scripts/postAttach.sh",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "rust-lang.rust-analyzer"
+      ],
+      "settings": {
+        "git.openRepositoryInParentFolders": "always",
+        "workbench.startupEditor": "none",
+        "workbench.editorAssociations": {
+          "*.md": "vscode.markdown.preview.editor"
+        }
+      }
+    }
+  }
+}

.devcontainer/rust-who-am-i/devcontainer.json

@@ -0,0 +1,32 @@
+{
+  "name": "Who Am I? (Rust)",
+  "image": "ghcr.io/marc0olo/icp-dev-env-rust:dev",
+  "workspaceFolder": "/workspaces/examples/rust/who_am_i",
+  "forwardPorts": [8000, 5173],
+  "portsAttributes": {
+    "8000": {
+      "label": "ICP",
+      "onAutoForward": "ignore"
+    },
+    "5173": {
+      "label": "Vite",
+      "onAutoForward": "openBrowser"
+    }
+  },
+  "postStartCommand": "bash /workspaces/examples/.devcontainer/scripts/postStart.sh",
+  "postAttachCommand": "bash /workspaces/examples/.devcontainer/scripts/postAttach.sh",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "rust-lang.rust-analyzer"
+      ],
+      "settings": {
+        "git.openRepositoryInParentFolders": "always",
+        "workbench.startupEditor": "none",
+        "workbench.editorAssociations": {
+          "*.md": "vscode.markdown.preview.editor"
+        }
+      }
+    }
+  }
+}

.devcontainer/scripts/postAttach.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+set -e
+
+code CODESPACE.md
+
+echo "Deploying canisters..."
+icp deploy
+echo ""
+echo "Access URLs:"
+echo ""
+bash /workspaces/examples/.devcontainer/scripts/show-urls.sh

.devcontainer/scripts/postStart.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+set -e
+
+# In GitHub Codespaces, inject the forwarded domain into icp.yaml so the
+# HTTP gateway accepts requests with that Host header.
+if [ -n "$CODESPACE_NAME" ]; then
+  DOMAIN="${CODESPACE_NAME}-8000.app.github.dev"
+  DEV_DOMAIN="${CODESPACE_NAME}-5173.app.github.dev"
+  node -e "
+    const fs = require('fs');
+    const content = fs.readFileSync('icp.yaml', 'utf8');
+    if (!content.includes('gateway:')) {
+      const gateway = '    gateway:\n      domains:\n        - localhost\n        - ${DOMAIN}\n        - ${DEV_DOMAIN}\n';
+      let updated;
+      if (content.includes('    ii: true\n')) {
+        updated = content.replace('    ii: true\n', '    ii: true\n' + gateway);
+      } else if (content.includes('    mode: managed\n')) {
+        updated = content.replace('    mode: managed\n', '    mode: managed\n' + gateway);
+      } else {
+        updated = content.trimEnd() + '\nnetworks:\n  - name: local\n    mode: managed\n' + gateway;
+      }
+      fs.writeFileSync('icp.yaml', updated);
+    }
+  "
+fi
+
+icp network start -d

.devcontainer/scripts/show-urls.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+
+CANISTER_JSON=$(icp canister status --json 2>/dev/null)
+NETWORK_JSON=$(icp network status --json 2>/dev/null)
+CANDID_UI_ID=$(echo "$NETWORK_JSON" | jq -r '.candid_ui_principal // ""')
+
+if [ -n "$CODESPACE_NAME" ]; then
+  BASE="https://${CODESPACE_NAME}-8000.app.github.dev"
+else
+  BASE="http://localhost:8000"
+fi
+
+FRONTEND_NAMES=$(icp project show 2>/dev/null | node -e '
+  let data = "";
+  process.stdin.on("data", c => data += c);
+  process.stdin.on("end", () => {
+    const lines = data.split("\n");
+    const frontends = [];
+    let inCanisters = false, currentCanister = null;
+    for (const line of lines) {
+      if (/^\S/.test(line)) {
+        inCanisters = (line === "canisters:");
+        currentCanister = null;
+        continue;
+      }
+      if (!inCanisters) continue;
+      const m = line.match(/^  ([a-z][a-z0-9_-]*):\s*$/);
+      if (m) { currentCanister = m[1]; continue; }
+      if (currentCanister && !frontends.includes(currentCanister)) {
+        if (line.includes("asset-canister") || /^\s+type:\s+assets\s*$/.test(line)) {
+          frontends.push(currentCanister);
+        }
+      }
+    }
+    process.stdout.write(frontends.join("\n") + (frontends.length ? "\n" : ""));
+  });
+')
+
+echo "$CANISTER_JSON" | while IFS= read -r entry; do
+  ID=$(echo "$entry" | jq -r '.id')
+  NAME=$(echo "$entry" | jq -r '.name')
+  if echo "$FRONTEND_NAMES" | grep -qx "$NAME"; then
+    echo "  $NAME:  ${BASE}/?canisterId=${ID}"
+  elif [ -n "$CANDID_UI_ID" ]; then
+    echo "  $NAME (Candid UI):  ${BASE}/?canisterId=${CANDID_UI_ID}&id=${ID}"
+  fi
+done

.github/CONTRIBUTING.md

@@ -1,7 +1,5 @@
 # Contributing
 
-> For ICP Ninja: check [NINJA_CONTRIBUTING.md](./../NINJA_CONTRIBUTING.md) for how to contribute a project to ICP Ninja.
-
 Thank you for your interest in contributing to example apps for the Internet Computer.
 By participating in this project, you agree to abide by our [Code of Conduct](./CODE_OF_CONDUCT.md).
 
@@ -116,4 +114,4 @@ To open a new issue:
 
 ### Submitting your own example
 
-We're not accepting community examples at this time -- we have something better planned.
+See [ADDING_AN_EXAMPLE.md](./../ADDING_AN_EXAMPLE.md) for guidelines on how to structure and submit a new example.

.github/workflow-template.yml

@@ -0,0 +1,35 @@
+# Workflow template for ICP examples.
+# Copy this file to .github/workflows/<example_name>.yml and replace the placeholders.
+#
+# PLACEHOLDERS:
+#   <example_name>   e.g. hello_world
+#   <language>       motoko | rust
+#   <image>          ghcr.io/dfinity/icp-dev-env-motoko | ghcr.io/dfinity/icp-dev-env-rust
+
+name: <example_name>
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    paths:
+      - <language>/<example_name>/**
+      - .github/workflows/<example_name>.yml
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  <language>-<example_name>:
+    runs-on: ubuntu-24.04
+    container: <image>
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+      - name: Deploy and test
+        working-directory: <language>/<example_name>
+        run: |
+          icp network start -d
+          icp deploy
+          make test

.github/workflows/hello_world.yml

@@ -0,0 +1,40 @@
+name: hello_world
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    paths:
+      - motoko/hello_world/**
+      - rust/hello_world/**
+      - .github/workflows/hello_world.yml
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  motoko-hello_world:
+    runs-on: ubuntu-24.04
+    container: ghcr.io/marc0olo/icp-dev-env-motoko:dev
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+      - name: Deploy and test
+        working-directory: motoko/hello_world
+        run: |
+          icp network start -d
+          icp deploy
+          make test
+
+  rust-hello_world:
+    runs-on: ubuntu-24.04
+    container: ghcr.io/marc0olo/icp-dev-env-rust:dev
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+      - name: Deploy and test
+        working-directory: rust/hello_world
+        run: |
+          icp network start -d
+          icp deploy
+          make test