launch-calcium/sticker-studio-dressup

Sticker Studio — Dress-Up Game

A lightweight, static-PNG dress-up game (window / canvas based). Pick a base character, tap clothing & accessory assets to add them onto the canvas, drag to reposition (mouse and touch), and Save a flattened PNG of your creation. Upload your own images into the Characters or Wardrobe libraries (persisted on the backend).

Tech Stack

• —Frontend: React 19, Tailwind, shadcn/ui, framer-motion (HTML <canvas> stage, Pointer Events for mouse+touch)
• —Backend: FastAPI (images stored as base64 in MongoDB, served as data URLs so canvas export never taints)
• —DB: MongoDB

Repository Layout

• —backend/ — FastAPI app (server.py) + procedural starter-asset generator (seed_assets.py)
• —frontend/ — React app (src/App.js, src/components/DressUpStage.js, trays, dialogs)
• —tests/poc_core_test.py — core proof-of-concept test
• —used-assets-legal-info.md — licensing info for bundled starter art

Starter Assets Licensing

All bundled starter characters and wardrobe items are 100% original artwork, generated procedurally in code (Pillow) and released as CC0 1.0 (public domain). See used-assets-legal-info.md.

Run Locally

# Backend
cd backend && pip install -r requirements.txt && uvicorn server:app --host 0.0.0.0 --port 8001
# Frontend
cd frontend && yarn install && yarn start

Note: .env files here contain only local/non-secret defaults (e.g. MONGO_URL=mongodb://localhost:27017).