dfinity
diff --git a/‎.devcontainer/devcontainer.json‎
Lines changed: 30 additions & 0 deletions b/‎.devcontainer/devcontainer.json‎
Lines changed: 30 additions & 0 deletions
diff --git a/‎.github/CONTRIBUTING.md‎
Lines changed: 1 addition & 3 deletions b/‎.github/CONTRIBUTING.md‎
Lines changed: 1 addition & 3 deletions
diff --git a/‎.github/workflow-template.yml‎
Lines changed: 35 additions & 0 deletions b/‎.github/workflow-template.yml‎
Lines changed: 35 additions & 0 deletions
diff --git a/‎.github/workflows/hello_world.yml‎
Lines changed: 40 additions & 0 deletions b/‎.github/workflows/hello_world.yml‎
Lines changed: 40 additions & 0 deletions
diff --git a/‎.github/workflows/ninja_pr_checks.yml‎
Lines changed: 44 additions & 4 deletions b/‎.github/workflows/ninja_pr_checks.yml‎
Lines changed: 44 additions & 4 deletions
diff --git a/‎.github/workflows/who_am_i.yml‎
Lines changed: 40 additions & 0 deletions b/‎.github/workflows/who_am_i.yml‎
Lines changed: 40 additions & 0 deletions
diff --git a/‎ADDING_AN_EXAMPLE.md‎
Lines changed: 28 additions & 19 deletions b/‎ADDING_AN_EXAMPLE.md‎
Lines changed: 28 additions & 19 deletions
@@ -0,0 +1,30 @@
+{
+  "name": "ICP Examples (Motoko + Rust)",
+  "image": "ghcr.io/dfinity/icp-dev-env-all:0.1.0",
+  "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"
+        }
+      }
+    }
+  }
+}
@@ -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.
@@ -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
@@ -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/dfinity/icp-dev-env-motoko:0.1.0
+    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/dfinity/icp-dev-env-rust:0.1.0
+    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
@@ -4,6 +4,50 @@ on:
   pull_request:
     branches:
       - master
+    paths:
+      - 'hosting/**'
+      - 'motoko/backend_only/**'
+      - 'motoko/canister_logs/**'
+      - 'motoko/classes/**'
+      - 'motoko/basic_bitcoin/**'
+      - 'motoko/daily_planner/**'
+      - 'motoko/evm_block_explorer/**'
+      - 'motoko/filevault/**'
+      - 'motoko/flying_ninja/**'
+      - 'motoko/llm_chatbot/**'
+      - 'motoko/query_stats/**'
+      - 'motoko/send_http_get/**'
+      - 'motoko/send_http_post/**'
+      - 'motoko/superheroes/**'
+      - 'motoko/threshold-ecdsa/**'
+      - 'motoko/threshold-schnorr/**'
+      - 'rust/backend_only/**'
+      - 'rust/backend_wasm64/**'
+      - 'rust/basic_bitcoin/**'
+      - 'rust/canister-info/**'
+      - 'rust/canister_logs/**'
+      - 'rust/basic_ethereum/**'
+      - 'rust/candid_type_generation/**'
+      - 'rust/daily_planner/**'
+      - 'rust/evm_block_explorer/**'
+      - 'rust/flying_ninja/**'
+      - 'rust/guards/**'
+      - 'rust/llm_chatbot/**'
+      - 'rust/performance_counters/**'
+      - 'rust/periodic_tasks/**'
+      - 'rust/qrcode/**'
+      - 'rust/query_stats/**'
+      - 'rust/send_http_get/**'
+      - 'rust/send_http_post/**'
+      - 'rust/simd/**'
+      - 'rust/threshold-ecdsa/**'
+      - 'rust/unit_testable_rust_canister/**'
+      - 'rust/photo_gallery/**'
+      - 'rust/inter-canister-calls/**'
+      - 'rust/x509/**'
+      - 'rust/receiving-icp/**'
+      - 'rust/exchange-rates/**'
+      - '.github/workflows/ninja_pr_checks.yml'
 
 concurrency:
   group: ninja-pr-checks-${{ github.workflow }}-${{ github.ref }}
@@ -41,15 +85,13 @@ jobs:
             ["EVM Block Explorer (Motoko)"]="motoko/evm_block_explorer"
             ["FileVault (Motoko)"]="motoko/filevault"
             ["Flying Ninja (Motoko)"]="motoko/flying_ninja"
-            ["Hello World (Motoko)"]="motoko/hello_world"
             ["LLM Chatbot (Motoko)"]="motoko/llm_chatbot"
             ["Query Stats (Motoko)"]="motoko/query_stats"
             ["Send HTTP Get (Motoko)"]="motoko/send_http_get"
             ["Send HTTP Post (Motoko)"]="motoko/send_http_post"
             ["Superheroes (Motoko)"]="motoko/superheroes"
             ["Threshold ECDSA (Motoko)"]="motoko/threshold-ecdsa"
             ["Threshold Schnorr (Motoko)"]="motoko/threshold-schnorr"
-            ["Who Am I (Motoko)"]="motoko/who_am_i"
             ["Rust backend (Rust)"]="rust/backend_only"
             ["Rust backend Wasm64 (Rust)"]="rust/backend_wasm64"
             ["Basic Bitcoin (Rust)"]="rust/basic_bitcoin"
