4.9 KiB
BRAND MIGRATION — SPEC.md
1. Concept & Vision
MercadoDeVida ("Natural - Mercado de Vida") is a Costa del Sol-based online organic supermarket founded by Ivana & Ricardo, serving all of Spain. The brand identity comes from the legacy site (mercadodevida.es). The new platform must faithfully adopt the established brand identity — colors, typography, company information, and approved content — without inventing or approximating.
Rule: INSPECT, DO NOT INVENT. MIGRATE, DO NOT REWRITE.
2. Source of Truth
Legacy site: https://mercadodevida.es Legacy sitemap: https://mercadodevida.es/sitemap.xml
All visual assets, colors, and content come from the legacy site. No AI approximation.
3. Company Identity
3.1 Official Business Name
Primary: Natural - Mercado de Vida
Abbreviated: MercadoDeVida
3.2 Founders
Ivana & Ricardo
3.3 Contact Information
| Field | Value |
|---|---|
| Address | Av. Litoral - Edif. Vistamar II - Local 18, 29680 Estepona - Málaga |
| Phone | +34 951 338 132 |
| +34 676 014 074 | |
| info@mercadodevida.es |
3.4 Business Hours
Monday–Friday: 10:00 – 18:00
Saturday: 10:00 – 14:00
3.5 Geographic Scope
Serving all of Spain (peninsular). First Costa del Sol: Estepona, Sotogrande, Marbella, Málaga.
3.6 Social Links
| Platform | Handle/Lookup |
|---|---|
| Siguenos en Instagram (URL to be confirmed) | |
| Siguenos en Facebook (URL to be confirmed) |
URLs must be extracted from legacy site HTML. Do not guess.
4. Brand Inventory
See BRAND_INVENTORY.md for complete asset catalog.
5. Color Palette
Colors extracted from legacy site CSS. Do not eyeball from screenshots.
See BRAND_INVENTORY.md for source URLs and extracted values.
Initial Observations
The legacy site appears to use:
- A green/teal primary (matching the existing
#2D6A4Fin the new platform's design tokens) - A terracotta/coral accent
- Warm cream/beige backgrounds
- Earthy tones consistent with an organic/natural products brand
Exact CSS values must be extracted from the legacy site's stylesheet. See BRAND_INVENTORY.md for instructions.
6. Typography
Current new platform: Inter (sans) + Playfair Display (headings)
These should be evaluated against the legacy site's actual typography. If the legacy site uses different fonts, update the design tokens accordingly.
7. Information Pages
7.1 Source Content
| Legacy URL | New Route | Content Status |
|---|---|---|
| /quienes-somos | /about | Content extracted — see BRAND_INVENTORY.md |
| /quienes-somos | /contact | Content extracted — partial |
| /envios-y-formas-de-pago | /shipping | 404 on legacy — needs content creation |
| /terminos-y-condiciones | /terms | Legal text migrated — needs legal review |
| /politica-de-privacidad | /privacy | 404 on legacy — needs content creation |
| /politica-de-cookies | /cookies | 404 on legacy — needs content creation |
| /aviso-legal | /legal | Not on legacy — may need creation |
7.2 Content Architecture Decision
Option A: Typed static content in React components (current approach, works for simple pages) Option B: Markdown/MDX files Option C: CMS-backed (backend endpoint)
For this migration, Option A (typed static content) is acceptable if the new ContentPage component supports rich content. If rich content is needed, evaluate Option B.
Do NOT build a CMS just for five pages.
7.3 Single Source of Truth
Business information (address, phone, email, WhatsApp, hours) must be defined once and referenced from:
- Footer
- Contact page
- About page
- Checkout confirmation
- Legal pages
Create a businessConfig constant in frontend/src/lib/businessConfig.ts (or existing equivalent). Do NOT duplicate strings.
8. SEO Redirects
See LEGACY_REDIRECT_MAP.md for full redirect map.
Key principles:
- Every indexed legacy URL must either redirect (301/308) or return 410
- Product pages: 301 redirect to new slug format
- Informational pages: 301 redirect to new routes
- Category pages: map legacy OpenCart routes to new category routes
9. Admin Branding
Admin reuses:
- Logo (simplified or same)
- Basic brand colors (primary green)
Admin does NOT need:
- Full brand editorial content
- Marketing imagery
- Consumer-focused styling
Priority: operational usability. Admin must be clearly part of MercadoDeVida ecosystem without reducing table/form readability.
10. Out of Scope
- Rebuilding the legacy site functionality
- Migrating user accounts
- Migrating order history
- Migrating product catalog (already done)
- Changing domain registrar or DNS
- Third-party integrations (Instagram, Facebook)
- Payment gateway changes
- New marketing pages
11. Feature Flag
Not required for brand migration. Brand is purely additive.
12. Acceptance Criteria
See TESTS.md.