StableSetu

StableSetu is a non-custodial USDC invoicing and collections platform on Solana. It lets merchants create invoices, assign payer wallets, share payment links, and reconcile payments with audit trails. Recipients get a payables view for assigned invoices and can complete on-chain payments from wallet-first flows.

This repository was bootstrapped from the official Turborepo create-turbo community example:

pnpm dlx create-turbo@latest --example with-docker

That starter gives us a documented Turborepo layout with a separate frontend and backend:

• apps/web: Next.js frontend
• apps/api: Express backend
• packages/ui: shared React UI package
• packages/logger: shared logger
• packages/eslint-config: shared ESLint presets
• packages/typescript-config: shared TypeScript configs
• packages/jest-presets: shared Jest presets

Commands

pnpm install
pnpm dev
pnpm build
pnpm lint
pnpm test

Environment

Create a root .env:

DATABASE_URL="postgresql://..."
DATABASE_URL_UNPOOLED="postgresql://..."
PORT=3001
NEXT_PUBLIC_API_BASE_URL="http://localhost:3001"

Demo Script

1. Open /auth, connect Phantom wallet, and sign message.
2. Create invoice at /invoices/new as merchant and assign payer wallet/user.
3. Open hosted payment link /invoice/:slug.
4. Login as assigned payer and verify invoice appears in /payables.
5. Pay in USDC on selected network (devnet/mainnet from settings).
6. Verify auto-redirect to /receipt/:slug.
7. Download receipt PDF, print/share link, and show tx on Solscan.
8. Open /invoices, export CSV, and show audit metadata timestamps.

Current Product Scope

• Wallet-first authentication and workspace management
• Customer directory and invoice composer
• Public invoice links with on-chain USDC payment verification
• Merchant invoice management with status filters and deletion controls
• Recipient payables inbox for assigned invoices
• Receipts, activity timeline, and CSV exports

Notes

• If port 3001 is already occupied, API dev watcher stays alive and logs that it is reusing the existing process.
• Use /settings to manage workspace profile and network preferences.

Product Spec

See SPEC.md for product scope, architecture, and execution details.