Monorepo for Aesthetic.Computer aesthetic.computer

Fork 0

core plans blank-checkout.md

7.8 kB

Markdown

at codex/xbox-api-layer

Jeffrey Alan Scudder · AC Blank: product page + Stripe checkout for AC Native laptops · 6mo ago

08592c30

Plan: `blank` — AC Native Laptop Product Page & Checkout #

What is a Blank? #

A Blank is a surplus/refurbished Lenovo ThinkPad Yoga 11e (Gen 4 or Gen 5) running AC Native OS — a pared-down creative computing environment with only stable, permanent commands. Like a blank tape or blank disc, it's an empty medium waiting to be filled.

Target price: ~$128 (covers hardware sourcing at ~$30–75/unit + AC OS flashing + shipping)

Architecture #

Existing Patterns to Follow #

The mug.js and print.js functions establish a clean Stripe checkout pattern:

piece (blank.mjs)  →  POST /api/blank?new=true  →  Stripe checkout session
                                                         ↓
                   ←  redirect to Stripe hosted checkout
                                                         ↓
webhook (POST /api/blank with stripe-signature)  →  order confirmation + email

Key pattern from mug/print:

POST ?new=true → creates Stripe checkout session, returns session.url
POST with stripe-signature header → webhook handler for checkout.session.completed
Uses respond() from backend/http.mjs
Uses email() from backend/email.mjs
Uses authorize() from backend/authorization.mjs (optional, for prefilling email)
Dev/prod key switching: dev ? STRIPE_API_TEST_PRIV_KEY : STRIPE_API_PRIV_KEY

Differences from Mug/Print #

	Mug/Print	Blank
Fulfillment	Printful POD (automated)	Manual (flash OS, ship laptop)
Inventory	Unlimited (on-demand)	Limited stock
Product image	Generated mockup	Static photo(s) of the laptop
Shipping	Printful handles	We handle (USPS/UPS)
Price	$10–$18	~$128

Because fulfillment is manual, the webhook just needs to:

Record the order in MongoDB
Send confirmation email to buyer
Notify us (email or webhook to Slack/Discord) that an order came in

Files to Create / Modify #

1. `system/netlify/functions/blank.mjs` — API endpoint #

New serverless function following the mug/print pattern:

GET  /api/blank          → product info (price, stock count, description)
POST /api/blank?new=true → create Stripe checkout session
POST /api/blank          → Stripe webhook (order confirmation)

Checkout session config:

mode: "payment"
shipping_address_collection: { allowed_countries: ["US"] } (expand later)
Product: "The Blank — AC Native Laptop"
Price: configured in code or via Stripe product ID
metadata: { type: "blank", model: "yoga-11e-gen5" }
Success URL: aesthetic.computer/blank:thanks
Cancel URL: aesthetic.computer/blank

Webhook handler:

Verify signature with STRIPE_ENDPOINT_BLANK_SECRET
Store order in MongoDB orders collection (or blank-orders)
Send buyer confirmation email
Send internal notification email to us

2. `system/public/aesthetic.computer/disks/blank.mjs` — The piece #

Replace the current WebGPU stress test with the Blank product page.

Piece behavior:

boot — fetch product info from /api/blank, set up Buy button
paint — render product page:
- Product image/photo of the Blank laptop
- "The Blank" title
- Description text (what it is, what it runs, what comes with it)
- Price
- Stock indicator (if limited)
- BUY button
act — handle Buy button click → POST /api/blank?new=true → redirect to Stripe
Optional: preview for link unfurling / social sharing

UI approach:

Keep it minimal — the page should feel like the product itself
Could start with just text + a buy button (very blank)
Photo(s) can be loaded from DO Spaces CDN

3. Environment Variables (netlify.toml / .env) #

STRIPE_ENDPOINT_BLANK_SECRET=whsec_...   # Webhook signing secret for /api/blank

