badger-2350-dev

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

1. Press HOME button on badge
2. Use UP/DOWN to find your app
3. 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