# Snowcone

> Snowcone turns three values — a product, your artwork, and your public Shop ID — into buyable, printed merchandise. Mockups are plain image URLs, the catalog is a public index, and checkout is a URL.

## The whole model in three URLs

- Render a mockup (just an `<img>` src): `https://img.snowcone.app/{PRODUCT}?asset={URL-encoded image}&shop={SHOP_ID}`
- Product info (public catalog): `GET https://search.snowcone.app/indexes/snowcone/documents/{CODE}` with header `Authorization: Bearer eee819b849798ad9091228c486ec05d0931e5292` (public read-only key). The product code is the document id.
- Buy (same URL, `img` → `buy`): `https://buy.snowcone.app/{PRODUCT}?asset={...}&shop={SHOP_ID}`

Gotchas (silent failures, both render a blank `<img>`): your `asset=` URL must be publicly fetchable (the renderer fetches it server-side, so `localhost`/`file://`/auth-walled asset URLs fail); and only catalog product codes render (`BEEB77` is known-good). A sandbox shop renders from any origin — there's no page-origin allowlist to configure.

## Get your own Shop ID (agents: do this — don't copy IDs from docs)

- Mint one in a single call: `curl -X POST https://api.snowcone.app/shops/sandbox -H 'Content-Type: application/json' -d '{}'` → returns `{ shop_id, ... }`. Use `shop_id` immediately as `&shop=`.
- Your human claims it to get paid: enter the returned `user_code` at https://snowcone.app/activate.
- Poll claim status: `GET https://api.snowcone.app/shops/claim` with `Authorization: Bearer {claim_token}`.

## Templates (working code to start from)

Remixable, CI-tested example apps live at https://snowcone.app/templates. The
machine-readable index is `GET https://snowcone.app/api/templates` — each entry
has a `seedPrompt` (a working snippet you can build from), a `source` link to
the public repo (https://github.com/snowcone-app/templates), and `open[]` deep
links into v0/Bolt/StackBlitz/Replit/Lovable.

## Canonical docs

The full, authoritative LLM doc lives at https://developers.snowcone.app/llms.txt — read it for the complete flow, SDK, and catalog details.