Mycopunk merchandise CLI and design management
Go to file
Jeff Emmett ba334be1c2 docs(backlog): add task for swag store deployment
- Document initial deployment and features
- Track bug fixes and pending items
2026-01-31 15:45:34 +00:00
backlog docs(backlog): add task for swag store deployment 2026-01-31 15:45:34 +00:00
cli feat(stickers): add build-tools-not-empires design 2026-01-25 09:29:30 +01:00
config feat: Initialize mycopunk-swag repository 2026-01-24 19:26:58 +01:00
designs/stickers feat(stickers): add build-infrastructure-not-empires design 2026-01-30 10:53:15 +00:00
docs feat: Initialize mycopunk-swag repository 2026-01-24 19:26:58 +01:00
scripts feat: Initialize mycopunk-swag repository 2026-01-24 19:26:58 +01:00
templates feat: Initialize mycopunk-swag repository 2026-01-24 19:26:58 +01:00
.gitignore feat: Initialize mycopunk-swag repository 2026-01-24 19:26:58 +01:00
CLAUDE.md feat: Initialize mycopunk-swag repository 2026-01-24 19:26:58 +01:00
LICENSE feat: Initialize mycopunk-swag repository 2026-01-24 19:26:58 +01:00
README.md feat: Initialize mycopunk-swag repository 2026-01-24 19:26:58 +01:00

README.md

🍄 Mycopunk Swag

Decentralized merchandise for the mycelial revolution.

A CLI-driven workflow for designing, managing, and distributing mycopunk merchandise (stickers, shirts, patches, zines) with automated print-on-demand fulfillment.

Philosophy

Like mycelium networks that share resources without central control, this project embodies:

  • Open source designs - Fork, remix, distribute
  • Decentralized production - POD means no inventory, no warehouses
  • Anarchist tech - Self-hosted, privacy-respecting, no platform lock-in
  • Community-driven - Contribute designs, suggest products, share the spores

Quick Start

# Install CLI
cd cli && pip install -e .

# Create a new design
mycopunk design new stickers/my-design --template=sticker-3x3

# Export to print-ready files
mycopunk design export stickers/my-design

# Validate against POD requirements
mycopunk design validate stickers/my-design

# Create product on POD service
mycopunk product create stickers/my-design --provider=prodigi

Project Structure

mycopunk-swag/
├── designs/           # Source design files (SVG, XCF)
│   ├── stickers/      # Sticker designs
│   ├── shirts/        # Apparel designs
│   └── misc/          # Patches, pins, zines
├── templates/         # POD service templates
├── cli/               # Python CLI tool
├── config/            # Product & pricing configuration
├── scripts/           # Helper scripts
└── docs/              # Documentation

Design Workflow

  1. Create - Design in Inkscape/GIMP, save as SVG
  2. Configure - Add metadata.yaml with product mappings
  3. Export - Generate print-ready PNGs at required DPIs
  4. Validate - Check against POD service requirements
  5. Push - Upload to Printful/Prodigi
  6. Mockup - Generate product mockups for shop

Print-on-Demand Providers

Provider Products Best For
Printful Apparel, accessories T-shirts, hoodies, quality
Prodigi Stickers, prints Vinyl stickers, art prints, global shipping

CLI Reference

See docs/cli-reference.md for full command documentation.

Core Commands

mycopunk design new <path>        # Create new design scaffold
mycopunk design list              # List all designs
mycopunk design export <path>     # Export to print formats
mycopunk design validate <path>   # Validate requirements

mycopunk product create <path>    # Create POD product
mycopunk product push <path>      # Push design to POD
mycopunk product list             # List all products

mycopunk mockup generate <path>   # Generate mockups
mycopunk catalog sync             # Sync POD catalogs

Contributing Designs

  1. Fork the repo
  2. Create your design in designs/ following the structure
  3. Add metadata.yaml with required fields
  4. Run mycopunk design validate to check requirements
  5. Submit a PR with mockups in the description

Design Requirements

  • Format: SVG (vectors) or high-res PNG (4800×4800 minimum)
  • Resolution: 300 DPI for all exports
  • Color Profile: sRGB
  • Transparency: PNG with transparent background preferred

See docs/design-guidelines.md for detailed specs.

License

Designs are released under CC BY-SA 4.0 unless otherwise noted. Code is released under MIT License.


Spread the spores. Decentralize everything. 🍄