Mintflow - Instant Digital Sales, Powered by PyUSD

A zero-fee marketplace where creators sell digital products instantly using PyUSD stablecoins. No intermediaries, no waiting periods, no geographic restrictions—just creators and their audience, connected through borderless payments.

🔗 Repository: https://github.com/0xdevrel/mintflow

📊 How It Works

graph LR
    A[Creator] -->|1. Connect Wallet| B[Create Product]
    B -->|2. Upload & Price| C[Publish]
    C -->|3. Share Link| D[Buyer Visits]
    D -->|4. Connect Wallet| E[Purchase with PyUSD]
    E -->|5. Pay| F[Blockchain Verification]
    F -->|6. Confirmed| G[Instant Delivery]
    G -->|7. PyUSD| A
    G -->|8. Download| D

Simple Flow:

👨‍💻 Creator: Connect Wallet → Create Product → Get Paid Instantly
🛒 Buyer: Browse → Connect Wallet → Pay with PyUSD → Download
⛓️ Verification: On-chain verification → Direct payment to creator → Zero fees

🚀 Features

Zero Fees: Keep 100% of your sales
Instant Settlement: Receive payments directly to your wallet in seconds
Global Access: Sell to anyone, anywhere
Secure Payments: Direct PyUSD transfers with no intermediaries
Beautiful Themes: Customizable sales pages with 3 preset themes
File Delivery: Secure file downloads with time-limited access

🛠️ Tech Stack

Frontend: Next.js 14, TypeScript, Tailwind CSS, Shadcn/ui
Web3: Wagmi v2, Viem, RainbowKit
Database: Cloudflare D1 (SQLite)
Storage: Cloudflare R2
Blockchain: Ethereum Sepolia testnet, PyUSD token
Deployment: Vercel

🏗️ Project Structure

src/
├── app/                    # Next.js app router pages
│   ├── (auth)/            # Auth-related pages
│   ├── (creator)/         # Creator dashboard & product management
│   ├── (public)/          # Sales pages
│   └── api/               # API routes
├── components/            # React components
│   ├── ui/               # Shadcn components
│   ├── wallet/           # Wallet connection components
│   └── shared/           # Shared components
├── lib/                   # Utilities
│   ├── db/               # Database utilities
│   ├── blockchain/       # Web3 utilities
│   └── storage/          # R2 file operations
└── types/                 # TypeScript types

🚀 Getting Started

Prerequisites

Node.js 18+
npm or yarn
Cloudflare account (for D1 and R2)
WalletConnect project ID

Installation

Clone the repository

git clone https://github.com/0xdevrel/mintflow.git
cd mintflow

Install dependencies
```
npm install
```
Set up environment variables
```
cp env.example .env.local
```
Fill in your environment variables:
- NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID: Get from WalletConnect Cloud
- CLOUDFLARE_API_TOKEN: Get from Cloudflare Dashboard
- JWT_SECRET: Generate a random secret key

Set up Cloudflare D1 and R2

# Login to Cloudflare
npx wrangler login

# Create D1 database
npx wrangler d1 create mintflow_db

# Create R2 bucket
npx wrangler r2 bucket create mintflow-files

# Update wrangler.toml with your database ID

Run database migrations

npx wrangler d1 execute mintflow_db --file=src/lib/db/schema.sql

Start development server
```
npm run dev
```

🔧 Configuration

Cloudflare Setup

D1 Database: Create a new D1 database named mintflow_db
R2 Bucket: Create a new R2 bucket named mintflow-files
API Token: Create an API token with D1 and R2 permissions

WalletConnect Setup

Go to WalletConnect Cloud
Create a new project
Copy the Project ID to your environment variables

📱 Usage

For Creators

Connect Wallet: Connect your MetaMask or other wallet
Create Account: Set up your creator profile with username
Create Product: Upload files, set pricing, customize theme
Publish: Make your product live and share the link
Get Paid: Receive PyUSD directly to your wallet

For Buyers