@@ -61,7 +103,6 @@ jobs:
             ["EVM Block Explorer (Rust)"]="rust/evm_block_explorer"
             ["Flying Ninja (Rust)"]="rust/flying_ninja"
             ["Guards (Rust)"]="rust/guards"
-            ["Hello World (Rust)"]="rust/hello_world"
             ["LLM Chatbot (Rust)"]="rust/llm_chatbot"
             ["Performance Counters (Rust)"]="rust/performance_counters"
             ["Periodic Tasks (Rust)"]="rust/periodic_tasks"
@@ -72,7 +113,6 @@ jobs:
             ["SIMD (Rust)"]="rust/simd"
             ["Threshold ECDSA (Rust)"]="rust/threshold-ecdsa"
             ["Unit Testable Canister (Rust)"]="rust/unit_testable_rust_canister"
-            ["Who Am I (Rust)"]="rust/who_am_i"
             ["Photo Gallery (Rust)"]="rust/photo_gallery"
             ["Inter-canister calls (Rust)"]="rust/inter-canister-calls"
             ["X.509 (Rust)"]="rust/x509"
 
@@ -0,0 +1,40 @@
+name: who_am_i
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    paths:
+      - motoko/who_am_i/**
+      - rust/who_am_i/**
+      - .github/workflows/who_am_i.yml
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  motoko-who_am_i:
+    runs-on: ubuntu-24.04
+    container: ghcr.io/dfinity/icp-dev-env-motoko:0.1.0
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+      - name: Deploy and test
+        working-directory: motoko/who_am_i
+        run: |
+          icp network start -d
+          icp deploy
+          make test
+
+  rust-who_am_i:
+    runs-on: ubuntu-24.04
+    container: ghcr.io/dfinity/icp-dev-env-rust:0.1.0
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+      - name: Deploy and test
+        working-directory: rust/who_am_i
+        run: |
+          icp network start -d
+          icp deploy
+          make test
@@ -1,40 +1,49 @@
 # How to add a new example
 
-> For ICP Ninja: check [NINJA_CONTRIBUTING.md](./NINJA_CONTRIBUTING.md) for how to contribute a project to ICP Ninja.
+## Purpose and acceptance criteria
+
+Examples in this repository have an **educational focus**. Each example is intended to demonstrate a specific ICP capability or pattern, and should be suitable for reference from the [ICP developer documentation](https://docs.internetcomputer.org).
+
+**We do not accept general-purpose or arbitrary examples.** Before opening a PR, confirm that:
+
+- The example demonstrates a distinct ICP concept not already covered by an existing example.
+- There is a clear home for it in the developer documentation (an existing or planned guide, tutorial, or reference page).
+- The DFINITY DX team has agreed to maintain it long-term.
+
+If you are unsure whether your example fits, open an issue first to discuss it with the maintainers before investing time in an implementation.
+
+---
 
 Each example should be available in both Rust and Motoko variations, implementing the same Candid interface (and, ideally, semantics).
 
-To illustrate the pattern, this repo now contains one such example, project `hello_world`:
+To illustrate the pattern, this repo contains one such example, project `hello_world`:
 
-`motoko/hello_world`
-`rust/hello_world`
+```
+motoko/hello_world
+rust/hello_world
+```
 
-When adding a new `dfx` generated project, make sure to delete its GitHub metadata files (`.gitignore`, `.git` etc).
+When adding a new project, make sure to delete any generated GitHub metadata files (`.gitignore`, `.git` etc).
 
 Each project should include a language-specific README.md that also links to the corresponding README.md of its counterpart in another language, making it easy for language-curious readers to explore both implementations.
 
 ## CI
 
-Apart from the standard `dfx` material, each project should provide a `Makefile` used by GitHub Actions CI to run (very) basic tests.
+Each project should provide a `Makefile` with a `test` target that runs basic canister tests using `icp canister call`. Each example also needs a GitHub Actions workflow file at `.github/workflows/<example_name>.yml`.
 
-For each example, there is a single CI file with four build actions to produce Darwin and Linux builds and tests of the Motoko/Rust, projects, such as:
+Use the workflow template as a starting point:
 
 ```
-.github/workflows/hello_world.yml
+.github/workflow-template.yml
 ```
 
-Implementing the GitHub action will ensure it runs in CI and helps keep examples in sync with releases of `dfx`.
-
-## Documentation
+Copy it, replace the placeholders, and add the appropriate container image:
 
-For your new example to be included in the ICP developer documentation, make sure you update the `samples` submodule in the portal repository to point to the latest commit in this examples repository using the following command:
-
-```bash
-git submodule update --remote submodules/samples
-```
+- Motoko: `ghcr.io/dfinity/icp-dev-env-motoko`
+- Rust: `ghcr.io/dfinity/icp-dev-env-rust`
 
-After you run this command, commit the changes to a new PR to have them merged into the portal repo. 
+See `hello_world` and `who_am_i` for reference implementations. Workflows run on Linux only using container images — no provision scripts needed.
 
-## Issues
+## Notes
 
-While this structure leads to some duplication (especially shared components like frontend code) it ensures that Motoko users can focus solely on Motoko-specific content, and likewise for Rust users. It also enables easily finding language-specific examples when a given use case is not easily supported in the other language.
+While this structure leads to some duplication (especially shared frontend code) it ensures that Motoko users can focus solely on Motoko-specific content, and likewise for Rust users. It also enables easily finding language-specific examples when a given use case is not easily supported in the other language.