Skip to content

warengonzaga/pcso-2d-lotto-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

21 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

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:

  • ⭐ Star this repository
  • πŸ”„ Share with fellow lotto players
  • πŸ› Report issues
  • πŸ’‘ Suggest features
  • 🀝 Contribute improvements

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

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

 
 
 

Contributors