HolyBrim — the spec

HolyBrim is a faith-forward hat brand selling custom embroidered scripture caps and seasonal limited-edition designs through Etsy. It serves everyday consumers who want to wear and share their beliefs, and church communities that need branded apparel in bulk. The core behavior is gifting: a buyer sends a hat to someone they care about and stays connected to that relationship through the platform's simple tracking layer.

---

Decisions locked

---

The core loop

1. A shopper lands on HolyBrim and browses the community gallery or seasonal drops.
2. They choose a hat, personalize the scripture or faith phrase for embroidery, and place the order.
3. At checkout they flag it as a gift and enter the recipient's name plus a short note about the relationship.
4. The order is fulfilled and shipped; the gifter receives a confirmation with a link to their Gift Tracker entry.
5. The gifter logs a follow-up note when the hat arrives — starting a lightweight record of the relationship and its spiritual intent.

---

v1 scope

Custom embroidered scripture or faith phrases — A text-entry field at product level lets buyers type any verse reference or short phrase (character-capped for embroidery limits). This lives on every product listing page and is the primary differentiator from generic hat retail.

Seasonal limited-edition faith designs — A curated drop of 3–5 designs per season (Advent, Easter, back-to-school, etc.) with a visible inventory counter. These live on a dedicated "Current Drop" landing page and create urgency that drives repeat visits.

Bulk ordering for church groups — A separate order flow for quantities of 12 or more, with a single shared scripture or logo option and a group-rate pricing table. Lives on a standalone "Church Orders" page linked from the main nav.

Resale/trade feature for old designs — A seller-initiated listing form where past buyers can post a hat they own for resale or trade within the HolyBrim community. Lives in the community section; HolyBrim takes no margin in v1, using it purely to deepen community stickiness.

Community hat gallery — A publicly visible, user-submitted photo gallery showing real people wearing their hats with optional caption of the scripture chosen and who they gifted it to. Lives on the shop's home page and Etsy shop header as social proof.

---

Deliberately later

• Premium cotton/wool construction tiers — material sourcing decisions require supplier contracts; validate demand at standard quality first.
• Gift wrapping with inspiration cards — adds fulfillment complexity; introduce once volume justifies a packaging workflow.
• Size and color customization options — expands SKU count significantly; keep v1 to two or three standard options and broaden after the first 30-day sales signal.

---

Data model sketch

• Customer — customer_id, name, email, shipping address, church affiliation (optional), order history
• Order — order_id, customer_id, line items, is_gift flag, recipient name, gift note, status, fulfillment date
• Product — product_id, base design name, season tag, inventory count, is_limited_edition, price
• Customization — customization_id, order_id, scripture_text, phrase_text, embroidery position
• BulkOrder — bulk_order_id, customer_id, group name, shared_design, quantity, quoted_price, status
• GiftTracker — tracker_id, order_id, gifter customer_id, recipient name, follow_up_notes, last_updated
• ResaleListing — listing_id, seller_customer_id, original product_id, asking_price_or_trade, status, photo_url
• GallerySubmission — submission_id, customer_id, photo_url, scripture_caption, gift_recipient_note, approved

---

Screens

• Home / Shop Front — entry point featuring the community gallery and a seasonal drop banner.
• Product Listing — single hat view with embroidery text entry and add-to-cart action.
• Current Drop — limited-edition seasonal designs with live inventory counts.
• Church Orders — bulk order form with group pricing table and submission flow.
• Gift Tracker — personal dashboard where a gifter views their active gift records and logs follow-up notes.
• Community Gallery — full browsable gallery with submission form for approved user photos.
• Resale / Trade Board — grid of user-listed past designs with contact or swap request action.

---

How to use this document

• Bring it into Mind Palace, where the guided platform and its AI coach pick up from exactly this document and build the product with you step by step.
• Hand it to a developer as the complete v1 brief — every screen, data table, and feature boundary is defined.
• Keep it as the single source of truth so every future decision can be checked against what HolyBrim is and is not in version one.