Pride Plugin 🏳️🌈
Pride flags, rainbow color patterns, hearts, and LGBTQ+ history for your FiestaBoard split-flap display.
→ Setup Guide — Modes, selection, and pool filters
Overview
The Pride plugin renders 21 distinct art pieces on the 8-tile board palette: 12 stripe flags, 3 vertical-stripe variants, 4 patterns (diagonal, checker, arc, alive sparkle), a rainbow heart, and an equality symbol. Pieces can be picked explicitly, rotated on a timer, picked deterministically per calendar day, or drawn randomly. An optional category pool restricts the candidates to flags, patterns, hearts, or symbols. Pure local rendering — no network, no API keys.
Every board is supported automatically. There is one {{pride.art}} variable and it is always drawn to the exact dimensions of the board it lands on — a Flagship (22×6), a Note (15×3), or a note array of any size from 15×3 up to 120×24, which is also what a FiestaPanel is. No device setting needed, and one configuration serves every board you own.
Flags keep every stripe at every size. Where a board has fewer rows than a flag has stripes — a six-stripe Leather flag on a three-row Note — the flag is turned a quarter turn and drawn as vertical bands, because the board's width has room for every stripe in order. A rotated flag is still recognisably that flag; a flag missing a stripe is a different flag.
Art Pieces
Flags (13)
Rainbow, Trans, Bi, Pan, Lesbian, Ace, Non-binary, Progress, Intersex, Leather, Polyamory, Genderfluid, Ally (black/white stripes with a centered rainbow pyramid).
Patterns (7)
- Rainbow Columns / Trans Columns / Bi Columns — vertical-stripe variants
- Rainbow Diagonal — diagonal rainbow sweep
- Rainbow Checker — 2×2 colored blocks cycling through the spectrum
- Rainbow Arc — centered pyramid bands, red on top
- Rainbow Sparkle — slowly-evolving sparkle field; one tile changes every 30 seconds, so it feels alive without being loud. The state is derived from wall-clock time, so two boards in the same room stay in sync.
Hearts (1)
- Rainbow Heart — red apex fading to violet point, drawn from a scale-free outline so it keeps its shape on any board. A short, very wide board (a 120×3 array) is filled with a row of hearts rather than one small one.
Symbols (1)
- Equality — two yellow bars on a blue field, HRC-style
Selection Modes
| Mode | Behavior |
|---|
pick | Render the explicit piece setting |
rotate | Cycle through the pool on rotate_seconds (default 10 minutes) |
daily | One piece per calendar day, deterministic across reboots |
random | Re-roll each fetch |
The pool setting (a list of categories: flag, pattern, heart, symbol) restricts the candidates for rotate/daily/random. Empty pool = all 21 pieces.
Color Approximations
The Vestaboard's 8-tile palette has no pink, brown, or cyan, so several flags lean on the nearest substitute:
| Real color | Tile used |
|---|
| Pink | {red} |
| Magenta | {violet} |
| Gray | {white} |
| Cyan | {blue} |
| Brown | (omitted) |
Template Variables
{{pride.art}} # Active piece, sized to whatever board it renders on
{{pride.piece_id}} # e.g. "rainbow", "rainbow_heart", "equality"
{{pride.piece_name}} # e.g. "Rainbow", "Rainbow Heart", "Equality"
{{pride.piece_category}} # "flag", "pattern", "heart", "symbol", "history"
{{pride.tagline}} # e.g. "Love is love", "Alive and slow"
{{pride.mode}} # "art" or "history"
{{pride.history_year}} # Year of today's history entry (history mode)
{{pride.history_text}} # Text of today's history entry (history mode)
Configuration
| Setting | Default | Description |
|---|
enabled | false | Master switch |
mode | art | art or history |
selection | rotate | pick, rotate, daily, random |
piece | rainbow | Used when selection = pick |
pool | [] | Categories for rotate/daily/random (empty = all) |
rotate_seconds | 600 | Rotation interval |
message | "" | Optional centered overlay (≤ 120 chars, the widest board). Reflowed to the board's width, so it may take more than one row on a narrow board. |
refresh_seconds | 300 | How often to recompute. Set to 30 to let the alive Rainbow Sparkle evolve smoothly. |
Environment variable equivalents (prefix PRIDE_*) are listed in manifest.json.
Testing
python -m pytest tests/ -v
Tests cover every piece on every board shape (Flagship, Note, 30×12 panel, tall-narrow 15×12, wide-short 120×3 and the 120×24 maximum), all four selection modes, pool filtering, message overlay, the alive-sparkle mutation behavior, and history lookup. No network.
tests/test_board_conformance.py runs FiestaBoard core's shared board-geometry conformance suite (src.plugins.geometry_conformance) — the same checks core holds its own plugins to.
Roadmap
- v0.3 — Progress chevron, Intersex ring, Leather heart, Poly infinity overlays; Pride Month countdown; awareness-day auto-flag matching
- v0.4 — Pride parade countdown by city; LGBTQ+ icon quote-of-the-day; rainbow gradient text helper; webhook "celebrate" trigger
License
MIT — see LICENSE.
