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 |
π Launch App
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