No new Stripe keys needed — reuses existing STRIPE_API_PRIV_KEY / STRIPE_API_TEST_PRIV_KEY.

4. Stripe Dashboard Setup #

Create a new Product: "The Blank — AC Native Laptop"
Create a Price: $128.00 USD (one-time)
Register webhook endpoint: https://aesthetic.computer/api/blank
- Events: checkout.session.completed
Note the webhook signing secret → STRIPE_ENDPOINT_BLANK_SECRET

5. MongoDB Schema #

// Collection: blank-orders
{
  _id: ObjectId,
  stripeSessionId: string,
  paymentIntentId: string,
  customer: {
    email: string,
    name: string,
    address: { /* shipping address from Stripe */ }
  },
  product: {
    model: "yoga-11e-gen5",  // or "yoga-11e-gen4"
    price: 12800,            // cents
  },
  status: "paid" | "preparing" | "shipped" | "delivered",
  trackingNumber: string | null,
  notes: string | null,
  createdAt: Date,
  updatedAt: Date,
}

Implementation Order #

Stripe Dashboard — Create product + price + webhook endpoint
blank.mjs function — API endpoint (checkout session + webhook)
blank.mjs piece — Product page with Buy button
Test locally — stripe listen --forward-to "https://localhost:8888/api/blank"
Deploy + verify — Test with Stripe test mode end-to-end
Go live — Switch to production keys, source first batch of laptops

Pricing: Sliding Scale #

Follow the give.js pattern — let the buyer choose what to pay within a range.

const pricing = {
  usd: { min: 9600, suggested: 12800, max: 51200 },   // $96–$512, suggested $128
  dkk: { min: 67200, suggested: 89600, max: 358400 },  // ~672–3584 kr, suggested ~896 kr
};

Tiers:

Amount	What you get
$96 (minimum)	The Blank — laptop + AC Native OS
$128 (suggested)	The Blank + supports AC development
$512 (max)	The Blank + in-person meeting/tutorial in LA

$96 — covers hardware sourcing + OS flashing + shipping
$128 — suggested default, surplus supports ongoing AC work
$512 — includes an in-person session in Los Angeles: setup walkthrough, tutorial on making pieces, Q&A with Jeffrey
The piece UI shows a slider (or discrete tier buttons) to choose
$512 tier triggers an additional email/scheduling flow for the in-person meeting
Stripe price_data.unit_amount is set dynamically (same as give.js)
Metadata tracks the tier: { tier: "blank" | "blank+support" | "blank+tutorial" }

Shipping & Delivery Options #

Shipping options in Stripe checkout:

Option	Countries	Cost
Hand delivery	US (local) / Denmark	Free
USPS Priority Mail	US	~$10–15 (flat rate padded envelope)
International (PostNord / USPS)	DK + others	~$20–30

shipping_address_collection.allowed_countries: ["US", "DK"] to start
shipping_options array in checkout session config for delivery method selection
Hand delivery adds a note field: "We'll reach out to arrange pickup/delivery"
Can expand countries later as demand shows up

Hand delivery flow:

Buyer selects "Hand delivery (free)" at checkout
We get notified, reach out via email to arrange
Perfect for workshops, events, or local community

Currencies #

Reuse the give.js dual-currency pattern:

const currencies = {
  usd: { symbol: "$", min: 9600, max: 51200, suggested: 12800 },
  dkk: { symbol: "kr", min: 67200, max: 358400, suggested: 89600 },
};

The piece auto-detects or lets the buyer toggle USD/DKK.

Open Questions #

How many units for the first batch?
Product photography — shoot the actual flashed laptop?
Should blank:thanks be a separate piece or a param/state of blank.mjs?
Inventory tracking — manual count in env var, or MongoDB stock field?
Should there be a waitlist if out of stock?
Exact sliding scale range — what's the true cost floor per unit?

Plan: blank — AC Native Laptop Product Page & Checkout #