Add admin tools data template

admin-tools/README.md.liquid

@@ -0,0 +1,32 @@
+# {{ name }}
+
+{{ description }}
+
+---
+
+## Get started with this extension
+
+This extension provides search functionality for the Shopify Admin. After installation, your app's search results will appear in Admin search.
+
+### Key files
+
+- `src/index.{{ srcFileExtension }}` - Main extension code that registers the search tool
+- `tools.json` - Schema definition for the search tool inputs and outputs
+
+### How it works
+
+1. The extension registers a `search` tool using `shopify.tools.register()`
+2. When a user searches in the Admin, your search function is called with the query
+3. Your function returns results matching the schema defined in `tools.json`
+
+### Customizing the search
+
+Edit `src/index.{{ srcFileExtension }}` to implement your search logic:
+
+1. Fetch data from your app's backend or API
+2. Filter/search the data based on the `query` input
+3. Return results in the expected format with pagination info
+
+### Testing locally
+
+Run `shopify app dev` to test your extension in development mode.

admin-tools/locales/en.default.json.liquid

@@ -0,0 +1,4 @@
+{
+  "name": "{{ name }}",
+  "description": "Search extension for your app"
+}

admin-tools/locales/fr.json.liquid

@@ -0,0 +1,4 @@
+{
+  "name": "{{ name }}",
+  "description": "Extension de recherche pour votre application"
+}

admin-tools/package.json.liquid

@@ -0,0 +1,9 @@
+{
+  "name": "{{ handle }}",
+  "private": true,
+  "version": "1.0.0",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "@shopify/ui-extensions": "0.0.0-snapshot-20260114193753"
+  }
+}

admin-tools/shopify.extension.toml.liquid

@@ -0,0 +1,14 @@
+api_version = "2025-10"
+
+[[extensions]]
+# Change the merchant-facing name of the extension in locales/en.default.json
+name = "t:name"
+handle = "{{ handle }}"
+type = "ui_extension"
+{% if uid %}uid = "{{ uid }}"{% endif %}
+description = "t:description"
+
+[[extensions.targeting]]
+module = "./src/index.{{ srcFileExtension }}"
+target = "admin.app.tools.data"
+tools = "./tools.json"

admin-tools/src/index.liquid

@@ -0,0 +1,17 @@
+export default async function extension() {
+  shopify.tools.register('search', (input) => {
+    const {query = '', first = 10, after} = input;
+
+    // TODO: Implement your search logic here
+
+    return {
+      results: [],
+      pageInfo: {
+        hasNextPage: false,
+        hasPreviousPage: false,
+        startCursor: null,
+        endCursor: null,
+      },
+    };
+  });
+}

admin-tools/tools.json

@@ -0,0 +1,77 @@
+[
+  {
+    "name": "search",
+    "description": "Search for resources",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Search query string"
+        },
+        "after": {
+          "type": "string",
+          "description": "Cursor for pagination - returns elements after this cursor"
+        },
+        "first": {
+          "type": "integer",
+          "description": "Number of results to return (default: 10)"
+        }
+      },
+      "required": []
+    },
+    "outputSchema": {
+      "type": "object",
+      "properties": {
+        "results": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Unique identifier for the result"
+              },
+              "type": {
+                "type": "string",
+                "description": "The type/category of the result"
+              },
+              "url": {
+                "type": "string",
+                "description": "URL to view or edit the resource"
+              },
+              "title": {
+                "type": "string",
+                "description": "Display title for the result"
+              }
+            },
+            "required": ["id", "type"]
+          }
+        },
+        "pageInfo": {
+          "type": "object",
+          "properties": {
+            "hasNextPage": {
+              "type": "boolean",
+              "description": "Whether there are more results available"
+            },
+            "hasPreviousPage": {
+              "type": "boolean",
+              "description": "Whether there are previous results available"
+            },
+            "startCursor": {
+              "type": "string",
+              "nullable": true,
+              "description": "Cursor for the first item in results"
+            },
+            "endCursor": {
+              "type": "string",
+              "nullable": true,
+              "description": "Cursor for the last item in results"
+            }
+          }
+        }
+      }
+    }
+  }
+]

admin-tools/tsconfig.json.liquid

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "checkJs": true,
+    "allowJs": true,
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "noEmit": true
+  }
+}

templates.json

@@ -399,6 +399,25 @@
     ],
     "minimumCliVersion": "3.85.3"
   },
+  {
+    "identifier": "app_tools",
+    "name": "Admin app tools",
+    "defaultName": "app-tools",
+    "group": "UI extensions",
+    "supportLinks": [],
+    "url": "https://github.com/Shopify/extensions-templates#bf/add-admin-tools-data-template",
+    "type": "ui_extension",
+    "extensionPoints": [],
+    "supportedFlavors": [
+      {
+        "name": "JavaScript",
+        "value": "vanilla-js",
+        "path": "admin-tools"
+      }
+    ],
+    "organizationExpFlags": ["d7c1b4ad"],
+    "minimumCliVersion": "3.85.3"
+  },
   {
     "identifier": "admin_print_legacy",
     "name": "Admin print action",