max / makenotwork

Add docs for cart, wishlist, and creator pause Three previously undocumented features now have public guide pages. Updated fan guide with cart/wishlist references and doc coverage matrix. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Max J. <87768334+MaxJMath@users.noreply.github.com> · 2026-05-09 21:42 UTC

Commit: a18b4905966061d6215ccfef5ba9d81f20234ea5

Parent: 92a0869

6 files changed, +148 insertions, -5 deletions

M server/docs/doc_coverage_matrix.md +3

			@@ -34,6 +34,9 @@ Three documentation levels for every feature. Source: codebase harness DB (727 m
34	34
35	35		\| Feature \| Code Modules \| Inline (//!) \| Rustdoc \| Public Doc \|
36	36		\|---------\|-------------\|:---:\|:---:\|:---:\|
	37	+	\| Shopping cart \| routes/api/cart.rs, routes/stripe/checkout/cart.rs, db/cart.rs \| Y \| -- \| guide/cart \|
	38	+	\| Wishlist \| routes/api/wishlists.rs, db/wishlists.rs \| Y \| -- \| guide/wishlist \|
	39	+	\| Creator pause \| routes/api/users/profile.rs, db/users.rs \| Y \| -- \| guide/creator-pause \|
37	40		\| Stripe Connect \| routes/stripe/.rs, payments/.rs \| Y \| -- \| guide/03-selling, guide/payouts \|
38	41		\| Checkout (items) \| routes/stripe/checkout/item.rs \| Y \| -- \| guide/03-selling \|
39	42		\| Checkout (subscriptions) \| routes/stripe/checkout/subscriptions.rs \| Y \| -- \| guide/tiers \|

M server/docs/todo.md +3 -3

			@@ -23,9 +23,9 @@ Priority order. See `human_todo.md` for the full manual testing feature map.
23	23
24	24		These features are implemented but have no public-facing documentation yet. Add docs in the next documentation push.
25	25
26		-	- [ ] Shopping cart: multi-item checkout with per-seller Stripe sessions (`routes/api/cart.rs`, `routes/stripe/checkout/cart.rs`, `templates/pages/cart.html`, migration 096)
27		-	- [ ] Wishlist: save items for later (`routes/api/wishlists.rs`)
28		-	- [ ] Creator pause: voluntary membership pause with graceful fan subscription degradation (migration 093, 22 files reference `creator_pause`)
	26	+	- [x] Shopping cart: `site-docs/public/guide/cart.md`
	27	+	- [x] Wishlist: `site-docs/public/guide/wishlist.md`
	28	+	- [x] Creator pause: `site-docs/public/guide/creator-pause.md`
29	29
30	30		---
31	31

A server/site-docs/public/guide/cart.md +50

		@@ -0,0 +1,50 @@
1	+	# Shopping Cart
2	+
3	+	Add items from multiple creators to a single cart and check out in one flow.
4	+
5	+	## Adding Items
6	+
7	+	Click Add to Cart on any item page. Items persist across sessions and devices. Each item can only appear once in your cart. To remove an item, click the remove button on the cart page or toggle the cart button on the item page.
8	+
9	+	## Cart Page
10	+
11	+	Your cart groups items by creator. Each group shows a subtotal and Stripe processing fee estimate (~2.9% + $0.30). The platform fee is always $0.
12	+
13	+	If you have items on your [wishlist](./fan-guide.md), suggestions appear below your cart with quick "Add to Cart" buttons.
14	+
15	+	## Pay-What-You-Want in Cart
16	+
17	+	Items with pay-what-you-want pricing show an inline price input. Set any amount at or above the creator's minimum. The maximum is $10,000 per item. Your chosen amount is saved automatically.
18	+
19	+	## Checkout
20	+
21	+	Two options:
22	+
23	+	- Single creator: Click Checkout under a specific creator's items to pay for just that group
24	+	- All creators: Click Checkout All to process every creator in sequence
25	+
26	+	Each creator gets a separate Stripe Checkout session routed to their connected account. After completing one, you're automatically directed to the next. Items are removed from your cart as each payment completes.
27	+
28	+	If checkout is interrupted partway through a multi-creator flow, completed purchases are saved and remaining items stay in your cart for later.
29	+
30	+	## Promo Codes
31	+
32	+	Enter a promo code in the checkout form for a specific creator's items. Discount and free access codes work in cart checkout. Free trial codes are for subscriptions only and cannot be used in the cart.
33	+
34	+	If a code reduces an item to $0, that item is claimed as a free purchase before the Stripe session starts.
35	+
36	+	Promo codes cannot be applied to pay-what-you-want items.
37	+
38	+	## Limits and Edge Cases
39	+
40	+	- No hard limit on cart size, but items must be public and available at checkout time
41	+	- Unpublished or deleted items are automatically removed
42	+	- Items you already own are filtered out at checkout
43	+	- If a creator has paused their account, checkout for their items is blocked until they resume
44	+	- Stale cart items (older than 90 days) are cleaned up automatically
45	+
46	+	## See Also
47	+
48	+	- [Fan Guide](./fan-guide.md) -- overview of purchasing on the platform
49	+	- [Promo Codes](./promo-codes.md) -- creating and using discount codes
50	+	- [Pricing](./pricing.md) -- pay-what-you-want and fixed pricing

A server/site-docs/public/guide/creator-pause.md +54

		@@ -0,0 +1,54 @@
1	+	# Creator Pause
2	+
3	+	Take a break from selling without deleting your account or losing your content.
4	+
5	+	## How It Works
6	+
7	+	Pausing your creator account stops new sales while keeping everything you've built. Your content stays hosted, existing purchases remain accessible to buyers, and you can resume at any time.
8	+
9	+	Go to Account Settings and click Pause Creator Account. You'll see a confirmation explaining what happens.
10	+
11	+	## What Changes When You Pause
12	+
13	+	For you:
14	+	- Your creator tier subscription is canceled (no more monthly fee)
15	+	- New purchases, subscriptions, and tips are blocked
16	+	- Your content remains hosted indefinitely
17	+	- Your profile stays visible with a notice that you're on break
18	+
19	+	For your fans:
20	+	- Active memberships are set to expire at the end of their current billing period (not canceled immediately)
21	+	- Fans keep access through the remainder of their paid period
22	+	- One-time purchases and downloads remain accessible forever
23	+	- No automated email is sent to fans about the pause
24	+
25	+	## Resuming
26	+
27	+	Re-subscribe to a creator tier. When your new subscription activates, your account is automatically unpaused:
28	+
29	+	- The pause flag is cleared
30	+	- Active fan subscriptions that haven't yet expired are un-canceled (they continue as normal)
31	+	- New purchases are accepted again
32	+
33	+	There is no separate "resume" button. Subscribing to a tier is the resume action.
34	+
35	+	## Pause vs. Delete
36	+
37	+	\| \| Pause \| Delete \|
38	+	\|---\|---\|---\|
39	+	\| Content hosted \| Indefinitely \| Removed after 90 days \|
40	+	\| Fan purchases accessible \| Yes \| Yes (downloads already made) \|
41	+	\| Fan subscriptions \| Expire at period end \| Canceled immediately \|
42	+	\| Resume \| Re-subscribe to tier \| Not reversible \|
43	+	\| Monthly fee \| None while paused \| N/A \|
44	+
45	+	## Limits
46	+
47	+	- No time limit on how long you can stay paused
48	+	- Suspended or deactivated accounts cannot pause (contact support)
49	+	- You must be an active creator (have a project) to use this feature
50	+
51	+	## See Also
52	+
53	+	- [Tiers](./tiers.md) -- creator tier pricing and features
54	+	- [Account Lifecycle](./account-lifecycle.md) -- account states and transitions

M server/site-docs/public/guide/fan-guide.md +8 -2

			@@ -52,6 +52,10 @@ The [tag tree](/discover/tags) lets you browse the full tag hierarchy visually.
52	52
53	53		Once you follow creators, projects, or tags, your [feed](/feed) shows new items from everything you follow. No notifications by default, just your feed.
54	54
	55	+	## Cart and Wishlist
	56	+
	57	+	Add items to your [shopping cart](./cart.md) to buy multiple items in one checkout flow, even from different creators. Save items for later with your [wishlist](./wishlist.md). Wishlisted items appear as suggestions on your cart page.
	58	+
55	59		## Your Library
56	60
57	61		Your library at `/library` contains purchases (yours forever), active memberships (access while subscribed), license keys, and free claims. Each entry links to the item page for streaming or download.
			@@ -88,5 +92,7 @@ No analytics cookies, ads, browsing history collection, or device fingerprinting
88	92
89	93		## See Also
90	94
91		-	- [Contact Sharing](./contact-sharing.md): Sharing your email with creators
92		-	- [Pricing & Monetization](./03-selling.md): How pricing works
	95	+	- [Shopping Cart](./cart.md) -- buying multiple items at once
	96	+	- [Wishlist](./wishlist.md) -- saving items for later
	97	+	- [Contact Sharing](./contact-sharing.md) -- sharing your email with creators
	98	+	- [Pricing & Monetization](./03-selling.md) -- how pricing works

A server/site-docs/public/guide/wishlist.md +30

		@@ -0,0 +1,30 @@
1	+	# Wishlist
2	+
3	+	Save items you're interested in and come back to them later.
4	+
5	+	## Adding Items
6	+
7	+	Click the wishlist button on any item page to toggle it. Wishlisting is instant and works on any public item. Click again to remove.
8	+
9	+	Your wishlist is private. Other users and creators cannot see what you've wishlisted.
10	+
11	+	## Viewing Your Wishlist
12	+
13	+	Open your library and switch to the Wishlist tab. Items are sorted by when you added them, newest first. Each entry shows the item title, creator, and current price.
14	+
15	+	If an item is later deleted or unpublished by the creator, it disappears from your wishlist automatically.
16	+
17	+	## Cart Integration
18	+
19	+	When you have items in your [shopping cart](./cart.md), your wishlisted items appear as suggestions below the cart. Click Add to Cart to move a wishlisted item into your cart for checkout.
20	+
21	+	## Limits
22	+
23	+	- Maximum 200 items on your wishlist
24	+	- Items persist indefinitely unless removed by you or deleted by the creator
25	+	- Each item can only appear once
26	+
27	+	## See Also
28	+
29	+	- [Cart](./cart.md) -- checking out with multiple items
30	+	- [Fan Guide](./fan-guide.md) -- overview of purchasing on the platform