Skip to content
Bazaar  Docs

Local Development

To test your Bazaar app locally, run the mock:

Terminal window
npx @bzr/bazaar-mock

This will launch a mock Bazaar server on port 3377. It will also create an app with ID “test” that is expected to run on http://localhost:8080.

You can change these defaults with the following options.

npx @bzr/bazaar-mock [options]
  -i specify app ID. It is optional and defaults to 'test'.
  -u specify app URL. It is optional and defaults to 'http://localhost:8080'.
  -r specify redirect URI. Can be specified multiple times. It is optional and defaults app URL.
  -p specify port. Default is 3377.
  -h show this help
 Example: npx bzr -i my_app -u http://localhost:8080 -r http://localhost:8080 -r http://localhost:8081

The mock server is close in functionality with the real server. You can log in on http://localhost:3377 with any email and code 1234. This gives you access to your mock Bazaar dashboard and you can also add more apps. All data is stored in memory and only exists as long as the mock server is running.

Connect your app to the mock server

When running your app in development mode, the Bazaar library will automatically connect to mock server URL by defaulting bazaarUri to http://localhost:3377. In production, bazaarUri is set to https://cloud.bzr.dev. You can optionally set this URL when creating a BazaarApp.

import { BazaarApp } from "@bzr/bazaar";


const bzr = new BazaarApp({
  appId: "test",
  loginRedirectUri: window.location.origin + window.location.pathname,
  bazaarUri: "http://localhost:3377",
});