Skip to content

agustinkassis/badge-minter

Repository files navigation

Nostr POV Badge Minter

A web application for creating and distributing proof-of-visit (POV) badges on Nostr. Event organizers can easily generate QR codes that attendees can scan to claim unique badges as proof of their attendance.

Technical Documentation

See the Flow Documentation for detailed technical implementation.

Features

  • Mint Badges: Distribute badges in your event
  • QR Code Generation: Dynamic QR codes with automatic refresh to prevent farming
  • Real-time Claiming: See who claims badges in real-time
  • Nostr Integration: Badges are minted directly on the Nostr network
  • Mobile-Friendly: Responsive design works great on all devices

Tech stack

  • React 19.x: For building the user interface
  • TypeScript 5.x: For type-safe development
  • TailwindCSS 3.x: For styling
  • Framer Motion: For animations
  • Next JS 15.x: For server-side rendering
  • shadcn/ui: For accessible UI components
  • Nostrify: For Nostr protocol integration
  • Nostr Tools: For Nostr library functions

Roadmap

  • Admin/User frontend
  • Display QR generator
  • Claim request / response
  • Award badge
  • Nonce burning/expiration
  • Prevent multiple claims from the same user
  • Nsec bunker support
  • Reusable QR in a short period of time
  • Badge admin dashboard
    • Badge generator
    • Newsletter
    • Badge collection
    • Badge distribution

Getting Started

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/pov-badge-minter.git
cd pov-badge-minter
  1. Install dependencies:
nvm use
pnpm install
  1. Run the development server:
pnpm dev

Created By

Agustin Kassis from La Crypta

About

Pov badge minter

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published