Use and adapt qchat
Use and adapt qchat: Build React chat interfaces that turn agent responses into structured commerce UI with a versioned schema.
Use the documented interfaces and source layout for qchat. The sections below retain the README’s examples and configuration details.
Diagnostic Commands
npm run install:ci: perform the one locked dependency installnpm run dev: start the Vite/Vinext development servernpm run build: build the deployable Sites artifactnpm run start: preview the built Worker locally with D1/R2 supportnpm run db:generate: generate Drizzle migrations after schema changes
When using the Sites plugin, follow its skill instructions for installation, builds, and publishing. These npm commands remain available for standalone use.
The portable build runs Vinext directly without a host timeout command. The managed-linux build uses scripts/build-verified.sh and its existing SITES_BUILD_TIMEOUT setting.
Commands in the root manifest
The captured package.json declares the following scripts. Run them from the directory containing that manifest.
| Command | Script |
|---|---|
npm run dev | node scripts/run-framework.mjs dev |
npm run build | npm run build:packages && node scripts/run-framework.mjs build |
npm run build:packages | npm run build --workspaces --if-present |
npm run test | vitest run |
npm run typecheck | tsc --noEmit |
npm run start | node --import ./scripts/sites-env.mjs ./node_modules/wrangler/bin/wrangler.js dev --config dist/server/wrangler.json --local --persist-to .wrangler/state --ip 127.0.0.1 --inspector-port 0 |
npm run lint | eslint . --ignore-pattern dist --ignore-pattern .next |
Troubleshoot a local change
- Reproduce the smallest example from the quick-start guide.
- Compare required configuration and dependency versions with the README.
- Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.
Source and help
The catalog identifies the license as MIT. Read the repository license before redistributing source or assets.
Source captured: 2026-10-11