Browse Products: Visit creator storefronts
Connect Wallet: Connect your wallet to purchase
Buy Product: Pay with PyUSD, get instant access
Download: Access your purchases in your library

🔐 Security

Wallet Security: Users control their own wallets
File Security: Files stored in private R2 bucket with signed URLs
Transaction Verification: All payments verified on-chain
No Private Keys: Platform never has access to private keys

🌐 Deployment

Vercel Deployment

Connect to Vercel: Link your GitHub repository
Set Environment Variables: Add all required environment variables
Deploy: Vercel will automatically deploy on push

Cloudflare Pages (Alternative)

Connect to Cloudflare Pages: Link your GitHub repository
Set Build Settings:
- Build command: npm run build
- Build output directory: .next
Set Environment Variables: Add all required variables
Deploy: Cloudflare Pages will build and deploy

🧪 Testing

Local Testing

Get Testnet PyUSD: Use the Sepolia testnet faucet
Test Creator Flow: Create account → Create product → Publish
Test Buyer Flow: Visit sales page → Purchase → Download
Verify Transactions: Check transactions on Sepolia Etherscan

Testnet PyUSD

Contract Address: 0xCaC524BcA292aaade2DF8A05cC58F0a65B1B3bB9
Faucet: Use the official PyUSD testnet faucet
Network: Ethereum Sepolia testnet

📊 Database Schema

Tables

creators: User profiles and wallet addresses
products: Digital products with pricing and files
product_themes: Theme customization settings
purchases: Transaction records and delivery status

See src/lib/db/schema.sql for complete schema.

🔄 API Endpoints

Authentication

POST /api/auth/signup - Create creator account
GET /api/auth/session - Get current user session
GET /api/auth/username-check - Check username availability

Products

POST /api/products - Create new product
GET /api/products/[id] - Get product details
PUT /api/products/[id] - Update product
DELETE /api/products/[id] - Delete product

Checkout

POST /api/checkout/initiate - Start purchase process
POST /api/purchases/verify - Verify transaction
GET /api/downloads/[purchaseId] - Generate download link

🎨 Theming

Theme Presets

Minimal: Clean white background, generous whitespace
Bold: Full-width hero, vibrant gradients, large typography
Professional: Two-column layout, subtle shadows, conservative palette

Customization

Primary accent color
Font pairing (3 options per theme)
Header style (image or solid)
Creator bio visibility
Social links visibility

🚀 Roadmap

Phase 1: MVP (Current)

✅ Basic product creation and sales
✅ Wallet integration
✅ File upload and delivery
✅ Transaction monitoring

Phase 2: Enhanced Features

🔄 Advanced analytics
🔄 Email notifications
🔄 Mobile app
🔄 Custom domains

Phase 3: Scale

🔄 Multi-chain support
🔄 Subscription products
🔄 Affiliate system
🔄 API for third-party integrations

🤝 Contributing

We welcome contributions! Here's how to get started:

Fork the repository: https://github.com/0xdevrel/mintflow
Create a feature branch: git checkout -b feature/your-feature-name
Make your changes
Add tests if applicable
Commit your changes: git commit -m 'Add some feature'
Push to the branch: git push origin feature/your-feature-name
Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

Documentation: Check this README and code comments
Issues: Report bugs or request features
Discussions: Join the conversation

🙏 Acknowledgments

Built for ETHGlobal 2025
Powered by PyUSD on Ethereum Sepolia
Uses Cloudflare for global edge performance
Inspired by the creator economy and Web3 payments

Mintflow - Instant Digital Sales, Powered by PyUSD 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 8 Commits
public		public
scripts		scripts
src		src
.gitignore		.gitignore
README.md		README.md
bun.lock		bun.lock
components.json		components.json
env.example		env.example
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
r2-cors-dashboard.json		r2-cors-dashboard.json
r2-cors.json		r2-cors.json
tsconfig.json		tsconfig.json

0xdevrel/mintflow

Folders and files

Latest commit

History

Repository files navigation