How kinngh/shopify-node-express-mongodb-app works
This is an embedded Shopify app starter: a merchant uses its React admin UI, while Express authenticates app requests, manages Shopify sessions and API clients, and exposes proxy, checkout, GDPR, webhook, and event endpoints. MongoDB persists sessions and store status. A separate developer-tooling branch provides webhook, event, declarative-metafield, and TOML generation; the README also describes subscription-ready boilerplate. Some generator and event wiring is not shown in the excerpts, so those relationships are omitted rather than inferred.
Main entry points: index.js Express server · app_uninstalled.js Uninstall handler · shopify.js Shopify configuration · declarativeWriter.js Metafield generator
Components 28
Embedded admin UI
- Admin interface
client/App.jsx - UI routes
client/Routes.jsx
Request handling
- Express server
server/index.js - App API routes
server/routes/index.js - App proxy routes
server/routes/app_proxy/index.js - Checkout routes
server/routes/checkout/index.js - GDPR handlers
server/controllers/gdpr.js - Request verification
server/middleware/verifyRequest.js - Webhook dispatch
server/webhooks/_index.js - Uninstall handler
server/webhooks/app_uninstalled.js - Event dispatch
server/events/_index.js
Shopify integration
- Shopify configuration
utils/shopify.js - Shopify API clients
utils/clientProvider.js
Persistent state
- Session handling
utils/sessionHandler.js - Session records
utils/models/SessionModel.js - Store records
utils/models/StoreModel.js
App configuration tools
- Webhook generator
_developer/webhookWriter.js - Event generator
_developer/eventWriter.js - Metafield generator
_developer/declarativeWriter.js - TOML generator
_developer/tomlWriter.js - Webhook payload types
_developer/types/2026-07/webhooks.js - Webhook topic types
_developer/types/webhookTopics.js - Event topic types
_developer/types/eventTopics.js - Metafield types
_developer/types/declarative.js - TOML types
_developer/types/toml.js
Other components
- Merchant
- Shopify platform
- MongoDB
Connections 27
- Merchant → Admin interface: uses
- Admin interface → UI routes: routes through
client/App.jsx - Admin interface → Express server: calls API
- Express server → App API routes: mounts
server/index.js - Express server → App proxy routes: mounts
server/index.js - Express server → Checkout routes: mounts
server/index.js - Express server → Request verification: verifies requests
server/index.js - Express server → GDPR handlers: dispatches GDPR
server/index.js - Express server → Webhook dispatch: routes webhooks
server/index.js - Express server → Event dispatch: routes events
server/index.js - Webhook dispatch → Uninstall handler: dispatches handler
server/webhooks/_index.js - Uninstall handler → Session records: deletes sessions
server/webhooks/app_uninstalled.js - Uninstall handler → Store records: marks inactive
server/webhooks/app_uninstalled.js - App API routes → Shopify API clients: creates clients
server/routes/index.js - Shopify API clients → Session handling: loads sessions
utils/clientProvider.js - Session handling → Session records: reads and writes
utils/sessionHandler.js - Express server → Session handling: loads session
server/index.js - Shopify configuration → Shopify platform: configures
utils/shopify.js - Shopify API clients → Shopify platform: creates clients
utils/clientProvider.js - Express server → MongoDB: connects
server/index.js - Webhook generator → Shopify configuration: reads configuration
_developer/webhookWriter.js - Metafield generator → Shopify configuration: reads configuration
_developer/declarativeWriter.js - Event generator → Shopify configuration: reads configuration
_developer/eventWriter.js - Metafield generator → Metafield types: uses types
_developer/declarativeWriter.js - Metafield generator → TOML types: uses types
_developer/declarativeWriter.js - TOML generator → TOML types: uses types
_developer/tomlWriter.js - Uninstall handler → Webhook payload types: types payload
server/webhooks/app_uninstalled.js