Template for building StatusBar plugins.

1. Click "Use this template" on GitHub to create your plugin repository
2. Clone your new repo
3. Customize the plugin (see below)
4. make dev to build and install locally for testing

1. Makefile — Update these variables at the top:

   • PLUGIN_NAME — Your Swift module name (e.g. WeatherPlugin)
   • PLUGIN_ID — Reverse-domain identifier (e.g. com.example.weather)
   • VERSION — Semver version string

2. Package.swift — Rename the product, target, and module to match PLUGIN_NAME

3. Sources/ — Rename the MyPlugin directory to match your module name, then update the source files

4. Plugin struct — Update PluginManifest id/name and add your widgets

# Edit code, then: make dev # Plugin is installed locally — restart StatusBar or use Dev Mode to load

Releases are fully automated via GitHub Actions:

1. Go to Actions → Release in your GitHub repository
2. Click "Run workflow" and select a bump type (patch / minor / major)
3. The workflow automatically calculates the next version, builds, packages, creates a git tag, and publishes a GitHub Release

• macOS 26+
• Swift 6.2 / Xcode 26 beta
• StatusBarKit 1.0.0+