SmartScale Companion is a premium, open-source, glassmorphic Web Bluetooth dashboard designed to interface with smart kitchen scales. Read raw and tared weights in real-time, execute perfect coffee pourovers with a dedicated brewing timer, design customized recipes, and monitor full hardware telemetry—all directly from your browser.
- Real-time Weight Readout: Accurate weight representation with dynamic typography that auto-scales for different units.
- Radial Progress Dial: Smooth SVG dial showing current weight relative to scale capacity, shifting colors dynamically to warn of negative bounds or capacity overload.
- Multi-Unit Support: Seamlessly toggle between grams (
g), ounces (oz), and pounds/ounces (lb:oz) on the fly. - Software Tare & Zero Offset: Zero out container weight or reset scale reference counts with single-click hardware tares.
- History Snapshot Logging: Keep a local, running log of key weights with precise millisecond timestamps, formatted nicely in a glassmorphic timeline.
- Dual Weight & Timer Dial: Unified radial gauge displaying brewing duration and poured water weight simultaneously.
- Flow Rate Tracker: Real-time pour-rate calculations in grams per second (
g/s) with dynamic water ripple indicators. - Recipe Builder: Interactive slider interfaces to customize coffee grounds dose (grams) and target water ratios (e.g.,
1:15,1:16,1:16.6, or custom). - Calculations Engine: Automatically computes exact target brew yields and optimized bloom water volumes (3x dose).
- 4-Phase Brewing Guide: Guided workflow that steps you through:
- Preparation (grounds setup and container tares)
- Blooming (gas release with automatic 35-second countdown)
- Main Pour (fluid pouring with target g/s rate guidance)
- Drawdown (final filter drain)
- Auto-Start poured timer: Advanced option to automatically start the brew timer the split second the scale registers water flow.
- Session Summary Analytics: Post-brew breakdown reporting exact duration, total yield, and average flow rate.
- Zero Hardware Needed: Built-in Bluetooth simulation slider allowing developers to test and demonstrate full dashboard and coffee-brewing workflows without needing a physical scale.
This project is built to interface directly with Bluetooth LE smart scales that utilize the Perfect Company protocol (including Perfect Drink, Perfect Bake, and Perfect Blend kitchen scales).
The application scans for scales advertising name prefixes (Perfect, Scale, Bake, Drink, Blend, Pure, Smart, Kitchen) and communicates using the following discovered services:
- Primary Service UUID:
b5600001-a0f8-16af-bb42-1d3b642ec2e1 - Smoothed Weight Notification Characteristic UUID:
b5600003-a0f8-16af-bb42-1d3b642ec2e1 - Raw Zero-Delay ADC Notification Characteristic UUID:
b5600007-a0f8-16af-bb42-1d3b642ec2e1
The scale transmits weight updates as custom GATT binary packets. The reverse-engineered parser takes LSB, Mid, and MSB bytes from the notification payload, constructs a signed 24-bit integer, and applies the physical calibration scale factor:
// Sign extension from 24-bit to 32-bit signed integer
let rawVal = b1 | (b2 << 8) | (b3 << 16);
if (rawVal & 0x800000) {
rawVal -= 0x1000000;
}
// Convert counts to physical weight in grams (623.05 counts/gram)
const grams = rawVal / 623.05;Full details of the disassembly and reverse-engineering findings can be found in the research/ directory:
- Disassembly Notes — Architectural layout of the native binary decompilation.
- Extracted Strings — Native function symbols and data patterns used to identify packet structures.
Due to modern browser security guidelines, Web Bluetooth requires:
- Google Chrome, Microsoft Edge, or Opera (version 56+). Safari and Firefox do not natively support Web Bluetooth.
- A secure context: The page must be served over
https://orlocalhost.
- Clone this repository:
git clone https://github.com/YOUR_USERNAME/SmartScale-Companion.git cd SmartScale-Companion - Serve the directory locally. For example, using Python's built-in HTTP server:
python3 -m http.server 8000
- Open
http://localhost:8000in your Chrome or Edge browser.
SmartScale Companion is designed entirely with vanilla web technologies (HTML5, CSS3, ES6 JavaScript) and is 100% serverless, making it ideal for hosting on GitHub Pages.
This repository includes a pre-configured GitHub Actions workflow located in .github/workflows/static.yml.
- Push this repository to GitHub.
- Go to your repository settings on GitHub: Settings > Pages.
- Under Build and deployment > Source, select GitHub Actions.
- Every commit pushed to the
mainbranch will automatically build and deploy the dashboard to your GitHub Pages site!
If you prefer to deploy from a branch:
- In Settings > Pages > Build and deployment > Source, select Deploy from a branch.
- Select
mainas the branch and/ (root)as the folder, then click Save.
The application implements a premium, ultra-modern visual layout:
- Glassmorphism Glass Panels: Backed by semi-transparent HSL color layers, thin boundaries, and intense backdrop blur (
backdrop-filter: blur(20px)). - Harmonious Color Accents: A balanced dark theme blending deep slate backdrops with vibrant cyan (
var(--accent-cyan)), emerald (var(--accent-emerald)), and amber (var(--accent-amber)) feedback states. - Modern Typography: Elegant integrations of Google Fonts (Outfit & Inter) for clean digital readouts and crisp descriptive text.
- Fully Responsive Layout: Responsive grid architecture that wraps smoothly from desktop telemetry panels to handheld smartphone kitchen monitors.
This dashboard was entirely co-engineered, debugged, and optimized in partnership with Antigravity, an agentic AI coding assistant developed by the Google DeepMind team, customized precisely to solve specific smart kitchen scale telemetry and interface requirements.
SmartScale Companion is an independent open-source project. It is not affiliated with, authorized, sponsored, endorsed, or in any way officially connected to Perfect Company, Pure Imagination, or any of their subsidiaries or affiliates. All trademarks, service marks, and company names are the property of their respective owners. References to "Perfect Company", "Perfect Scale", "Perfect Drink", "Perfect Bake", and "Perfect Blend" scales are used strictly for compatibility and interoperability reference under fair use.