Bo Bing

Bo Bing is a standalone Vue 2 implementation of the Mid-Autumn dice game 博饼. It runs entirely in the browser: no backend, database, account system, or WebSocket service is required.

Features

• Roll six dice locally in the browser.
• Evaluate common Bo Bing prize categories.
• Keep a short in-session roll history.
• Build as a static Vue CLI application.

Tech Stack

• Vue 2
• Vue CLI 5
• Yarn 1

Requirements

• Node.js 24
• Yarn 1.x

Node 24 is used by CI. The project stays on Vue 2 for now, but the build toolchain uses Vue CLI 5 and webpack 5 so it can run on current Node without OpenSSL compatibility flags.

Getting Started

Install dependencies:

yarn install --frozen-lockfile

Start the development server:

yarn serve

Build for production:

yarn build

Run lint checks:

yarn lint

Project Structure

.
├── public/          Static HTML shell and favicon
├── src/             Vue application source
├── package.json     Scripts and dependency metadata
├── yarn.lock        Reproducible dependency lockfile
└── LICENSE          MIT license

Backend Status

This repository is intentionally frontend-only. An older Spring Boot backend prototype was removed because the Vue application did not call it and can run independently. If networked multiplayer, accounts, or persistent history are added later, they should be introduced as a new scoped design rather than relying on the removed prototype.

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md for the expected workflow.

Security

Please report security issues privately. See SECURITY.md.

License

This project is released under the MIT License.