Skip to content

Latest commit

 

History

23 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PCSO 2D Lotto Generator

Mobile-first web app for generating PCSO 2D lotto combinations with intelligent buffer system

License GitHub Stars GitHub Forks

🚀 Live Demo • 📖 Documentation • 🐛 Report Bug • ✨ Request Feature


📋 Table of Contents

✨ Features

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

🚀 Quick Start

🌐 Online Access

👉 Launch App

No installation needed! Use it directly in your browser.

💻 Local Development

# 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:3000

🧠 How It Works

Buffer System Logic

The 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 Mode Behavior

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

Output Format

07 26 20 R
│  │  │  └─ Rambolito flag (if enabled)
│  │  └──── Bet amount (₱20)
│  └─────── Second number
└────────── First number

📱 Usage Guide

  1. Enter Numbers - Input your two lucky numbers (0-31)
  2. Set Bet Amount - Configure cost per combination (default: ₱20)
  3. Choose Buffer - Select 0, 1, or 2 for variation range
  4. Toggle Rambolito - Enable/disable position-independent mode
  5. Add More - Click "Add Combination" for additional sets
  6. Generate - Hit "Generate Numbers" to create combinations
  7. Export - Copy to clipboard or download as text file

💡 Pro Tip: Use Buffer 1-2 with Rambolito disabled to maximize coverage while managing costs.

🛠️ Tech Stack

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

🤝 Contributing

Contributions are welcome! This project follows the Clean Commit Convention by @wgtechlabs.

Commit Types

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.

Workflow

# 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-feature

Before submitting:

  • ✅ Test on mobile (375px width minimum)
  • ✅ Verify buffer logic with edge cases
  • ✅ Check cost calculations
  • ✅ Follow clean-commit convention

📄 License

GNU General Public License v3.0 - see LICENSE file for details.

👨‍💻 Author

Waren Gonzaga

⚠️ Disclaimer

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

💖 Support

If you find this project helpful:


Made with ❤️ for Filipino lotto players

⬆ Back to Top

About

A mobile-first PCSO 2D lotto number generator with buffer system and Rambolito mode support

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages