chore: move examples to app-templates repo#99
Draft
thisistonydang wants to merge 1 commit into
Draft
Conversation
The six full-stack showcase examples (agentic-support-console, content-moderator, inventory-intelligence, rag-chat, saas-tracker, and vacation-rentals) now live in the databricks/app-templates repo as flat top-level entries. This commit: - Deletes the moved template/ trees from devhub/examples/. Keeps vacation-rentals/blog-post-snippets/ as the only remaining content (referenced by the AppKit blog post). - Renames Example.githubPath -> Example.templateUrl (full GitHub URL), so the metadata is no longer coupled to the devhub repo layout. - Updates the three URL builders (api/content-markdown.ts, src/components/examples/example-detail.tsx, src/lib/examples/build-example-markdown.ts) to consume templateUrl directly. - Rewrites initCommand strings (5 git-clone + rag-chat init) and the six content/examples/<slug>/goal.md README references to drop the template/ subdir. - Updates CONTRIBUTING.md, the author-recipes-and-cookbooks skill, and the quality-checklist to describe the new app-templates layout. - Drops the obsolete examples/*/template/package-lock.json linguist rule from .gitattributes. - Rewrites examples/README.md as a stub pointing readers at app-templates and noting that blog-post-snippets remains. Depends on databricks/app-templates landing first so the new templateUrl/initCommand strings resolve. Co-authored-by: Cursor <cursoragent@cursor.com>
3 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Companion to databricks/app-templates#217. Migrates the six full-stack showcase examples (
agentic-support-console,content-moderator,inventory-intelligence,rag-chat,saas-tracker,vacation-rentals) out ofdevhub/examples/and into databricks/app-templates as flat top-level entries.What this PR changes inside DevHub:
Example.githubPathtoExample.templateUrl(full GitHub URL), decoupling the registry from the devhub repo layout. All sixcreateExample()entries insrc/lib/recipes/recipes.tsare updated accordingly.api/content-markdown.ts,src/components/examples/example-detail.tsx, andsrc/lib/examples/build-example-markdown.tsnow consumetemplateUrldirectly. The hardcodeddatabricks/devhub+/templatesuffix logic is gone.initCommandrewrites — fivegit clone --depth 1 https://github.com/databricks/app-templates.git\ncd app-templates/<slug>plus therag-chatdatabricks apps init --template …/app-templates/tree/main/rag-chat ….content/examples/<slug>/goal.mdfiles have theirtemplate/README.mdreferences updated toREADME.md. The build-prompt narrative ("Clone and followtemplate/README.md") becomes "Clone and followREADME.md".CONTRIBUTING.md,.agents/skills/author-recipes-and-cookbooks/SKILL.md, and itsreferences/quality-checklist.mdrewritten to describe the new flat layout in app-templates (notemplate/subdir, full URL intemplateUrl).examples/<slug>/template/trees, plus the obsolete.gitattributeslinguist rule forexamples/*/template/package-lock.json(the file is now empty so the file itself is removed).examples/README.md— rewritten as a small stub pointing at app-templates and noting thatvacation-rentals/blog-post-snippets/is the only remaining child (kept here because it's blog supporting material referenced byjamesbroadhead/appkit-blog-snippets, not a runnable template).tests/build-example-markdown.test.ts,tests/e2e/copy-markdown.spec.ts, andtests/markdown.test.tsfixtures and assertions updated to reflect the new URLs and copy.DevHub URL slugs (
Example.id//templates/<slug>) are unchanged. External blog post and docs links continue to resolve.Dependency / merge order
The new
templateUrl/initCommandstrings point at paths indatabricks/app-templates. Merge databricks/app-templates#217 first. Merging this PR before that one would temporarily leave the DevHub site with broken "View source on GitHub" links and brokendatabricks apps init --template …commands until app-templates lands.Test plan
npm run typecheck— passnpm run test— 269 / 269 unit + 107 / 107 e2e passnpm run validate:content— passnpm run verify:images— pass (64 raster images)npm run build— passnpm run fmt— appliedCo-authored-by: Cursor