From a998c2d38c3d22ae870abda671553bec33506561 Mon Sep 17 00:00:00 2001 From: Aaron Powell Date: Mon, 2 Mar 2026 19:36:10 +1100 Subject: [PATCH] feat: support external recipes in cookbook (#831) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * feat(schema): add external recipe fields to cookbook schema Add optional external, url, and author fields to the recipe schema in cookbook.schema.json. When external is true, url is required via conditional validation. Author supports name (required) and url (optional) for attribution. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * feat(data): support external recipes in data generator - External recipes (external: true) skip local file validation - Validate URL format for external recipes - Pass through external, url, and author fields to output JSON - Add per-recipe languages array: derived from resolved variant keys for local recipes, and from tags matching known language IDs for external recipes - Collect language IDs in a first pass before processing recipes Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * feat(website): render external recipe cards on cookbook page - Extend Recipe interface with external, url, author, and languages - Render external recipes with Community badge, author attribution, and View on GitHub link instead of View Recipe/View Example buttons - Language filter uses per-recipe languages array uniformly - Remove Nerd Font icons from select dropdown options (native selects cannot render custom web fonts) - Add CSS for external recipe cards (dashed border, badge, author) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * feat(cookbook): add community samples section with first external recipe Add a Community Samples cookbook section to cookbook.yml with the Node.js Agentic Issue Resolver as the first external recipe entry, linking to https://github.com/Impesud/nodejs-copilot-issue-resolver. Resolves the use case from PR #613 for supporting external samples. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * feat(cookbook): add Copilot SDK Web App to community samples Add aaronpowell/copilot-sdk-web-app — a full-stack chat app built with the GitHub Copilot SDK, .NET Aspire, and React. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .schemas/cookbook.schema.json | 33 ++++++++++ cookbook/cookbook.yml | 34 ++++++++++ eng/generate-website-data.mjs | 40 ++++++++++-- .../pages/learning-hub/cookbook/index.astro | 33 ++++++++++ website/src/scripts/pages/samples.ts | 62 ++++++++++++++++--- 5 files changed, 189 insertions(+), 13 deletions(-) diff --git a/.schemas/cookbook.schema.json b/.schemas/cookbook.schema.json index 857bd84e..f0465d88 100644 --- a/.schemas/cookbook.schema.json +++ b/.schemas/cookbook.schema.json @@ -88,7 +88,40 @@ "items": { "type": "string" } + }, + "external": { + "type": "boolean", + "description": "Whether this recipe links to an external repository", + "default": false + }, + "url": { + "type": "string", + "description": "URL to the external repository or project (required when external is true)", + "format": "uri" + }, + "author": { + "type": "object", + "description": "Author information for external recipes", + "required": ["name"], + "properties": { + "name": { + "type": "string", + "description": "Author display name or GitHub username" + }, + "url": { + "type": "string", + "description": "Author profile URL", + "format": "uri" + } + } } + }, + "if": { + "properties": { "external": { "const": true } }, + "required": ["external"] + }, + "then": { + "required": ["url"] } } } diff --git a/cookbook/cookbook.yml b/cookbook/cookbook.yml index 43f66f3f..0134ebb7 100644 --- a/cookbook/cookbook.yml +++ b/cookbook/cookbook.yml @@ -69,3 +69,37 @@ cookbooks: - playwright - mcp - wcag + + - id: community-samples + name: Community Samples + description: Community-contributed projects and examples for GitHub Copilot + path: cookbook/community-samples + featured: false + languages: [] + recipes: + - id: nodejs-agentic-issue-resolver + name: Node.js Agentic Issue Resolver + description: A resilient agentic workflow for autonomous codebase exploration and fixing, optimized for the Copilot SDK Technical Preview + external: true + url: https://github.com/Impesud/nodejs-copilot-issue-resolver + author: + name: Impesud + url: https://github.com/Impesud + tags: + - nodejs + - copilot-sdk + - agents + - community + - id: copilot-sdk-web-app + name: Copilot SDK Web App + description: A full-stack chat application built with the GitHub Copilot SDK, .NET Aspire, and React with GitHub OAuth, session history, and model selection + external: true + url: https://github.com/aaronpowell/copilot-sdk-web-app + author: + name: aaronpowell + url: https://github.com/aaronpowell + tags: + - dotnet + - copilot-sdk + - web-app + - community diff --git a/eng/generate-website-data.mjs b/eng/generate-website-data.mjs index 9b145bd5..79b28a1f 100644 --- a/eng/generate-website-data.mjs +++ b/eng/generate-website-data.mjs @@ -742,9 +742,12 @@ function generateSamplesData() { const allTags = new Set(); let totalRecipes = 0; - const cookbooks = cookbookManifest.cookbooks.map((cookbook) => { - // Collect languages + // First pass: collect all known language IDs across cookbooks + cookbookManifest.cookbooks.forEach((cookbook) => { cookbook.languages.forEach((lang) => allLanguages.add(lang.id)); + }); + + const cookbooks = cookbookManifest.cookbooks.map((cookbook) => { // Process recipes and add file paths const recipes = cookbook.recipes.map((recipe) => { @@ -753,6 +756,36 @@ function generateSamplesData() { recipe.tags.forEach((tag) => allTags.add(tag)); } + totalRecipes++; + + // External recipes link to an external URL — skip local file resolution + if (recipe.external) { + if (recipe.url) { + try { + new URL(recipe.url); + } catch { + console.warn(`Warning: Invalid URL for external recipe "${recipe.id}": ${recipe.url}`); + } + } else { + console.warn(`Warning: External recipe "${recipe.id}" is missing a url`); + } + + // Derive languages from tags that match known language IDs + const recipeLanguages = (recipe.tags || []).filter((tag) => allLanguages.has(tag)); + + return { + id: recipe.id, + name: recipe.name, + description: recipe.description, + tags: recipe.tags || [], + languages: recipeLanguages, + external: true, + url: recipe.url || null, + author: recipe.author || null, + variants: {}, + }; + } + // Build variants with file paths for each language const variants = {}; cookbook.languages.forEach((lang) => { @@ -771,13 +804,12 @@ function generateSamplesData() { } }); - totalRecipes++; - return { id: recipe.id, name: recipe.name, description: recipe.description, tags: recipe.tags || [], + languages: Object.keys(variants), variants, }; }); diff --git a/website/src/pages/learning-hub/cookbook/index.astro b/website/src/pages/learning-hub/cookbook/index.astro index 34e1ba3c..9187ea44 100644 --- a/website/src/pages/learning-hub/cookbook/index.astro +++ b/website/src/pages/learning-hub/cookbook/index.astro @@ -197,6 +197,39 @@ const base = import.meta.env.BASE_URL; font-style: italic; } + /* External recipe card */ + .recipe-card.external { + border-style: dashed; + } + + .recipe-badge.external-badge { + display: inline-flex; + align-items: center; + gap: 4px; + background: var(--color-bg-secondary); + color: var(--color-text-muted); + padding: 4px 10px; + border-radius: 12px; + font-size: 12px; + border: 1px solid var(--color-border); + white-space: nowrap; + } + + .recipe-author-line { + margin-bottom: 12px; + font-size: 13px; + color: var(--color-text-muted); + } + + .recipe-author-line a { + color: var(--color-link); + text-decoration: none; + } + + .recipe-author-line a:hover { + text-decoration: underline; + } + /* Empty state */ .empty-state { text-align: center; diff --git a/website/src/scripts/pages/samples.ts b/website/src/scripts/pages/samples.ts index cdc2e7d3..ac14bc1d 100644 --- a/website/src/scripts/pages/samples.ts +++ b/website/src/scripts/pages/samples.ts @@ -25,7 +25,11 @@ interface Recipe { name: string; description: string; tags: string[]; + languages: string[]; variants: Record; + external?: boolean; + url?: string | null; + author?: { name: string; url?: string } | null; } interface Cookbook { @@ -138,7 +142,7 @@ function setupFilters(): void { languages.forEach((lang, id) => { const option = document.createElement("option"); option.value = id; - option.textContent = `${lang.icon} ${lang.name}`; + option.textContent = lang.name; languageSelect.appendChild(option); }); @@ -257,10 +261,10 @@ function getFilteredRecipes(): { ); } - // Apply language filter + // Apply language filter using per-recipe languages array if (selectedLanguage) { - results = results.filter( - ({ recipe }) => recipe.variants[selectedLanguage!] + results = results.filter(({ recipe }) => + recipe.languages.includes(selectedLanguage!) ); } @@ -370,15 +374,55 @@ function renderRecipeCard( const recipeKey = `${cookbook.id}-${recipe.id}`; const isExpanded = expandedRecipes.has(recipeKey); - // Determine which language to show - const displayLang = selectedLanguage || cookbook.languages[0]?.id || "nodejs"; - const variant = recipe.variants[displayLang]; - const tags = recipe.tags .map((tag) => `${escapeHtml(tag)}`) .join(""); - const langIndicators = cookbook.languages + // External recipe — link to external URL + if (recipe.external && recipe.url) { + const authorHtml = recipe.author + ? `by ${ + recipe.author.url + ? `${escapeHtml(recipe.author.name)}` + : escapeHtml(recipe.author.name) + }` + : ""; + + return ` +
+
+

${highlightedName || escapeHtml(recipe.name)}

+ + + Community + +
+

${escapeHtml(recipe.description)}

+ ${authorHtml ? `
${authorHtml}
` : ""} +
${tags}
+
+ + + View on GitHub + +
+
+ `; + } + + // Local recipe — existing behavior + // Determine which language to show + const displayLang = selectedLanguage || cookbook.languages?.[0]?.id || "nodejs"; + const variant = recipe.variants[displayLang]; + + const langIndicators = (cookbook.languages ?? []) .filter((lang) => recipe.variants[lang.id]) .map( (lang) =>