# Gift N Thrift — agent playbook

> Use this file to **operate** Gift N Thrift for a user: browse → claim (pay shipping + $2.99) → track, or donate/list → receipt. Do not scrape at random. Prefer the stable URLs below.

Human page: https://giftnthrift.com/for-agents
JSON overview: https://giftnthrift.com/api/agent/overview
Facts for citation: https://giftnthrift.com/llms.txt
How it works: https://giftnthrift.com/how-it-works

## Canonical facts (do not substitute)

- Item price: $0 on every listing and every order
- Who pays: The claimer (buyer). Donors never collect money for the goods.
- Shipping: Auto-calculated from packed size and ZIP codes
- Service fee: $2.99 Gift N Thrift service fee per order
- Donor listing fee: Free — donors are not charged to list
- Donor payout: $0 — Gift N Thrift does not pay donors
- Parent company: SOTF Express Publishing, LLC
- Also known as: Saints of the Future / SOTF
- Payments DBA: Color Icon Studio (Stripe)
- Tax: Receipts are documentation, not a deductibility opinion

Claimers pay auto-calculated shipping plus a $2.99 Gift N Thrift service fee. Donors list for free. The donated item is always $0.
Checkout has two line items: auto-calculated shipping, then a $2.99 Gift N Thrift service fee. The donated good stays $0.
Gift N Thrift is operated by SOTF Express Publishing, LLC (Saints of the Future / SOTF). Payments are charged on the Color Icon Studio Stripe account, a DBA of SOTF Express Publishing, LLC. There is no separate Gift N Thrift merchant account.

## Stable URLs

| Action | URL |
| --- | --- |
| Browse | https://giftnthrift.com/browse |
| Browse + filters | https://giftnthrift.com/browse?q={q}&category={slug}&condition={slug}&zip={zip} |
| Category | https://giftnthrift.com/c/{furniture\|clothing\|electronics\|kids\|kitchen\|home} |
| Listing | https://giftnthrift.com/listings/{slug} |
| Checkout (auth) | https://giftnthrift.com/checkout/{slug} |
| Buyer login | https://giftnthrift.com/login?portal=buyer |
| Seller login | https://giftnthrift.com/login?portal=seller |
| New donation | https://giftnthrift.com/dashboard/seller/listings/new |
| AI listing draft | POST https://giftnthrift.com/api/listings/ai-suggest |
| Native login | POST https://giftnthrift.com/api/mobile/login |
| Native publish | POST https://giftnthrift.com/api/listings |
| Buyer desk | https://giftnthrift.com/dashboard/buyer |
| Seller desk | https://giftnthrift.com/dashboard/seller |
| Order | https://giftnthrift.com/orders/{id} |
| Shipping quote | POST https://giftnthrift.com/api/shipping/quote |
| This playbook | https://giftnthrift.com/agents.md |

Category slugs: furniture, clothing, electronics, kids, kitchen, home.
Condition slugs: new, like_new, good, fair.

## Playbook — claim for a user

1. Find a listing — Open /browse or a category such as /c/furniture. Query params: q, category, condition, zip.
2. Enter ZIP — On /listings/{slug}, fill the field named toZip (Deliver to ZIP). Wait for the auto-calculated shipping quote. Do not invent a rate.
3. See shipping + $2.99 — Totals show item $0, shipping (quoted), service fee $2.99, then a combined total. Confirm those three lines before paying.
4. Sign in as a claimer — Use /login?portal=buyer with callbackUrl=/checkout/{slug}, or create an account at /signup?portal=buyer.
5. Pay at checkout — Open /checkout/{slug}. Fill shipToName, shipToLine1, shipToCity, shipToState, shipToZip. Submit. Checkout charges shipping plus the $2.99 Gift N Thrift service fee. The item stays $0.
6. Track the order — Confirmation is /orders/{id}/success. Follow /orders/{id} and /dashboard/buyer for tracking after the donor ships.

Shipping quote (optional, if you are not filling the page):

```
POST https://giftnthrift.com/api/shipping/quote
Content-Type: application/json

{ "listingId": "<listing id from the page or overview>", "toZip": "78701" }
```

