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.