elixpo/assets

Shared visual assets for the Elixpo project series — stickers, icons, banners, splash art. Everything orbits around Oreo, the pixel-art panda mascot.

Want to use these assets? Browse stickers/ and prompts/icons/. Want a new one made? Open an issue. A maintainer reviews, applies the approved label, and a bot generates the image straight into the repo.

---

Requesting an asset (community workflow)

1. Open an issue using the "Sticker / Icon Request" template. Describe the vibe in one or two lines. Optionally attach a doodle for reference.
2. A maintainer reviews the prompt against MASCOT.md. If it fits the brand, they apply the approved label.
3. The label fires a GitHub Action that:
   • Reads the prompt from the issue body,
   • Appends the canonical Mascot Clause and Style Suffix,
   • Calls Pollinations.ai to render a 1024×1024 image,
   • Runs the transparency pass for stickers,
   • Commits the result to requested/<issue-number>-<slug>.png,
   • Posts a comment on the issue with a link to the file + a permalink.
4. If the result misses the mark, add the regenerate label to retry with a different seed. Repeat as needed.

The maintainer review step is intentional — it stops drift, slop, and abuse of the generator.

---

Local generation

# Generate every sticker that has a prompt:
python tools/generate_assets.py --stickers

# Generate one sticker:
python tools/generate_assets.py --stickers 01_hello

# Strip the cream background to transparent (auto-run by the above):
python tools/sticker_transparency.py 01_hello

# Compile all stickers into a printable A4 sheet:
python tools/compile_sticker_sheet.py

The Pollinations endpoint is free and unauthenticated — no API key needed locally. The CI workflow uses the same endpoint.

---

Icon sync

Icon prompts (prompts/icons/) are mirrored from the OreoOS firmware repository (elixpo/oreo), where the icons live alongside the apps that use them. The upstream repo is the source of truth for icon prompts.

A scheduled GitHub Action on the upstream repo pushes any changes under prompts/icons/ to this repo every night. Do not edit prompts/icons/ here directly — your edits will be overwritten. Open a PR upstream instead.

---

Branding & legal

• The Oreo mascot character, the chest E-badge, and the brand palette in MASCOT.md are © 2026 Ayushman Bhattacharya and form part of the OreoOS copyright registration (Indian Copyright Office Diary LD-26455/2026-CO).
• Assets in this repository are licensed for community use under the repository's open licence (see LICENSE). The licence covers the assets; it does not transfer rights to the Oreo character for use outside Elixpo-aligned projects.
• The name "Oreo" is used here as an internal codename. The public brand for this project is Elixpo Badge — see MASCOT.md §Versioning.