# Shopify Migration Spec

This is the playbook to move Rembolica from the current static HTML site to Shopify.
It assumes the design and copy from the rebuilt static site (this repo) carry over.

---

## 1. Why Shopify (not WooCommerce, Squarespace, Webflow)

| Need                          | Shopify gets you                          |
| ----------------------------- | ----------------------------------------- |
| Real e-commerce               | Built-in cart, checkout, payments, tax    |
| Workshop booking              | **Sesami** app (calendar, group/private)  |
| Reviews                       | **Judge.me** (free tier OK)               |
| Bundles & gift sets           | Native Shopify Bundles or **Rebuy**       |
| Multilingual EN/ES/CA/DE      | Shopify Markets + **Translate & Adapt**   |
| Email marketing               | **Klaviyo** (free up to 250 contacts)     |
| Spanish payments              | Stripe + **Bizum** + SEPA via apps        |
| B2B / wholesale               | Shopify B2B (in Plus) or simple form flow |
| Newsletter capture / popups   | Klaviyo embedded forms                    |

WooCommerce requires self-hosting, security maintenance, and plugin sprawl — wrong for a one-person team. Squarespace lacks the Sesami / bundles ecosystem. Webflow lacks payments depth.

---

## 2. Account setup checklist

Before touching theme work — Elena needs to do these (Claude can't):

- [ ] Sign up at https://shopify.com → 3-day free trial, then $1/mo for 3 months
  - Plan: **Basic** ($39/mo after trial) is enough; upgrade only when needed
- [ ] Set store name: `rembolica` (claims rembolica.myshopify.com)
- [ ] Verify business: NIF, business address, Spanish bank account for Stripe
- [ ] Buy/keep domain: rembolica.com → connect to Shopify (DNS records)
- [ ] Stripe activation (KYC) for card payments + Bizum
- [ ] Activate **Shopify Markets** (free): set primary market = Spain (EUR), expansion markets = EU + Rest of World

---

## 3. Theme & app stack

### Theme
**Sense** (free, by Shopify) — clean editorial baseline that supports our color/font tokens.
Alternative paid: **Impulse** ($350) — better section flexibility, video heroes, lookbook galleries.

After install: customize tokens to match this repo's design system —
- Background: `#F4EFE6` paper / `#1C1C1C` ink
- Accent: `#C9542B` persimmon
- Display font: Fraunces · Body font: Schibsted Grotesk

### Apps (cost-conscious order)

| App                   | Use                              | Cost     |
| --------------------- | -------------------------------- | -------- |
| **Sesami**            | Workshop booking                 | $19/mo   |
| **Judge.me**          | Reviews on PDPs + workshop pages | Free → $15/mo |
| **Klaviyo**           | Email + popups + abandoned cart  | Free <250 contacts |
| **Translate & Adapt**| EN/ES/CA/DE translations         | Free (Shopify) |
| **Shopify Bundles**   | Gift sets / starter pack         | Free (Shopify) |
| **Bizum (StGo Pay)**  | Spanish mobile payments          | % per txn |
| **SEO Manager**       | Sitemap, meta, schema (optional) | $20/mo   |

Defer until needed: Rebuy ($99/mo, only when AOV justifies it), Yotpo loyalty, etc.

---

## 4. Content map: static site → Shopify

| Static page                  | Shopify equivalent                        |
| ---------------------------- | ----------------------------------------- |
| `/index.html`                | Online Store → Themes → home (sections)   |
| `/shop.html`                 | Catalog → Products (auto-generated grid)  |
| `/collections.html`          | Collection: "All collections" listing     |
| `/collections/bodas.html`    | Collection: "Bodas" + custom page         |
| `/collections/bebes.html`    | Collection: "Bebés"                       |
| `/collections/navidad.html`  | Collection: "Navidad y Reyes"             |
| `/workshops.html`            | Page: Workshops + Sesami service products |
| `/corporate.html`            | Page: Empresas + lookbook download form   |
| `/founder.html`              | Page: Historia                            |
| `/sustainability.html`       | Page: Impacto                             |
| `/how-to-tie.html`           | Blog: Tutoriales (4+ posts)               |
| `/contact.html`              | Built-in contact page + Klaviyo form      |
| `/privacy-policy.html`       | Page: Política de Privacidad              |
| `/terms-and-conditions.html` | Page: Términos y Condiciones              |
| `/404.html`                  | Theme: 404 template                       |

---

## 5. Product structure

### Furoshiki SKUs
- **Variants per product**: size (50×50, 70×70, 90×90), pattern/color
- **Tags**: `bodas`, `bebes`, `navidad`, `corporate`, `linen`, `cotton`, `silk`, `unique-piece`
- **Custom fields (metafields)**:
  - `original_fabric`: where the rescued textile came from
  - `paper_saved`: estimated sheets of paper this single furoshiki replaces over its life
  - `care_instructions`: short text

### Workshop SKUs (via Sesami)
- 5 services from the `workshops.html` content
- Each = bookable service with time slots, max attendees, location (Barcelona / online)
- Pricing tier: individual / private group / corporate

### Bundles (via Shopify Bundles)
- "Starter pack" — 3 sizes
- "Holiday family pack" — 5 sizes
- "Wedding gift set" — 2× large + ribbon

---

## 6. Migration sequence

**Week 1 — Foundations**
1. Create Shopify account, set up Markets (Spain primary)
2. Install Sense theme, customize to Rembolica tokens
3. Connect rembolica.com domain
4. Set up Klaviyo account + welcome email
5. Configure shipping (Spain Peninsula / EU / Rest of World) + tax

**Week 2 — Catalog & content**
6. Create products (start with 10–15 SKUs)
7. Recreate the 4 collection pages with content from this repo
8. Migrate static pages (Founder, Sustainability, Tutorials, Corporate, Contact)
9. Set up Sesami services for the 5 workshops
10. Run Translate & Adapt for ES → CA, EN, DE (uses our `assets/i18n/*.json` as reference)

**Week 3 — Conversion plumbing**
11. Klaviyo: welcome series (3 emails, Spanish + auto-translated EN), abandoned cart flow, post-purchase review request
12. Judge.me reviews on PDPs + workshop pages
13. Add free-shipping threshold bar (`> €60`)
14. Set up corporate lookbook form (Klaviyo form → PDF auto-send)
15. SEO: import meta from this repo, set up redirects from any old URLs

**Week 4 — Test & launch**
16. End-to-end test: buy a furoshiki, book a workshop, request lookbook
17. Lighthouse audit on all key pages
18. Submit sitemap to Google Search Console
19. Enable Shopify Analytics + Plausible (preferred over GA4 for EU privacy)
20. Soft launch to email list, then Instagram

---

## 7. URL redirects (to preserve SEO)

After Shopify goes live, set 301 redirects:

```
/index.html              → /
/shop.html               → /collections/all
/collections.html        → /collections
/collections/bodas.html  → /collections/bodas
/collections/bebes.html  → /collections/bebes
/collections/navidad.html → /collections/navidad
/workshops.html          → /pages/workshops
/corporate.html          → /pages/empresas
/founder.html            → /pages/historia
/sustainability.html     → /pages/impacto
/how-to-tie.html         → /blogs/tutoriales
/contact.html            → /pages/contacto
/privacy-policy.html     → /pages/privacidad
/terms-and-conditions.html → /pages/terminos
```

Set these in Shopify → Online Store → Navigation → URL redirects.

---

## 8. Cost summary (year 1)

| Item                    | Monthly   | Year 1   |
| ----------------------- | --------- | -------- |
| Shopify Basic           | $39       | $470     |
| Sesami (workshops)      | $19       | $230     |
| Klaviyo (under 250)     | $0        | $0       |
| Judge.me                | $0–15     | $0–180   |
| Theme (one-time)        | —         | $0–350   |
| Domain (already owned)  | —         | $0       |
| **Total**               | **~$60**  | **~$1,000** |

Compare to current hosting cost: probably $5–15/mo. Yes it's more — but it's the channel that converts.

---

## 9. What to keep from this repo after migration

- `assets/i18n/*.json` — feed these into Shopify Translate & Adapt
- `assets/css/style.css` — color/font tokens become Shopify theme settings
- All copy from HTML files — paste into Shopify pages/products
- Sustainability stats from `sustainability.html` — go into a metafield on the homepage section
- Founder story from `founder.html` — paste into Shopify "Historia" page

This repo can stay as the **source of truth for copy** even after Shopify goes live. Edit copy here, paste to Shopify monthly.