Files
gregWiki/docs/contributors/sponsorship-automation.md
Marvin e2839584f4 Merge Docusaurus site: all content under docs/, align with gregFramework split layout
- Move markdown and wiki-import tree into docs/; keep app shell at repo root
- Point docusaurus docs path to docs/; edit links to mleem97/gregWiki
- Sync and i18n scripts use gregWiki root and ../.wiki under gregFramework
- Sidebars: workspace layout from root docs ids; plugins under mods/extensions
- Fix redirects, module catalog URLs, release note paths, and wiki-import category keys
- Update repo inventory for split repos; Dockerfile for single-repo context

Made-with: Cursor
2026-04-09 23:39:32 +02:00

1.6 KiB
Raw Blame History

Sponsorship Automation

This document describes the standard automation flow for GregFramework sponsorship tiers.

Goal

Keep sponsor tier data synchronized and use it as a source of truth for:

  • Discord role sync
  • private/VIP channel access
  • website and wiki placements
  • Mod Store footer sponsor block
  • in-repo sponsor pages and credits

Repository Workflow

Each repository contains .github/workflows/sponsor-tier-sync.yml.

The workflow:

  1. runs hourly (and on manual trigger),
  2. queries active GitHub Sponsors,
  3. exports normalized data to sponsors/sponsors.json,
  4. commits changes automatically when sponsor data changes.

Required Secret

Add this repository secret:

  • SPONSORS_READ_TOKEN: GitHub PAT with access to read sponsor relationships.

Without this secret, the workflow still completes but exports an empty snapshot.

Tier Mapping

Use this mapping in downstream systems:

  • $1 -> coffee_supporter
  • $5 -> bronze_backer
  • $15 -> silver_tester
  • $25 -> gold_developer
  • $50+ -> ecosystem_architect

VIP Operational Rules

For $50+ sponsors:

  • assign top sponsor placement (Wiki front page + Mod Store footer)
  • create/maintain private 1-on-1 Discord lounge
  • offer featured mod spotlight

Example Consumer Script (Discord/Wiki Sync)

Use sponsors/sponsors.json as input and run a separate scheduled job (bot or CI worker) that:

  1. maps each sponsor to a tier role,
  2. grants/revokes Discord roles,
  3. maintains VIP private channels,
  4. updates website/wiki data endpoints.

First Verified VIP

Current VIP sponsor: