xMerch
Connecting to Xahau...
xMerch Hub

Developers

How to build a donation app on Xahau

Scaffold a Next.js donation app with Xaman signing in one command using the xmerch CLI, keep your API secrets server side, and extend it with a landing page.

One command to start

The xmerch CLI scaffolds a working project with no global install. It creates the app, writes your env file and installs dependencies:

  • pnpm dlx xmerch create (the default xBase Donate Form)
  • pnpm dlx xmerch create my-landing --template xBase_v2 (a landing page in front of the donation flow)
  • xmerch init to set up inside an empty folder

Signing happens in Xaman

Payment requests are signed in the donor's Xaman wallet, so your app never holds their keys. Create the API keys your app signs with in the Xaman Developer Console.

Keep secrets server side

The default template keeps your Xaman API secrets in Supabase Edge Functions, out of your app's container and out of the browser.

Make it yours

The templates are Next.js starters you can extend, or you can add your own template folder. A full vendor storefront template and deploying to Evernode with xmerch deploy are coming.

Questions

Do I need to install anything globally?

No. Run it with pnpm dlx.

Which network does it use?

Xahau, with payments signed in Xaman.

Where are the docs?

The xmerch package on npm has install notes and the full README, and the developers page links everything.

Ready to put it into practice?

Join xMerch, and let's grow.

Start selling