🧱 xMerch CLI

Build on Xahau in minutes — not days.

🚀 Scaffold trustless commerce instantly using Next.js + Xaman + Xahau
🪝 Designed for new and experienced XRPL/Xahau developers
⚡ Zero-config templates — production aligned

⚡ Quick Start

No global install required:

pnpm dlx xmerch create

This generates:

• xBase (Donate Form) starter project
• .env.local with placeholders
• .gitignore
• Auto-installed dependencies
• Ready-to-run dev environment

Then:

cd xbase-project
pnpm dev

Open:

http://localhost:3000

For Docker deploys, edit the generated .env.deploy (gitignored) with your Docker Hub username + token (DOCKER_PERSONAL_ACCESS_TOKEN) and namespace before running xmerch deploy --docker. If you don’t have an org, set DOCKER_NAMESPACE to your username.

Before running xmerch deploy --docker, you can optionally sanity-check your project with a local build:

pnpm build

This surfaces build errors quickly before the Docker image build.

Want the landing-page + donation experience instead?

pnpm dlx xmerch create my-landing --template xBase_v2

Using the default xBase (Donate Form) template? Deploy the Supabase Edge Functions first (keeps Xaman secrets out of your container). See templates/xBase/supabase/README.md.

📦 Commands

| Command | Description | |--------|-------------| | xmerch create | Scaffold a new project (default = xBase – Donate Form) | | xmerch init | Initialize inside an empty folder | | xmerch deploy | (coming soon) Evernode deployment | | (future) xmerch doctor | Environment diagnostics |

✨ Features

• 🚀 Next.js 15 (App Router)
• 🎨 TailwindCSS + Framer Motion
• 🪝 Xaman (correct naming everywhere)
• ⚡ Clean donation / transaction starter
• 📁 Extendable template architecture
• 🔐 Secure env handling
• 🔮 Future: Evernode deployment (via evrPanel API)

🧱 Templates

| Template | Description | |----------|-------------| | xBase (Donate Form) | Minimal donation flow + Xaman signing (default) | | xBase (Landing + Donation) | Landing page + donation funnel (--template xBase_v2) | | (coming soon) store | Full vendor storefront | | (future) custom | Create your own template |

To add your own template:

/templates/<name>/
  README.md
  env.example
  gitignore.example

🔗 Resources

• 🌐 Demo → https://demo.xmerch.app
• 🏪 Production → https://xmerch.app
• 📘 Repo → https://github.com/mworks-proj/xmerch-cli
• 💼 Xaman → https://apps.xaman.dev
• 🪙 Xahau → https://xahau.network

🧵 Release Workflow

pnpm run release
git push --follow-tags origin main
pnpm publish

📄 License

MIT © 2025 MWorks Design LLC