application public active Verified 2026-04-15

WebCart

WebCart e-commerce platform containing open-shop (single-tenant Remix starter) and cloudshop (multi-tenant SaaS storefront) sharing a Cloudflare Pages + D1 + R2 + Stripe foundation, with per-tenant subdomain routing, plan-gated quotas, AI-assisted catalog generation, and public import APIs.

Documentation Map

What It Is

WebCart e-commerce platform containing open-shop (single-tenant Remix starter) and cloudshop (multi-tenant SaaS storefront) sharing a Cloudflare Pages + D1 + R2 + Stripe foundation, with per-tenant subdomain routing, plan-gated quotas, AI-assisted catalog generation, and public import APIs.

Architecture

Owners: third-party-applications

Source repos: ThirdPartyApplications/WebCart

Dependencies: topolo-auth

Repo shape

  • ThirdPartyApplications/WebCart/apps/
  • ThirdPartyApplications/WebCart/package.json
  • ThirdPartyApplications/WebCart/packages/
  • ThirdPartyApplications/WebCart/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

https://webcart.uk https://cloudshop.pages.dev
cloudshop

Config: ThirdPartyApplications/WebCart/apps/cloudshop/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

open-shop

Config: ThirdPartyApplications/WebCart/apps/open-shop/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/TopoloDocs/src/content/internal/apps/webcart.mdx

Source exists in repo: yes

App API page: /reference/apps/webcart

This system currently relies on a curated or README-derived contract surface instead of a source-controlled OpenAPI spec.

Auth and Permissions

Depends on Topolo Auth: yes

Service IDs:

srv_webcart

API key scopes

customers.read

Read customers via public API

Resource pattern: none

inventory.read

Read inventory levels via public API

Resource pattern: none

inventory.write

Adjust inventory via public API

Resource pattern: none

orders.read

Read orders via public API

Resource pattern: none

orders.write

Create and update orders via public API

Resource pattern: none

products.import

Bulk import products via public API

Resource pattern: none

products.read

Read product catalog via public API

Resource pattern: none

products.write

Create and update products via public API

Resource pattern: none

Service permissions

api_keys:read, api_keys:write, billing:read, billing:write, categories:read, categories:write, customers:read, customers:write, dashboard:read, discounts:read, discounts:write, integrations:read, integrations:write, inventory:read, inventory:write, orders:read, orders:write, products:import, products:read, products:write

Data Ownership

d1

Binding: DB

Target: f54110a7-7fbd-4f78-a37c-308f7efeb749

Environment: default

Source: ThirdPartyApplications/WebCart/apps/cloudshop/wrangler.toml

r2

Binding: IMAGES

Target: cloudshop-images

Environment: default

Source: ThirdPartyApplications/WebCart/apps/cloudshop/wrangler.toml

r2

Binding: DB_BACKUPS

Target: cloudshop-db-backups

Environment: default

Source: ThirdPartyApplications/WebCart/apps/cloudshop/wrangler.toml

d1

Binding: DB

Target: YOUR_DATABASE_ID_HERE

Environment: default

Source: ThirdPartyApplications/WebCart/apps/open-shop/wrangler.toml

r2

Binding: IMAGES

Target: open-shop-images

Environment: default

Source: ThirdPartyApplications/WebCart/apps/open-shop/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

No queue bindings were detected.

Cron triggers

No cron triggers were detected.

Workflow signals

No explicit queue/workflow script or cron signal was discovered.

Environment Variables and Bindings

Environment variables:

CURRENCY DEFAULT_CURRENCY SITE_URL

All wrangler bindings

  • DB (d1) -> f54110a7-7fbd-4f78-a37c-308f7efeb749
  • IMAGES (r2) -> cloudshop-images
  • DB_BACKUPS (r2) -> cloudshop-db-backups
  • DB (d1) -> YOUR_DATABASE_ID_HERE
  • IMAGES (r2) -> open-shop-images

Deployments

Deployment environments: default only or not declared

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • ThirdPartyApplications/WebCart/apps/cloudshop/wrangler.toml -> cloudshop
  • ThirdPartyApplications/WebCart/apps/open-shop/wrangler.toml -> open-shop

Build and deploy commands

  • build — ThirdPartyApplications/WebCart/apps/cloudshop/package.json :: remix vite:build
  • deploy — ThirdPartyApplications/WebCart/apps/cloudshop/package.json :: npm run build && wrangler pages deploy ./build/client
  • build — ThirdPartyApplications/WebCart/apps/open-shop/package.json :: remix vite:build
  • deploy — ThirdPartyApplications/WebCart/apps/open-shop/package.json :: npm run build && wrangler pages deploy ./build/client
  • build — ThirdPartyApplications/WebCart/package.json :: npm run build -w @webcart/open-shop && npm run build -w @webcart/cloudshop
  • build:cloudshop — ThirdPartyApplications/WebCart/package.json :: npm run build -w @webcart/cloudshop
  • build:open-shop — ThirdPartyApplications/WebCart/package.json :: npm run build -w @webcart/open-shop
  • build — ThirdPartyApplications/WebCart/packages/topolo-auth-client/package.json :: tsup src/index.ts --format esm,cjs --dts

Failure Modes

  • Neither OpenAPI nor README-derived interface detail was found.

Debugging Runbooks

Start with these entrypoints:

  • ThirdPartyApplications/WebCart/apps/cloudshop/wrangler.toml
  • ThirdPartyApplications/WebCart/apps/open-shop/wrangler.toml
  • PlatformApplications/TopoloDocs/src/content/internal/apps/webcart.mdx
  • ThirdPartyApplications/WebCart/apps/cloudshop/package.json
  • ThirdPartyApplications/WebCart/apps/open-shop/package.json
  • ThirdPartyApplications/WebCart/package.json
  • ThirdPartyApplications/WebCart/packages/topolo-auth-client/package.json
  • ThirdPartyApplications/WebCart/packages/topolo-auth-middleware/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-15

Any code change to this system is expected to update the canonical docs in PlatformApplications/TopoloDocs and refresh the verification date.