Mobile-first web app for generating PCSO 2D lotto combinations with intelligent buffer system
🚀 Live Demo • 📖 Documentation • 🐛 Report Bug • ✨ Request Feature
| Feature | Description |
|---|---|
| 🎯 PCSO 2D Range | Official Philippine lotto numbers (0-31) |
| 🔢 Smart Buffer System | Generate ±1 or ±2 number variations automatically |
| 🎲 Rambolito Mode | Position-independent winning (7-26 = 26-7) |
| 💰 Live Cost Tracker | Real-time bet calculation (₱20/combo) |
| ➕ Unlimited Combos | Add as many combinations as you need |
| 📋 Export Tools | Copy to clipboard or download as .txt |
| 📱 Mobile-First UI | Responsive design with dark mode theme |
| ⚡ Client-Side Only | No backend needed, runs in your browser |
No installation needed! Use it directly in your browser.
# Clone repository
git clone https://github.com/warengonzaga/pcso-2d-lotto-generator.git
cd pcso-2d-lotto-generator
# Install dependencies
npm install
# Start development server
npm start
# Open browser at http://localhost:3000The buffer generates nearby number variations:
| Buffer | Output Example (for number 15) |
|---|---|
| 0 | 15 (exact only) |
| 1 | 14, 15, 16 (±1 variation) |
| 2 | 13, 14, 15, 16, 17 (±2 variations) |
| Rambolito | Buffer | Result |
|---|---|---|
| ✅ Enabled | Any | Position-independent (7-26 = 26-7) |
| ❌ Disabled | 0 | Exact position only (7-26 ≠ 26-7) |
| ❌ Disabled | ≥1 | Generates both positions + buffered variations |
07 26 20 R
│ │ │ └─ Rambolito flag (if enabled)
│ │ └──── Bet amount (₱20)
│ └─────── Second number
└────────── First number
- Enter Numbers - Input your two lucky numbers (0-31)
- Set Bet Amount - Configure cost per combination (default: ₱20)
- Choose Buffer - Select 0, 1, or 2 for variation range
- Toggle Rambolito - Enable/disable position-independent mode
- Add More - Click "Add Combination" for additional sets
- Generate - Hit "Generate Numbers" to create combinations
- Export - Copy to clipboard or download as text file
💡 Pro Tip: Use Buffer 1-2 with Rambolito disabled to maximize coverage while managing costs.
| Layer | Technology |
|---|---|
| Frontend | Vanilla JavaScript, HTML5, CSS3 |
| Backend | Node.js + Express |
| Styling | Dark mode with neon purple aesthetic |
| Hosting | GitHub Pages (static) |
| Philosophy | No frameworks, pure web fundamentals |
📂 Project Structure
pcso-2d-lotto-generator/
├── public/
│ ├── css/
│ │ └── style.css # Dark theme styles
│ ├── js/
│ │ ├── generator.js # Core buffer logic
│ │ └── app.js # UI interactions
│ └── index.html # Main HTML
├── server.js # Express server
├── AGENTS.md # AI agent instructions
└── package.json
Contributions are welcome! This project follows the Clean Commit Convention by @wgtechlabs.
| Emoji | Type | Example |
|---|---|---|
| 📦 | new |
📦 new: add export to CSV feature |
| 🔧 | update |
🔧 update: improve buffer calculation |
| 🗑️ | remove |
🗑️ remove: unused lodash dependency |
| 🔒 | security |
🔒 security: patch XSS vulnerability |
| 🧪 | test |
🧪 test: add buffer edge cases |
| 📖 | docs |
📖 docs: update readme examples |
See AGENTS.md for complete guidelines and all 9 commit types.
# 1. Fork and clone
git clone https://github.com/YOUR_USERNAME/pcso-2d-lotto-generator.git
# 2. Create feature branch
git checkout -b feature/amazing-feature
# 3. Make changes and commit
git commit -m '📦 new: add amazing feature'
# 4. Push and create PR
git push origin feature/amazing-featureBefore submitting:
- ✅ Test on mobile (375px width minimum)
- ✅ Verify buffer logic with edge cases
- ✅ Check cost calculations
- ✅ Follow clean-commit convention
GNU General Public License v3.0 - see LICENSE file for details.
Waren Gonzaga
- 🌐 Website: warengonzaga.com
- 💼 GitHub: @warengonzaga
This tool is for entertainment and convenience purposes only. Please play responsibly.
- The author is not responsible for any losses incurred from using this application
- Gambling can be addictive - seek help if needed
- This is not affiliated with or endorsed by PCSO
If you find this project helpful:
- ⭐ Star this repository
- 🔄 Share with fellow lotto players
- 🐛 Report issues
- 💡 Suggest features
- 🤝 Contribute improvements
Made with ❤️ for Filipino lotto players