PixelPilot: Instructions file for GitHub Copilot

UI/UX Social Share Buttons

Share content using native Web Share API with popup fallbacks. No third-party libraries, token-aware styling.

---

OVERVIEW

This skill covers:

1. Native Web Share API (mobile)
2. Platform-specific popup fallbacks
3. Share button component
4. Copy link option
5. Token-aware styling
6. Analytics tracking

---

HTML STRUCTURE

<div class="share-buttons">
  <span class="share-buttons__label">Share:</span>
  
  <!-- Native share (mobile) -->
  <button 
    class="share-btn share-btn--native" 
    id="native-share"
    aria-label="Share this page"
    hidden
  >
    <i data-lucide="share"></i>
    <span>Share</span>
  </button>
  
  <!-- Individual platforms (desktop fallback) -->
  <div class="share-buttons__platforms" id="share-platforms">
    <button 
      class="share-btn share-btn--twitter"
      data-platform="twitter"
      aria-label="Share on Twitter"
    >
      <i data-lucide="twitter"></i>
    </button>
    
    <button 
      class="share-btn share-btn--linkedin"
      data-platform="linkedin"
      aria-label="Share on LinkedIn"
    >
      <i data-lucide="linkedin"></i>
    </button>
    
    <button 
      class="share-btn share-btn--facebook"
      data-platform="facebook"
      aria-label="Share on Facebook"
    >
      <i data-lucide="facebook"></i>
    </button>
    
    <button 
      class="share-btn share-btn--whatsapp"
      data-platform="whatsapp"
      aria-label="Share on WhatsApp"
    >
      <i data-lucide="message-circle"></i>
    </button>
    
    <button 
      class="share-btn share-btn--email"
      data-platform="email"
      aria-label="Share via Email"
    >
      <i data-lucide="mail"></i>
    </button>
    
    <button 
      class="share-btn share-btn--copy"
      data-platform="copy"
      aria-label="Copy link"
    >
      <i data-lucide="link"></i>
    </button>
  </div>
</div>

---

CSS STYLES

.share-buttons {
  display: flex;
  align-items: center;
  gap: var(--space-4);
  flex-wrap: wrap;
}

.share-buttons__label {
  font-size: var(--text-sm);
  color: var(--muted);
  font-weight: 500;
}

.share-buttons__platforms {
  display: flex;
  gap: var(--space-2);
}

.share-btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 40px;
  height: 40px;
  border: none;
  border-radius: var(--radius-md);
  cursor: pointer;
  transition: transform var(--dur-micro), background var(--dur-micro);
  color: white;
}

.share-btn:hover {
  transform: translateY(-2px);
}

.share-btn:active {
  transform: translateY(0);
}

.share-btn:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
}

/* Native share button */
.share-btn--native {
  width: auto;
  padding: var(--space-2) var(--space-4);
  gap: var(--space-2);
  background: var(--accent);
}

.share-btn--native:hover {
  background: var(--accent-hover);
}

/* Platform colors — using brand tokens from uiux-tokens.md (v10.1) */
.share-btn--twitter {
  background: var(--brand-twitter);
}

.share-btn--twitter:hover {
  background: var(--brand-twitter-hover);
}

.share-btn--linkedin {
  background: var(--brand-linkedin);
}

.share-btn--linkedin:hover {
  background: var(--brand-linkedin-hover);
}

.share-btn--facebook {
  background: var(--brand-facebook);
}

.share-btn--facebook:hover {
  background: var(--brand-facebook-hover);
}

.share-btn--whatsapp {
  background: var(--brand-whatsapp);
}

.share-btn--whatsapp:hover {
  background: var(--brand-whatsapp-hover);
}

.share-btn--email {
  background: var(--muted);
}

.share-btn--email:hover {
  background: var(--text);
}

.share-btn--copy {
  background: var(--surface);
  color: var(--text);
  border: 1px solid var(--border);
}

.share-btn--copy:hover {
  background: var(--bg-hover);
}

.share-btn--copy.copied {
  background: var(--color-success);
  color: white;
  border-color: var(--color-success);
}

/* Icon sizing */
.share-btn svg,
.share-btn i {
  width: 18px;
  height: 18px;
}

/* Tooltip */
.share-btn[data-tooltip] {
  position: relative;
}

.share-btn[data-tooltip]::after {
  content: attr(data-tooltip);
  position: absolute;
  bottom: calc(100% + 8px);
  left: 50%;
  transform: translateX(-50%);
  padding: var(--space-1) var(--space-2);
  background: var(--text);
  color: var(--bg);
  font-size: var(--text-xs);
  white-space: nowrap;
  border-radius: var(--radius-sm);
  opacity: 0;
  pointer-events: none;
  transition: opacity var(--dur-micro);
}

.share-btn[data-tooltip]:hover::after {
  opacity: 1;
}

/* Reduced motion */
@media (prefers-reduced-motion: reduce) {
  .share-btn:hover {
    transform: none;
  }
}