Initial commit

2026-03-07 11:07:45 -03:00
commit 9d523f8b6a
65 changed files with 17311 additions and 0 deletions
--- a/.agents/skills/storefront-best-practices/reference/layouts/static-pages.md
+++ b/.agents/skills/storefront-best-practices/reference/layouts/static-pages.md
@@ -0,0 +1,356 @@
+# Static Pages
+
+## Contents
+
+- [Overview](#overview)
+- [FAQ Page](#faq-page)
+- [About Page](#about-page)
+- [Contact Page](#contact-page)
+- [Shipping and Returns](#shipping-and-returns)
+- [Privacy Policy and Terms](#privacy-policy-and-terms)
+- [Size Guide](#size-guide)
+- [Mobile and SEO](#mobile-and-seo)
+- [Checklist](#checklist)
+
+## Overview
+
+Static pages provide essential information about the store, policies, and customer support. Purpose: Build trust, reduce support inquiries, meet legal requirements, improve SEO.
+
+### Essential Static Pages
+
+**Required:**
+- Privacy Policy (legally required in most regions)
+- Terms and Conditions
+- Shipping and Returns
+- Contact
+
+**Strongly recommended:**
+- FAQ (Frequently Asked Questions)
+- About Us
+
+**Optional:**
+- Size Guide (for apparel stores)
+- Store Locator (if physical stores)
+
+## FAQ Page
+
+### Purpose and Structure
+
+**Purpose**: Answer common customer questions, reduce support inquiries, improve purchase confidence.
+
+**Common FAQ categories:**
+- Ordering and Payment
+- Shipping and Delivery
+- Returns and Exchanges
+- Product Information
+- Account Management
+
+### Layout Pattern: Accordion (Recommended)
+
+Question as clickable header, answer hidden by default, click to expand. Compact, scannable format.
+
+**Example:**
+```
+Frequently Asked Questions
+
+Ordering and Payment
+
+▸ How do I place an order?
+▸ What payment methods do you accept?
+▸ Is it safe to use my credit card?
+
+Shipping and Delivery
+
+▸ How long does shipping take?
+▸ Do you ship internationally?
+```
+
+**Alternative: All Expanded**
+All questions and answers visible. Better for few questions (<10), good for SEO (all content visible), easy to Ctrl+F search.
+
+### Search Functionality
+
+**FAQ search** (for extensive FAQs):
+Search box at top, real-time filtering as user types, highlights matching questions, "No results" state with contact link.
+
+### Content Guidelines
+
+**Question format:**
+Clear, concise, use customer language, start with question words (How, What, When).
+
+**Answer format:**
+Direct answer first sentence, additional details if needed, bullet points for lists, link to related pages, 2-4 sentences ideal.
+
+## About Page
+
+### Purpose and Content
+
+**Purpose**: Tell brand story, build trust and connection, showcase values and mission, differentiate from competitors.
+
+**Key sections:**
+- Brand story/history (how the company started)
+- Mission and values (3-5 core values)
+- Why choose us (what makes you different)
+- Sustainability/social responsibility (if applicable)
+
+### Layout Structure
+
+**Hero section:**
+Large image (team, products, brand imagery), headline (brand tagline or mission), brief intro paragraph (2-3 sentences).
+
+**Story section:**
+3-5 paragraphs, conversational tone, focus on customer benefits.
+
+**Values section:**
+3-5 core values with icon or image for each, brief description (1-2 sentences).
+
+**Call-to-action:**
+Shop products, join newsletter, follow on social media.
+
+## Contact Page
+
+### Contact Methods
+
+**Essential:**
+- Contact form (primary)
+- Email address
+- Phone number (optional)
+- Business hours
+- Response time expectation ("We respond within 24 hours")
+
+**Optional:**
+- Live chat button
+- FAQ link ("Find answers faster")
+- Social media links
+- Physical address (if applicable)
+
+### Contact Form
+
+**Form fields:**
+- Name (required)
+- Email (required)
+- Subject or Topic (dropdown, optional)
+- Message (textarea, required)
+- Order number (optional, for order inquiries)
+- Submit button
+
+**Form features:**
+Clear field labels, placeholder examples, required field indicators, email validation, success confirmation.
+
+## Shipping and Returns
+
+### Shipping Information
+
+**Key sections:**
+- Shipping methods and costs (table format)
+- Delivery timeframes
+- International shipping (if applicable)
+- Order processing time ("Orders placed by 2pm EST ship same day")
+- Tracking information
+- Shipping restrictions
+
+**Shipping Methods Table Format:**
+```
+Method          | Cost      | Delivery Time
+──────────────────────────────────────────
+Standard        | $5.99     | 5-7 business days
+Express         | $12.99    | 2-3 business days
+Overnight       | $24.99    | Next business day
+Free Shipping   | Free      | Orders over $50
+```
+
+### Returns and Exchanges
+
+**Key information:**
+- Return window (e.g., 30 days)
+- Return conditions (unused, tags attached, etc.)
+- Refund method (original payment, store credit)
+- Return shipping cost
+- Exchange process
+- Non-returnable items
+
+**Return process steps:**
+```
+How to Return an Item
+
+1. Initiate Return
+   Log into your account and select the order
+
+2. Print Return Label
+   We'll email you a prepaid shipping label
+
+3. Pack and Ship
+   Include all original packaging and tags
+
+4. Receive Refund
+   Refunds processed within 5-7 business days
+```
+
+## Privacy Policy and Terms
+
+### Privacy Policy
+
+**Purpose**: Legal requirement in most regions (GDPR, CCPA compliance), explain data collection and use, build customer trust.
+
+**Key sections:**
+- Information collected
+- How information is used
+- Data sharing and disclosure
+- Cookies and tracking
+- User rights (access, deletion, etc.)
+- Data security measures
+- Contact for privacy inquiries
+- Last updated date
+
+**Layout:**
+Table of contents (for long policies), clear section headings, numbered or bulleted lists, plain language, last updated date at top.
+
+**Important**: Consult legal counsel for content, include required disclosures, update regularly.
+
+### Terms and Conditions
+
+**Purpose**: Legal agreement between store and customer, define rules and limitations, protect business legally.
+
+**Key sections:**
+- Acceptance of terms
+- Product descriptions and pricing
+- Order acceptance and cancellation
+- Payment and billing
+- Shipping and delivery
+- Returns and refunds
+- Intellectual property
+- Limitation of liability
+- Dispute resolution
+- Changes to terms
+
+**Layout:**
+Numbered sections (1, 1.1, 1.2), table of contents for long documents, clear section titles, anchor links to sections.
+
+## Size Guide
+
+**Purpose (for apparel/footwear stores)**:
+Help customers choose correct size, reduce returns due to sizing issues, increase purchase confidence.
+
+**Content:**
+- Size charts (numeric measurements) - use proper table markup
+- How to measure instructions with illustrations
+- Fit descriptions (slim fit, relaxed, etc.)
+- Model measurements (for reference)
+- Size conversion chart (US, EU, UK)
+
+**Size Chart Format:**
+```
+Women's Tops Size Guide
+
+Size  | Bust      | Waist     | Hips
+─────────────────────────────────────
+XS    | 32-33"    | 24-25"    | 35-36"
+S     | 34-35"    | 26-27"    | 37-38"
+M     | 36-37"    | 28-29"    | 39-40"
+L     | 38-40"    | 30-32"    | 41-43"
+XL    | 41-43"    | 33-35"    | 44-46"
+```
+
+**Accessibility:**
+Use proper table markup (not images), clear column headers, screen reader friendly, mobile-responsive tables.
+
+## Mobile and SEO
+
+### Mobile Optimizations
+
+**Layout:**
+Single column, full-width content, larger touch targets for accordions, generous padding (16-20px).
+
+**Typography:**
+16px minimum body text, 24-32px headings, line height 1.5-1.6, short paragraphs (3-4 sentences max).
+
+**Tables:**
+Horizontal scroll for wide tables or card layout (stacked rows), responsive design.
+
+**Forms:**
+Full-width inputs, 44-48px height, large submit buttons, appropriate keyboard types.
+
+**Quick actions:**
+- Tap-to-call: Phone numbers as clickable links (`tel:`)
+- Tap-to-email: Email addresses as clickable links (`mailto:`)
+- Map integration: "Get Directions" links to native map app
+
+### SEO for Static Pages
+
+**On-Page SEO:**
+- Unique title per page (50-60 characters max, format: "Page Title | Store Name")
+- Meta descriptions (150-160 characters, include call-to-action)
+- Proper heading hierarchy (one H1 per page, H2 for sections, H3 for subsections)
+- Original, unique content
+- Internal links to products/categories
+- Regular updates (especially FAQ)
+
+**Schema Markup:**
+- FAQ schema for FAQ pages (rich snippets)
+- Organization schema for About page
+- LocalBusiness schema for Store Locator
+- ContactPoint schema for Contact page
+
+**Benefits:**
+Rich snippets in search results, improved visibility, better click-through rates.
+
+## Checklist
+
+**Essential pages:**
+
+- [ ] FAQ page with accordion layout
+- [ ] FAQ search functionality (for extensive FAQs)
+- [ ] FAQ categories organized logically
+- [ ] Contact page with form
+- [ ] Contact form validation
+- [ ] Email address and business hours visible
+- [ ] Shipping and Returns page
+- [ ] Shipping methods and costs table
+- [ ] Delivery timeframes clear
+- [ ] Return policy with conditions
+- [ ] Return process step-by-step
+- [ ] Privacy Policy page
+- [ ] Last updated date on Privacy Policy
+- [ ] Privacy policy in plain language
+- [ ] Terms and Conditions page
+- [ ] Last updated date on Terms
+
+**Optional but valuable:**
+
+- [ ] About Us page with brand story
+- [ ] Mission and values section
+- [ ] Size Guide (if apparel)
+- [ ] Size charts with measurements
+- [ ] How to measure instructions
+- [ ] Store Locator (if physical stores)
+
+**SEO and technical:**
+
+- [ ] Unique title tags per page
+- [ ] Meta descriptions per page
+- [ ] Proper heading hierarchy (H1, H2, H3)
+- [ ] Internal links to products/categories
+- [ ] Schema markup (FAQ, Organization, etc.)
+- [ ] Mobile-responsive layout
+- [ ] Fast loading times
+
+**Accessibility:**
+
+- [ ] Semantic HTML (main, article, section)
+- [ ] ARIA labels on accordions
+- [ ] Keyboard navigation supported
+- [ ] Focus indicators visible
+- [ ] High contrast text (4.5:1)
+- [ ] Forms properly labeled
+- [ ] Tables with proper headers
+- [ ] Alt text on images
+
+**Content quality:**
+
+- [ ] Clear, concise writing
+- [ ] Short paragraphs (3-4 sentences)
+- [ ] Bullet points for lists
+- [ ] Regular content updates
+- [ ] No outdated information
+- [ ] Contact info current
+- [ ] Policies reflect current practices