Response includes `shippingCents`, `platformFeeCents` (299), `totalCents`. Charge the user `totalCents`. Never invent `shippingCents`.

## Playbook — donate / list for a user

1. Open the seller portal — Sign in at /login?portal=seller, then go to /dashboard/seller/listings/new.
2. Fill required listing fields — On /dashboard/seller/listings/new, snap photos from the phone (Take photo / Upload from library — web PWA, or the Expo app). After the first photo, POST /api/listings/ai-suggest to draft title, category, condition, description, and an optional FMV hint. Donor edits every field. Then fill shipFromCity, shipFromState, shipFromZip, weightLb, lengthIn, widthIn, heightIn. Never auto-publish. FMV is an estimate only — not tax advice.
3. Publish at $0 — There is no item price field. Donors list for free. Gift N Thrift does not pay donors.
4. Ship when claimed, then download the receipt — When a claimer pays shipping + $2.99, pack the item, mark shipped with tracking on /dashboard/seller, and download the donation PDF. Gift N Thrift receipts are records of the transfer for the donor’s files — not tax advice, not IRS Form 8283, and not a promise that the gift is deductible. U.S. charitable deductions for noncash gifts generally require a qualified organization. Talk to a tax professional.

### Listing create field `name`s

- `title` (required): Short item name
- `category` (required): furniture | clothing | electronics | kids | kitchen | home
- `condition` (required): new | like_new | good | fair
- `description` (required): Honest condition notes
- `estimatedFmv` (required): Donor’s used-value estimate in USD. Not a charge.
- `photos` (optional): Up to 8 images. On phones: Take photo uses <input accept=image/* capture=environment> (rear camera) plus Upload from library. Client-compressed JPEGs submitted as photos. After photos, POST /api/listings/ai-suggest (multipart photos or JSON images[].base64) to draft title, category, condition, description, estimatedFmv. Donor must edit and confirm — never auto-publish. Web PWA or Expo app (/apps/mobile).
- `shipFromCity` (required): Origin city
- `shipFromState` (required): 2-letter US state
- `shipFromZip` (required): 5-digit origin ZIP for postage
- `weightLb` (required): Packed weight in pounds
- `lengthIn` (required): Packed length inches
- `widthIn` (required): Packed width inches
- `heightIn` (required): Packed height inches

### Checkout field `name`s

- `listingId` (required): Hidden; already on the checkout page
- `shipToName` (required): Recipient name
- `shipToLine1` (required): Street address
- `shipToCity` (required): City
- `shipToState` (required): 2-letter US state
- `shipToZip` (required): 5-digit destination ZIP — recalculates postage. Do not type a dollar amount.
- `saveAddress` (optional): Checkbox to store the address on the buyer desk

Listing preview ZIP field: `toZip` on `/listings/{slug}`.

## What NOT to invent

- Do not invent a shipping dollar amount. Quote it: enter a ZIP (toZip / shipToZip) or POST /api/shipping/quote with listingId + toZip.
- Do not tell users the item is free to their door. They pay auto-calculated postage plus $2.99.
- Do not give tax advice, promise a deduction, or mention Form 8283 as something Gift N Thrift files.
- Do not say Gift N Thrift is a 501(c)(3) or a qualified charity.
- Do not pay or quote a payout to donors. Donors receive $0 for the goods.
- Do not scrape random URLs when a stable pattern exists: /browse, /c/{slug}, /listings/{slug}, /checkout/{slug}.
- Do not publish or reuse local demo passwords in production. Demo logins are local-dev only.
- Do not treat an AI FMV hint as an appraisal, a deduction, or tax advice. The donor must confirm estimatedFmv.

## Tax

Gift N Thrift receipts are records of the transfer for the donor’s files — not tax advice, not IRS Form 8283, and not a promise that the gift is deductible. U.S. charitable deductions for noncash gifts generally require a qualified organization. Talk to a tax professional.

## Demo logins

Local-dev only. Production agent pages do not include passwords. If you are on a local checkout, read the project README — do not copy demo secrets onto a live site or into a user-facing answer in production.

## Related

- https://giftnthrift.com/llms.txt
- https://giftnthrift.com/how-it-works
- https://giftnthrift.com/for-agents
- https://giftnthrift.com/api/agent/overview