Michilis/LightningLotto
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f743a6749c603e8c4209f41252593a7ee1d90161
LightningLotto/front_end
History
Michilis d3bf8080b6 Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery 
Features:
- Lightning Network payments via LNbits integration
- Provably fair draws using CSPRNG
- Random ticket number generation
- Automatic payouts with retry/redraw logic
- Nostr authentication (NIP-07)
- Multiple draw cycles (hourly, daily, weekly, monthly)
- PostgreSQL and SQLite database support
- Real-time countdown and payment animations
- Swagger API documentation
- Docker support

Stack:
- Backend: Node.js, TypeScript, Express
- Frontend: Next.js, React, TailwindCSS, Redux
- Payments: LNbits
2025-11-27 22:13:37 +00:00
..
src
Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery
2025-11-27 22:13:37 +00:00
.gitignore
Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery
2025-11-27 22:13:37 +00:00
Dockerfile
Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery
2025-11-27 22:13:37 +00:00
env.example
Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery
2025-11-27 22:13:37 +00:00
next.config.js
Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery
2025-11-27 22:13:37 +00:00
package-lock.json
Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery
2025-11-27 22:13:37 +00:00
package.json
Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery
2025-11-27 22:13:37 +00:00
postcss.config.js
Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery
2025-11-27 22:13:37 +00:00
README.md
Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery
2025-11-27 22:13:37 +00:00
tailwind.config.js
Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery
2025-11-27 22:13:37 +00:00
tsconfig.json
Initial commit: Lightning Lottery - Bitcoin Lightning Network powered lottery
2025-11-27 22:13:37 +00:00

README.md

Lightning Lottery Frontend

Next.js-based frontend for the Lightning Lottery system.

Features

  • Responsive Design: Mobile-first, works on all devices
  • Real-time Updates: Live countdown and automatic status polling
  • Lightning Payments: QR code invoice display
  • Nostr Authentication: Optional user login via NIP-07
  • User Dashboard: View tickets, wins, and statistics

Tech Stack

  • Framework: Next.js 14 (App Router)
  • Language: TypeScript
  • Styling: TailwindCSS
  • State Management: Redux Toolkit
  • QR Codes: qrcode.react

Setup

Prerequisites

  • Node.js 18+
  • Backend API running

Installation

  1. Install dependencies:
npm install
  1. Configure environment:
cp .env.example .env.local
# Edit .env.local with your configuration
  1. Run development server:
npm run dev

Open http://localhost:3001

Production Build

npm run build
npm start

Environment Variables

  • NEXT_PUBLIC_API_BASE_URL - Backend API URL
  • NEXT_PUBLIC_APP_BASE_URL - Frontend public URL

Pages

  • / - Home page with current jackpot
  • /buy - Buy lottery tickets
  • /tickets/[id] - Ticket status page (public)
  • /dashboard - User dashboard (Nostr auth required)
  • /dashboard/tickets - User's ticket history
  • /dashboard/wins - User's wins

Components

Reusable Components

  • TopBar - Navigation header
  • Footer - Site footer
  • JackpotCountdown - Live countdown timer
  • JackpotPotDisplay - Pot amount display
  • LightningInvoiceCard - Invoice QR code and copy
  • TicketList - Display ticket serial numbers
  • PayoutStatus - Payout status indicator
  • NostrLoginButton - Nostr authentication

Deployment

Vercel

vercel

Netlify

netlify deploy --prod

Docker

docker build -t lightning-lotto-frontend .
docker run -p 3001:3000 lightning-lotto-frontend

License

MIT