Docs

Local setup & demos

For developers running Dyotona on a laptop. Production merchants can ignore this page and use dyotona.com.

Requirements

Node 20+, pnpm, and Docker. Local Postgres is mapped to port 55432.

Commands

copy .env.example apps\api\.env
copy .env.example apps\dashboard\.env.local
pnpm db:up
pnpm install
pnpm db:push
pnpm db:seed
pnpm --filter @bdagent/widget build
pnpm dev

Dashboard: localhost:3000 · app: /app
Seeded login: merchant@bdagent.dev / password123

Optional: set OPENAI_API_KEY in apps/api/.env. Without it, chat still returns catalog matches.

Local demos

• Naksha Ghor — crawl / JSON-LD shop
• Ghor Mart — Woo markup + mock REST. Sample order 1001 / shopper@example.com

Production demos

• https://api.dyotona.com/demo/
• https://api.dyotona.com/demo/woo/

Deploy notes: see the repo docs/railway.md for Railway + dyotona.com.