How shopify/shopify-app-template-extension-only works
This is an extension-only Shopify app template: merchants manage FAQ metaobjects in an embedded App Home, while registered app tools expose FAQ listing and retrieval. The FAQ model performs direct browser-side Admin GraphQL reads and writes and maintains a small priming cache; Shopify metaobjects are the persistent store. README documents managed installation and direct API access. The sampled source shows the main routes and data calls; settings is a placeholder, and no storefront FAQ renderer is present in the tree.
Main entry points: AppHome.jsx App Home Router · faq.ts FAQ Model · HomePage.jsx FAQ List · index.js FAQ Tool Registration
Components 13
Embedded App Home
- App Home Router
extensions/app-home/src/AppHome.jsx - FAQ List
extensions/app-home/src/pages/HomePage.jsx - FAQ Editor
extensions/app-home/src/pages/FaqPage.jsx - Settings Page
extensions/app-home/src/pages/SettingsPage.jsx - Not Found Page
extensions/app-home/src/pages/NotFoundPage.jsx
FAQ Data
- FAQ Model
shared/models/faq.ts - GID Conversion
shared/utils/gid.ts
App Tools
- FAQ Tool Registration
extensions/app-tools/src/index.js
Shopify Services
- FAQ Metaobjects
shopify.app.toml - Admin GraphQL API
- Managed Installation
Other components
- Merchant
- Tool Client
Connections 15
- Merchant → App Home Router: uses embedded app
README.md - App Home Router → FAQ List: routes to
extensions/app-home/src/AppHome.jsx - App Home Router → FAQ Editor: routes to
extensions/app-home/src/AppHome.jsx - App Home Router → Settings Page: routes to
extensions/app-home/src/AppHome.jsx - App Home Router → Not Found Page: routes to
extensions/app-home/src/AppHome.jsx - FAQ List → FAQ Model: lists FAQs
extensions/app-home/src/pages/HomePage.jsx - FAQ List → GID Conversion: converts IDs
extensions/app-home/src/pages/HomePage.jsx - FAQ Editor → FAQ Model: reads and saves
extensions/app-home/src/pages/FaqPage.jsx - FAQ Model → GID Conversion: converts IDs
shared/models/faq.ts - FAQ Model → Admin GraphQL API: queries and mutates
shared/models/faq.ts - Admin GraphQL API → FAQ Metaobjects: reads and writes
README.md - Managed Installation → App Home Router: authenticates access
README.md - Tool Client → FAQ Tool Registration: invokes tools
- FAQ Tool Registration → FAQ Model: lists and fetches
extensions/app-tools/src/index.js - FAQ Tool Registration → GID Conversion: converts IDs
extensions/app-tools/src/index.js