|
| 1 | +# Avatar Mapping for Hyperpolymath Repos |
| 2 | + |
| 3 | +This file maps each GitHub repo to its corresponding avatar for social preview images. |
| 4 | + |
| 5 | +## Specific Project Avatars |
| 6 | + |
| 7 | +These repos have custom-designed avatars: |
| 8 | + |
| 9 | +| Repo | Avatar File | |
| 10 | +|------|-------------| |
| 11 | +| hyperpolymath.github.io | hyperpolymath.svg | |
| 12 | +| claude-firefox-mcp | claude-firefox-mcp.svg | |
| 13 | +| poly-container-mcp | poly-container-mcp.svg | |
| 14 | +| poly-secret-mcp | poly-secret-mcp.svg | |
| 15 | +| poly-queue-mcp | poly-queue-mcp.svg | |
| 16 | +| poly-iac-mcp | poly-iac-mcp.svg | |
| 17 | +| poly-observability-mcp | poly-observability-mcp.svg | |
| 18 | +| poly-ssg-mcp | poly-ssg.svg | |
| 19 | +| seamstress | seamstress.svg | |
| 20 | +| seambot | seambot.svg | |
| 21 | +| my-lang | my-lang.svg | |
| 22 | +| rhodium-standard-repositories | rhodium-standard.svg | |
| 23 | +| flatracoon-netstack | flatracoon-netstack.svg | |
| 24 | +| echidna | echidna.svg | |
| 25 | +| echidnabot | echidnabot.svg | |
| 26 | +| gitvisor | gitvisor.svg | |
| 27 | +| laminar | laminar.svg | |
| 28 | +| scaffoldia | scaffoldia.svg | |
| 29 | +| llm-unify | llm-unify.svg | |
| 30 | +| llm-verify | llm-verify.svg | |
| 31 | +| supernorma | supernorma.svg | |
| 32 | +| bunsenite | bunsenite.svg | |
| 33 | +| januskey | januskey.svg | |
| 34 | +| svalinn | svalinn.svg | |
| 35 | +| czech-file-knife | czech-file-knife.svg | |
| 36 | +| polyglot-i18n | polyglot-i18n.svg | |
| 37 | +| ubicity | ubicity.svg | |
| 38 | +| robot-vacuum-cleaner | robot-vacuum-cleaner.svg | |
| 39 | +| proof-of-work | proof-of-work.svg | |
| 40 | +| affinescript | affinescript.svg | |
| 41 | +| asdfghj | asdfghj.svg | |
| 42 | +| blue-screen-of-app | blue-screen-of-app.svg | |
| 43 | +| thejeffparadox | thejeffparadox.svg | |
| 44 | +| git-eco-bot | git-eco-bot.svg | |
| 45 | +| rhodibot | rhodibot.svg | |
| 46 | +| hackenbush-ssg | hackenbush-ssg.svg | |
| 47 | + |
| 48 | +## Category Avatars |
| 49 | + |
| 50 | +Use these generic avatars based on repo category: |
| 51 | + |
| 52 | +### MCP Protocol Repos → mcp-generic.svg |
| 53 | +- poly-*-mcp (any not listed above) |
| 54 | +- Any MCP server implementations |
| 55 | + |
| 56 | +### Static Site Generators → ssg-generic.svg |
| 57 | +- *-ssg repos |
| 58 | +- Static site related tools |
| 59 | +- eleventy-*, hugo-*, jekyll-* forks |
| 60 | + |
| 61 | +### Bot/Automation Repos → bot-generic.svg |
| 62 | +- *bot repos (unless specific avatar exists) |
| 63 | +- robot-repo-bot |
| 64 | +- automation tools |
| 65 | + |
| 66 | +### LLM/AI Repos → llm-generic.svg |
| 67 | +- llm-* repos (unless specific avatar exists) |
| 68 | +- AI-related tools |
| 69 | + |
| 70 | +### Security Repos → security-generic.svg |
| 71 | +- Security tools |
| 72 | +- Vulnerability scanners |
| 73 | +- Auth libraries (unless specific) |
| 74 | + |
| 75 | +### Network/Infrastructure → network-generic.svg |
| 76 | +- Network tools |
| 77 | +- Infrastructure projects |
| 78 | + |
| 79 | +### Git Tools → git-generic.svg |
| 80 | +- git-* repos |
| 81 | +- Version control tools |
| 82 | + |
| 83 | +### Language/Compiler → language-generic.svg |
| 84 | +- Programming language implementations |
| 85 | +- Compilers, interpreters |
| 86 | + |
| 87 | +### IndieWeb → indieweb-generic.svg |
| 88 | +- IndieWeb implementations |
| 89 | +- Webmention tools |
| 90 | +- Personal web projects |
| 91 | + |
| 92 | +### WordPress → wordpress-generic.svg |
| 93 | +- WordPress themes/plugins |
| 94 | + |
| 95 | +### DevTools → devtools-generic.svg |
| 96 | +- Development utilities |
| 97 | +- Editor plugins |
| 98 | +- IDE integrations |
| 99 | + |
| 100 | +### CLI Tools → cli-generic.svg |
| 101 | +- Command line tools |
| 102 | +- Terminal utilities |
| 103 | + |
| 104 | +### API/Backend → api-generic.svg |
| 105 | +- REST APIs |
| 106 | +- GraphQL services |
| 107 | +- Backend services |
| 108 | + |
| 109 | +### Testing → testing-generic.svg |
| 110 | +- Test frameworks |
| 111 | +- QA tools |
| 112 | + |
| 113 | +### Database → database-generic.svg |
| 114 | +- Database tools |
| 115 | +- ORM implementations |
| 116 | + |
| 117 | +### Auth → auth-generic.svg |
| 118 | +- Authentication libraries |
| 119 | +- OAuth implementations |
| 120 | + |
| 121 | +### CI/CD → cicd-generic.svg |
| 122 | +- Build tools |
| 123 | +- Pipeline configurations |
| 124 | + |
| 125 | +### Documentation → docs-generic.svg |
| 126 | +- Documentation repos |
| 127 | +- Guides and tutorials |
| 128 | + |
| 129 | +### Monitoring → monitoring-generic.svg |
| 130 | +- Observability tools |
| 131 | +- Metrics collectors |
| 132 | + |
| 133 | +### Crypto → crypto-generic.svg |
| 134 | +- Cryptography tools |
| 135 | +- Key management |
| 136 | + |
| 137 | +### Standards/Specs → standard-generic.svg |
| 138 | +- Specification repos |
| 139 | +- RFC implementations |
| 140 | + |
| 141 | +### Mobile → mobile-generic.svg |
| 142 | +- Mobile apps (Tauri, Dioxus) |
| 143 | +- iOS/Android projects |
| 144 | + |
| 145 | +### Mustfile/Config → mustfile-generic.svg |
| 146 | +- Configuration tools |
| 147 | +- Mustfile implementations |
| 148 | + |
| 149 | +### Parser/AST → parser-generic.svg |
| 150 | +- Parsers |
| 151 | +- Tree-sitter grammars |
| 152 | + |
| 153 | +### Queue/Events → queue-generic.svg |
| 154 | +- Message queues |
| 155 | +- Event systems |
| 156 | + |
| 157 | +### Archive → archive-generic.svg |
| 158 | +- Archived/historical repos |
| 159 | + |
| 160 | +### Zotero → zotero-generic.svg |
| 161 | +- Zotero plugins/integrations |
| 162 | + |
| 163 | +### SCM Spec Files → scm-spec-generic.svg |
| 164 | +- STATE.scm, META.scm specifications |
| 165 | + |
| 166 | +### AI/Neural → ai-neural-generic.svg |
| 167 | +- Neural network projects |
| 168 | +- Deep learning tools |
| 169 | + |
| 170 | +### Playground → playground-generic.svg |
| 171 | +- Experimental repos |
| 172 | +- Learning projects |
| 173 | + |
| 174 | +### Utilities → util-generic.svg |
| 175 | +- General utilities |
| 176 | +- Misc helper tools |
| 177 | + |
| 178 | +## PNG Conversion |
| 179 | + |
| 180 | +All SVGs should be converted to PNG at 1280x640 for GitHub social preview. |
| 181 | + |
| 182 | +Command: |
| 183 | +```bash |
| 184 | +for svg in avatars/*.svg; do |
| 185 | + png="${svg%.svg}.png" |
| 186 | + convert -background none "$svg" "avatars/png/$(basename $png)" |
| 187 | +done |
| 188 | +``` |
| 189 | + |
| 190 | +## Upload Instructions |
| 191 | + |
| 192 | +For each repo: |
| 193 | +1. Go to repo → Settings → General |
| 194 | +2. Scroll to "Social preview" |
| 195 | +3. Click "Edit" → "Upload an image" |
| 196 | +4. Select the corresponding PNG file |
| 197 | +5. Save |
0 commit comments