Paniere brings the classic Neapolitan Tombola (similar to Bingo) to your browser with a fun, retro-inspired interface. Experience the excitement of drawing numbers and marking your cards, whether you're the game master or a player.
Key Features:
- 🎲 Two Game Modes: Play as the Game Master (Tabellone) drawing numbers, or as a Player marking your cards (Cartelle).
- 🇮🇹 Authentic Gameplay: Follows traditional Neapolitan Tombola rules and number distribution.
- 🎨 Retro Theme: Enjoy a visually distinct interface with warm colors and classic typography.
- 📱 Responsive Design: Play smoothly on desktop, tablet, or mobile.
- 🌐 Multilingual: Available in English and Italian.
- ⌨️ Accessible UI: Designed with keyboard navigation and screen reader support in mind.
- 📊 Analytics: Uses Google Analytics (GA4) for usage insights.
- Draw random numbers (1-90) one by one.
- Visualize drawn numbers on the interactive Tabellone board.
- Undo the last drawn number if a mistake is made.
- View the history of the last few drawn numbers.
- Reset the board to start a new game.
- Play with 1 to 10 randomly generated, authentic cartelle.
- Mark numbers on your cartelle as they are called out:
- Click/Tap: Simply click or tap the number on your card.
- Manual Input: Type the number into the dedicated input field in the footer for quick marking.
- Automatic prize detection: The game highlights winning rows for Ambo, Terno, Quaterna, and Cinquina.
- Tombola Celebration: A visual confetti celebration when you hit Tombola!
- Undo your last mark if you make a mistake.
Paniere is built as a TypeScript monorepo with the following structure:
- Frontend: React 19 + TypeScript + Tailwind CSS + Zustand
- Backend: Fastify + TypeScript (for future multiplayer features)
- Shared: Common types and utilities shared between packages
- Build Tools: Vite (frontend) + pnpm workspaces (monorepo management)
- Deployment: Netlify (frontend) + CI/CD with GitHub Actions
Just visit paniere.netlify.app and start playing! No installation required.
# Clone and setup
git clone https://github.com/floroz/paniere.git
cd paniere
pnpm install
# Start development
pnpm run dev # Starts both frontend and backend📚 For detailed development workflows, see Development Workflow Guide
- Visit the App: Go to paniere.netlify.app
- Select Language: Choose English or Italian using the flag buttons
- Choose Mode:
- Game Master: Run the Tabellone and draw numbers. Click "Draw" to get started
- Player: Choose number of cartelle (1-10) and click "Start Game"
- Play!:
- Game Master: Keep clicking "Draw". Use "Undo" or "Reset" as needed
- Player: Mark called numbers by clicking/tapping or using the manual input field. Watch for automatic prize highlights!
The game automatically detects these winning combinations on your cartelle:
- Ambo: Two numbers in a single row
- Terno: Three numbers in a single row
- Quaterna: Four numbers in a single row
- Cinquina: All five numbers in a single row
- Tombola: All 15 numbers on a single cartella – the grand prize!
- Development Workflow Guide - Day-to-day development patterns
- Current Architecture - System overview and design decisions
- Implementation Guides - One-time setup guides (monorepo migration, etc.)
This project is licensed under the MIT License. See the LICENSE file for details.