Badger 2350 Developer Plugin
Complete development environment for Universe 2025 (Tufty) Badge. Create MonaOS apps, manage deployments, and access comprehensive API reference with AI-powered assistance.
Why This Plugin?
Creating apps for the Universe 2025 Badge requires understanding MonaOS structure, badgeware API, deployment workflows, and USB Mass Storage Mode quirks. This plugin bundles everything you need: 5 slash commands, 8 comprehensive skills, example apps, and automated deployment tools.
Immediate Value
- ⚡ Faster Development: Streamlined workflow from zero to deployed app
- 📚 Comprehensive Learning: 8 detailed skills cover setup, hardware, API, and troubleshooting
- 🤖 AI-Powered Help: Claude Code integration with context-aware commands and skills
What's Included
| Category | What's Included | Details |
|---|
| Slash Commands | 5 interactive commands | Create apps, API lookup, deploy, quickstart, troubleshoot |
| Skills | 8 comprehensive guides | 100+ pages of setup, development, API, and troubleshooting |
| Example Apps | 2 working examples | Hello World (basic), Meditation Timer (advanced state management) |
| Utilities | 3 helper scripts | Installation, pagination, Makefile |
| Templates | 2 ready-to-use | App template + 24x24 icon template |
Hardware Specifications
┌─────────────────────────────────┐
│ UNIVERSE 2025 TUFTY BADGE │
├─────────────────────────────────┤
│ RP2350 @ 200MHz (Dual-core) │
│ 320x240 IPS Display (160x120 FB)│
│ 512kB SRAM / 16MB Flash │
│ WiFi 2.4GHz + Bluetooth 5.2 │
│ IR Tx/Rx, 4-zone LED backlight │
│ 5 Buttons, 4 GPIO, USB-C │
│ 1000mAh Battery (8+ hours) │
└─────────────────────────────────┘
| Spec | Details |
|---|
| CPU | RP2350 ARM Cortex-M33 @ 200MHz (dual-core) |
| Memory | 512kB SRAM, 16MB QSPI XiP Flash |
| Display | 320x240 IPS (32-bit color) – 160x120 framebuffer pixel-doubled |
| Connectivity | WiFi 802.11b/g/n (2.4GHz), Bluetooth 5.2 |
| Input | 5 buttons (A, B, C, UP, DOWN), IR receiver |
| Output | Full RGB display, 4-zone LED backlight, IR transmitter |
| Power | 1000mAh rechargeable Li-ion (~8 hours typical) |
| Ports | USB-C (power + data), Qw/ST, SWD, 4x GPIO |
Installation
Prerequisites
✓ macOS, Linux, or Windows computer
✓ Universe 2025 (Tufty) Badge
✓ USB-C cable (data-capable)
✓ Python 3.8+
✓ Claude Code installed
Quick Install
# In Claude Code
/plugin marketplace add johnlindquist/badger-2350-plugin
/plugin install badger-2350-dev@johnlindquist
Restart Claude Code to activate the plugin.
Verify Installation
# Check commands are available
/help
# Verify environment
/badge-quickstart
Quick Start: Your First App
Step 1: Create App Structure
/create-badge-app my_first_app
Expected Output:
✓ Created my_first_app/
├── __init__.py (template code)
├── icon.png (24x24 placeholder)
└── assets/ (optional resources)
Step 2: Test Locally
mpremote run my_first_app/__init__.py
Expected Output: Badge display shows "Hello Badge!" with animation
Step 3: Customize Your App
- Edit
my_first_app/__init__.py
- Add your logic to the
update() function
- Test again with:
mpremote run my_first_app/__init__.py
Step 4: Deploy to Badge
/deploy-to-badge my_first_app
Follow the step-by-step USB Mass Storage Mode instructions.
Step 5: Launch from Badge Menu
- Press HOME button on badge
- Use UP/DOWN to find your app
- Press B to launch
🎉 Success! Your custom app is now running on your badge!
Core Concepts
MonaOS App Structure
Every app is a directory in /system/apps/:
my_app/
├── __init__.py # REQUIRED: Entry point
├── icon.png # REQUIRED: 24x24 PNG
└── assets/ # OPTIONAL: Resources (auto-loaded)
└── ...
Required Functions
| Function | Required? | Called | Purpose |
|---|
init() | Optional | Once on app launch | Initialize state, load resources |
update() | YES | Every frame (~30 FPS) | Draw frame, handle input, update state |
on_exit() | Optional | On exit to menu | Cleanup, save state |
Minimal Working App
from badgeware import screen, brushes
johnlindquist