{"_id":"@tsaddict/react-social-share","_rev":"6-3385c9e8505ffc960555729ab2087a68","name":"@tsaddict/react-social-share","dist-tags":{"latest":"0.1.6"},"versions":{"0.1.0":{"name":"@tsaddict/react-social-share","version":"0.1.0","keywords":["react","share","social","tailwind","react-icons"],"license":"MIT","_id":"@tsaddict/react-social-share@0.1.0","maintainers":[{"name":"tsaddict","email":"tee.jhay222@gmail.com"}],"dist":{"shasum":"8e7215d626c8c7f2957b9258c59fcdfd7e749526","tarball":"https://registry.npmjs.org/@tsaddict/react-social-share/-/react-social-share-0.1.0.tgz","fileCount":7,"integrity":"sha512-XSSGFzpuZgEYfFv2l65Yj9QNy7elSOQiizir6EwkKPh3kPePhjBkHkp/Nl9L1Ek+BNeDMgaSEKOvE23BoMpd4g==","signatures":[{"sig":"MEQCIEExrSqOl8EEhhmMKXdmwb6TQOjIwTetWo2fqPNPhcyFAiBgqF5p6nqOBwS1zo4gYbN2OcSu77certs0+pLdM1XmpQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21978},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=16"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"scripts":{"build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"tsaddict","email":"tee.jhay222@gmail.com"},"_npmVersion":"11.5.1","description":"Lightweight React social share buttons with Tailwind animations and React Icons.","directories":{},"sideEffects":false,"_nodeVersion":"23.11.0","_hasShrinkwrap":false,"peerDependencies":{"react":">=17.0.0","react-dom":">=17.0.0","react-icons":">=4.0.0"},"_npmOperationalInternal":{"tmp":"tmp/react-social-share_0.1.0_1755428287581_0.3759436018770419","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@tsaddict/react-social-share","version":"0.1.2","keywords":["react","share","social","tailwind","react-icons"],"license":"MIT","_id":"@tsaddict/react-social-share@0.1.2","maintainers":[{"name":"tsaddict","email":"tee.jhay222@gmail.com"}],"dist":{"shasum":"4d9bcb396c5ea8e41e4965c1b93c304c635bebe2","tarball":"https://registry.npmjs.org/@tsaddict/react-social-share/-/react-social-share-0.1.2.tgz","fileCount":8,"integrity":"sha512-c83HqowXf3wsO16mDSvgN8e5L7oRw9Igk14EoSu3QPqZAbnRqhA90eX+rJnKYtAeH4EfNE7W7wGjY47Cnfgx6A==","signatures":[{"sig":"MEUCIQC/9wWIFrCJrlzEVpRHBmvuOUIBU7Li+vGkDAhwW3B5wAIgPUKAybLM5xQq9svr36uDDJX2TZ+U39Bwgc9Lr660GIM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37718},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=16"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"52556028eb976ac4c6762ec4d61e5b926e38b22f","scripts":{"build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"tsaddict","email":"tee.jhay222@gmail.com"},"_npmVersion":"11.5.1","description":"Lightweight React social share buttons with Tailwind animations and React Icons.","directories":{},"sideEffects":false,"_nodeVersion":"23.11.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","postcss":"^8.5.6","typescript":"^5.9.2","react-icons":"^5.5.0","tailwindcss":"^4.1.12","@types/react":"^19.1.10","autoprefixer":"^10.4.21","@types/react-dom":"^19.1.7"},"peerDependencies":{"react":"^19.1.1","react-dom":"^19.1.1","react-icons":">=4.0.0","tailwindcss":">=3.0.0 || ^4.0.0-alpha"},"_npmOperationalInternal":{"tmp":"tmp/react-social-share_0.1.2_1755429706381_0.12751600132650864","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@tsaddict/react-social-share","version":"0.1.3","keywords":["react","share","social","tailwind","react-icons"],"license":"MIT","_id":"@tsaddict/react-social-share@0.1.3","maintainers":[{"name":"tsaddict","email":"tee.jhay222@gmail.com"}],"dist":{"shasum":"c006597232a63d4035588830103c78ae73a1e411","tarball":"https://registry.npmjs.org/@tsaddict/react-social-share/-/react-social-share-0.1.3.tgz","fileCount":8,"integrity":"sha512-y/9XwtNGSi8vYWsEZF8ML2ZV5XMmp7yUAAf8j1nO6QLTsT0ronC+Mso7HCCosR4OzNITI6xkIBsG/EDkW0YnSA==","signatures":[{"sig":"MEUCIH54F7z2MJZ0vaJ0je2W1rx2EU/JTwPCi/8uaxzyOmwGAiEA6THFZoxzVeKkgJu0zYZ0+wNJlHjwRiIaZY4fG42PxN8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37946},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=16"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"ec8f81eddd89b45eb2eb150e3145e5c5157ffe16","scripts":{"build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"tsaddict","email":"tee.jhay222@gmail.com"},"_npmVersion":"11.5.1","description":"Lightweight React social share buttons with Tailwind animations and React Icons.","directories":{},"sideEffects":false,"_nodeVersion":"23.11.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","postcss":"^8.5.6","typescript":"^5.9.2","react-icons":"^5.5.0","tailwindcss":"^4.1.12","@types/react":"^19.1.10","autoprefixer":"^10.4.21","@types/react-dom":"^19.1.7"},"peerDependencies":{"react":"^19.1.1","react-dom":"^19.1.1","react-icons":">=4.0.0","tailwindcss":">=3.0.0 || ^4.0.0-alpha"},"_npmOperationalInternal":{"tmp":"tmp/react-social-share_0.1.3_1755432459338_0.15685133257568395","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@tsaddict/react-social-share","version":"0.1.4","keywords":["react","share","social","tailwind","react-icons"],"license":"MIT","_id":"@tsaddict/react-social-share@0.1.4","maintainers":[{"name":"tsaddict","email":"tee.jhay222@gmail.com"}],"dist":{"shasum":"70f915d513905647c15d982d23cd97ecef195295","tarball":"https://registry.npmjs.org/@tsaddict/react-social-share/-/react-social-share-0.1.4.tgz","fileCount":8,"integrity":"sha512-XFk7vA8cRJ3QwKzMZVYfOQ4QYGWT+pwsNrXOKBy1E9tNe6Mw2onxgfR9GsAEmpVUuKF8xsatmV4Wl47mWzZVnA==","signatures":[{"sig":"MEUCIQDu4Sof7pCIjYyyYcF17wN3tGU+RdUMsJJPZXhQLWmodQIgThgLVi8TdvHQmPRhdTRxtMnqClKdtHU3LuxiwTCiY5Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37146},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=16"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"3261b5d3a38fc59272890395390adffd4277ac0a","scripts":{"build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"tsaddict","email":"tee.jhay222@gmail.com"},"_npmVersion":"11.5.1","description":"Lightweight React social share buttons with Tailwind animations and React Icons.","directories":{},"sideEffects":false,"_nodeVersion":"23.11.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","postcss":"^8.5.6","typescript":"^5.9.2","react-icons":"^5.5.0","tailwindcss":"^4.1.12","@types/react":"^19.1.10","autoprefixer":"^10.4.21","@types/react-dom":"^19.1.7"},"peerDependencies":{"react":"^19.1.1","react-dom":"^19.1.1","react-icons":">=4.0.0","tailwindcss":">=3.0.0 || ^4.0.0-alpha"},"_npmOperationalInternal":{"tmp":"tmp/react-social-share_0.1.4_1755432969136_0.1707092274265496","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@tsaddict/react-social-share","version":"0.1.5","keywords":["react","share","social","tailwind","react-icons"],"license":"MIT","_id":"@tsaddict/react-social-share@0.1.5","maintainers":[{"name":"tsaddict","email":"tee.jhay222@gmail.com"}],"dist":{"shasum":"2b432a484489e6f13bdd60793739202565e9aff6","tarball":"https://registry.npmjs.org/@tsaddict/react-social-share/-/react-social-share-0.1.5.tgz","fileCount":8,"integrity":"sha512-UTI7q68qCoPpTlx3FnhNOA+NZcGWqUGENtgajrRlbJXckxTZFkutqYUVGwGXIpOr1uTf1Sw7Al9ual7+2nlzQg==","signatures":[{"sig":"MEUCIEsFlokRmeLX+2XRPREO3C1COEG2+GPusR0tk0YSAbVcAiEAuFabtCvK7q2BKRQcjCRaCm3LKYiLhb60AX476vlpFZo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37146},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=16"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"24e46b6f4017d0bb71e53c62b02508cf43f143d9","scripts":{"build":"tsup","prepublishOnly":"npm run build"},"_npmUser":{"name":"tsaddict","email":"tee.jhay222@gmail.com"},"_npmVersion":"11.5.1","description":"Lightweight React social share buttons with Tailwind animations and React Icons.","directories":{},"sideEffects":false,"_nodeVersion":"23.11.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","postcss":"^8.5.6","typescript":"^5.9.2","react-icons":"^5.5.0","tailwindcss":"^4.1.12","@types/react":"^19.1.10","autoprefixer":"^10.4.21","@types/react-dom":"^19.1.7"},"peerDependencies":{"react":"^19.1.1","react-dom":"^19.1.1","react-icons":">=4.0.0","tailwindcss":">=3.0.0 || ^4.0.0-alpha"},"_npmOperationalInternal":{"tmp":"tmp/react-social-share_0.1.5_1755433160388_0.471946459582959","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@tsaddict/react-social-share","version":"0.1.6","description":"Lightweight React social share buttons with Tailwind animations and React Icons.","license":"MIT","type":"module","main":"dist/index.cjs","module":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"sideEffects":false,"scripts":{"build":"tsup","prepublishOnly":"npm run build"},"peerDependencies":{"react":"^19.1.1","react-dom":"^19.1.1","react-icons":">=4.0.0","tailwindcss":">=3.0.0 || ^4.0.0-alpha"},"keywords":["react","share","social","tailwind","react-icons"],"engines":{"node":">=16"},"devDependencies":{"@types/react":"^19.1.10","@types/react-dom":"^19.1.7","autoprefixer":"^10.4.21","postcss":"^8.5.6","react-icons":"^5.5.0","tailwindcss":"^4.1.12","tsup":"^8.5.0","typescript":"^5.9.2"},"_id":"@tsaddict/react-social-share@0.1.6","gitHead":"09d304902777fd1fa820277517001484655b09fc","_nodeVersion":"23.11.0","_npmVersion":"11.5.1","dist":{"integrity":"sha512-47/ZwB2QAsnOF5ZzDId5/WPVcDBssBAesl8dYJRE+9DlmMwWaZuS+gIbMbAJXaEXI6xk0iqHnQkIScxvDfgHOg==","shasum":"7426ea6dbe04b821113df235ab80e86b4333a2e9","tarball":"https://registry.npmjs.org/@tsaddict/react-social-share/-/react-social-share-0.1.6.tgz","fileCount":8,"unpackedSize":42245,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAKxk/OLIs9RGaBI/U+7CL6qbvRpOL0F7lRF6au0uQ2BAiAN7rk6kkDrzyfbjAzf5PQngsDSsplHXV5R3+M9JG8v1w=="}]},"_npmUser":{"name":"tsaddict","email":"tee.jhay222@gmail.com"},"directories":{},"maintainers":[{"name":"tsaddict","email":"tee.jhay222@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/react-social-share_0.1.6_1755452763616_0.9303493680800297"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-17T10:58:07.486Z","modified":"2025-08-17T17:46:03.990Z","0.1.0":"2025-08-17T10:58:07.764Z","0.1.2":"2025-08-17T11:21:46.578Z","0.1.3":"2025-08-17T12:07:39.509Z","0.1.4":"2025-08-17T12:16:09.363Z","0.1.5":"2025-08-17T12:19:20.566Z","0.1.6":"2025-08-17T17:46:03.806Z"},"license":"MIT","keywords":["react","share","social","tailwind","react-icons"],"description":"Lightweight React social share buttons with Tailwind animations and React Icons.","maintainers":[{"name":"tsaddict","email":"tee.jhay222@gmail.com"}],"readme":"# @tsaddict/react-social-share\n\nA lightweight, modern React component library for social media sharing with beautiful Tailwind CSS animations and React Icons integration.\n\n## 🚀 Features\n\n- **9 Social Platforms**: Facebook, X (Twitter), LinkedIn, WhatsApp, Telegram, Reddit, Email, Messenger, and Discord\n- **Beautiful Animations**: Smooth hover effects with scale transforms and color transitions\n- **Tailwind CSS Ready**: Built with Tailwind CSS for easy customization (requires Tailwind CSS setup)\n- **TypeScript Support**: Full TypeScript support with proper type definitions\n- **Accessibility**: ARIA labels and semantic HTML for screen readers\n- **Responsive Design**: Mobile-friendly with proper touch targets\n- **Customizable**: Extensive customization options for styling and behavior\n- **Lightweight**: Minimal bundle size with tree-shaking support\n- **Custom Icons**: Support for custom icon components and props\n\n## 📦 Installation\n\n```bash\nnpm install @tsaddict/react-social-share\n```\n\n### Tailwind CSS Setup\n\nSince this package uses Tailwind CSS utility classes, you need to have Tailwind CSS configured in your project:\n#### For Tailwind CSS v3 (Stable)\n\n1. **Install Tailwind CSS:**\n   ```bash\n   npm install -D tailwindcss postcss autoprefixer\n   npx tailwindcss init -p\n   ```\n\n2. **Configure your `tailwind.config.js`:**\n   ```js\n   /** @type {import('tailwindcss').Config} */\n   module.exports = {\n     content: [\n       \"./src/**/*.{js,jsx,ts,tsx}\",\n       \"./node_modules/@tsaddict/react-social-share/**/*.{js,jsx,ts,tsx}\"\n     ],\n     theme: {\n       extend: {},\n     },\n     plugins: [],\n   }\n   ```\n\n3. **Import Tailwind in your CSS:**\n   ```css\n   @tailwind base;\n   @tailwind components;\n   @tailwind utilities;\n   ```\n\n#### For Tailwind CSS v4 (Alpha/Beta)\n\n1. **Install Tailwind CSS v4:**\n   ```bash\n   npm install -D tailwindcss@next\n   ```\n\n2. **Create `tailwind.config.ts`:**\n   ```ts\n   import type { Config } from 'tailwindcss'\n   \n   export default {\n     content: [\n       \"./src/**/*.{js,jsx,ts,tsx}\",\n       \"./node_modules/@tsaddict/react-social-share/**/*.{js,jsx,ts,tsx}\"\n     ],\n   } satisfies Config\n   ```\n\n3. **Import Tailwind in your CSS:**\n   ```css\n   @import \"tailwindcss\";\n   ```\n\n**Note**: Tailwind v4 is still in development. For production apps, we recommend using v3.\n\n### Peer Dependencies\n\nThis package requires the following peer dependencies:\n\n```json\n{\n  \"react\": \"^19.1.1\",\n  \"react-dom\": \"^19.1.1\",\n  \"react-icons\": \">=4.0.0\",\n  \"tailwindcss\": \">=3.0.0 || ^4.0.0-alpha\"\n}\n```\n\n**Important**: You must have Tailwind CSS configured in your project for the styling to work. The components use Tailwind utility classes that need to be processed by Tailwind CSS.\n\nMake sure you have these installed in your project.\n\n## 🎯 Quick Start\n\n### Basic Usage\n\n```tsx\nimport { SocialButton, SocialShareGroup } from \"@tsaddict/react-social-share\";\n\nfunction App() {\n  return (\n    <div>\n      {/* Single social share button */}\n      <SocialButton\n        platform=\"twitter\"\n        url=\"https://example.com\"\n        text=\"Check out this amazing article!\"\n      />\n\n      {/* Group of social share buttons */}\n      <SocialShareGroup\n        url=\"https://example.com\"\n        text=\"Amazing content to share!\"\n      />\n    </div>\n  );\n}\n```\n\n## 🧩 Components\n\n### SocialButton\n\nIndividual social media share button component.\n\n#### Props\n\n| Prop            | Type       | Required | Default          | Description                             |\n| --------------- | ---------- | -------- | ---------------- | --------------------------------------- |\n| `platform`      | `Platform` | ✅       | -                | Social media platform to share to       |\n| `url`           | `string`   | ✅       | -                | URL to share                            |\n| `text`          | `string`   | ❌       | -                | Optional text to include with the share |\n| `label`         | `string`   | ❌       | Platform default | Custom label text                       |\n| `className`     | `string`   | ❌       | `\"\"`             | Additional CSS classes for styling      |\n| `iconClassName` | `string`   | ❌       | `\"\"`             | Additional CSS classes for the icon     |\n\n#### Platform Values\n\n```typescript\ntype Platform = \n  | \"facebook\" \n  | \"X\" \n  | \"linkedin\" \n  | \"whatsapp\" \n  | \"telegram\" \n  | \"reddit\"\n  | \"email\"\n  | \"messenger\"\n  | \"discord\";\n```\n\n#### Example\n\n```tsx\n<SocialButton\n  platform=\"linkedin\"\n  url=\"https://mycompany.com/careers\"\n  text=\"We're hiring! Check out our open positions.\"\n  label=\"Share on LinkedIn\"\n  className=\"text-sm px-6 py-3\"\n  iconClassName=\"text-xl\"\n/>\n```\n\n### SocialShareGroup\n\nContainer component that renders multiple social share buttons.\n\n#### Props\n\n| Prop              | Type                                | Required | Default                               | Description                          |\n| ----------------- | ----------------------------------- | -------- | ------------------------------------- | ------------------------------------ |\n| `url`             | `string`                            | ✅       | -                                     | URL to share                         |\n| `text`            | `string`                            | ❌       | -                                     | Optional text to include with shares |\n| `platforms`       | `Platform[]`                        | ❌       | All platforms                         | Specific platforms to show           |\n| `wrapClassName`   | `string`                            | ❌       | `\"flex flex-wrap items-center gap-3\"` | Container CSS classes                |\n| `buttonClassName` | `string`                            | ❌       | -                                     | CSS classes applied to all buttons   |\n| `iconClassName`   | `string`                            | ❌       | -                                     | CSS classes applied to all icons     |\n| `labels`          | `Partial<Record<Platform, string>>` | ❌       | `{}`                                  | Custom labels per platform           |\n\n#### Example\n\n```tsx\n<SocialShareGroup\n  url=\"https://myblog.com/post-123\"\n  text=\"Amazing blog post about React!\"\n  platforms={[\"twitter\", \"linkedin\", \"reddit\"]}\n  wrapClassName=\"flex flex-col gap-2\"\n  buttonClassName=\"w-full justify-center\"\n  labels={{\n    twitter: \"Tweet this\",\n    linkedin: \"Share on LinkedIn\",\n    reddit: \"Post to Reddit\",\n  }}\n/>\n```\n\n## 🎨 Customization\n\n### Styling with Tailwind CSS\n\nThe components use Tailwind CSS classes and can be easily customized:\n\n```tsx\n// Custom button styling\n<SocialButton\n  platform=\"facebook\"\n  url=\"https://example.com\"\n  className=\"bg-purple-600 hover:bg-purple-700 rounded-full px-6 py-3\"\n/>\n\n// Custom group layout\n<SocialShareGroup\n  url=\"https://example.com\"\n  wrapClassName=\"grid grid-cols-2 md:grid-cols-3 gap-4\"\n  buttonClassName=\"text-sm font-bold\"\n/>\n```\n\n### Platform-Specific Colors\n\nEach platform has its brand colors by default:\n\n- **Facebook**: Blue (`bg-blue-600`)\n- **X (Twitter)**: Black (`bg-black`)\n- **LinkedIn**: Blue (`bg-blue-700`)\n- **WhatsApp**: Green (`bg-green-500`)\n- **Telegram**: Sky (`bg-sky-400`)\n- **Reddit**: Orange (`bg-orange-500`)\n- **Email**: Gray (`bg-gray-500`)\n- **Messenger**: Blue (`bg-blue-500`)\n- **Discord**: Purple (`bg-purple-500`)\n\n### Animation Classes\n\nThe components include smooth animations:\n\n- **Hover**: Scale up (`hover:scale-110`)\n- **Active**: Scale down (`active:scale-95`)\n- **Transitions**: Smooth duration (`transition-all duration-300`)\n\n### Custom Icons\n\nYou can override the default icons with custom ones:\n\n```tsx\nimport { FaCustomIcon } from 'react-icons/fa';\n\n<SocialButton\n  platform=\"facebook\"\n  url=\"https://example.com\"\n  icon={FaCustomIcon}\n  iconProps={{ size: 24, color: \"white\" }}\n/>\n```\n\n## 🔧 Advanced Usage\n\n### Conditional Rendering\n\n```tsx\nfunction ShareSection({ article, user }) {\n  const platforms = user.isPremium \n    ? [\"facebook\", \"X\", \"linkedin\", \"whatsapp\", \"telegram\", \"reddit\", \"email\", \"messenger\", \"discord\"]\n    : [\"facebook\", \"X\"];\n    \n  return (\n    <SocialShareGroup\n      url={article.url}\n      text={article.title}\n      platforms={platforms}\n    />\n  );\n}\n```\n\n### Dynamic Labels\n\n```tsx\nfunction ShareButtons({ post }) {\n  const labels = {\n    X: `Share \"${post.title}\" on X`,\n    linkedin: `Share \"${post.title}\" on LinkedIn`,\n    facebook: `Share \"${post.title}\" on Facebook`,\n    email: `Email \"${post.title}\" to friends`,\n    messenger: `Send \"${post.title}\" via Messenger`\n  };\n\n  return <SocialShareGroup url={post.url} text={post.title} labels={labels} />;\n}\n```\n\n### Custom Share URLs\n\n```tsx\nimport { getShareUrl } from \"@tsaddict/react-social-share\";\n\nfunction CustomShareButton({ platform, url, text }) {\n  const shareUrl = getShareUrl(platform, url, text);\n\n  const handleClick = () => {\n    // Custom logic before sharing\n    analytics.track(\"share_clicked\", { platform, url });\n    window.open(shareUrl, \"_blank\");\n  };\n\n  return <button onClick={handleClick}>Share on {platform}</button>;\n}\n```\n\n## 📱 Mobile Support\n\nThe components are fully responsive and mobile-optimized:\n\n- **Touch Targets**: Proper sizing for mobile devices\n- **WhatsApp Integration**: Uses `wa.me` for mobile and desktop compatibility\n- **Responsive Layout**: Flexible grid/flexbox layouts that work on all screen sizes\n\n## ♿ Accessibility\n\n- **ARIA Labels**: Proper labeling for screen readers\n- **Semantic HTML**: Uses anchor tags for sharing functionality\n- **Keyboard Navigation**: Full keyboard support\n- **Focus Indicators**: Clear focus states for keyboard users\n\n## 🚀 Performance\n\n- **Tree Shaking**: Only import what you use\n- **Minimal Dependencies**: Lightweight bundle size\n- **Efficient Rendering**: Optimized React components\n- **Lazy Loading**: Icons are loaded only when needed\n\n## 🧪 Testing\n\nThe components are designed to be easily testable:\n\n```tsx\nimport { render, screen } from \"@testing-library/react\";\nimport { SocialButton } from \"@tsaddict/react-social-share\";\n\ntest(\"renders social button with correct platform\", () => {\n  render(<SocialButton platform=\"X\" url=\"https://example.com\" />);\n\n  expect(screen.getByLabelText(\"Share on X\")).toBeInTheDocument();\n});\n```\n\n## 🔍 Browser Support\n\n- **Modern Browsers**: Chrome, Firefox, Safari, Edge (latest versions)\n- **Mobile Browsers**: iOS Safari, Chrome Mobile, Samsung Internet\n- **IE**: Not supported (uses modern ES6+ features)\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## 📞 Support\n\nIf you encounter any issues or have questions:\n\n1. Check the [Issues](https://github.com/yourusername/react-social-share/issues) page\n2. Create a new issue with detailed information\n3. Include your React version, browser, and reproduction steps\n\n## 🔄 Changelog\n\n### v0.1.5\n\n- Added 3 new platforms: Email, Messenger, and Discord\n- Renamed \"twitter\" to \"X\" to match current branding\n- Added custom icon support with `icon` and `iconProps` props\n- Enhanced accessibility with `data-testid` attributes\n- Improved TypeScript types and component props\n\n### v0.1.0\n\n- Initial release\n- Support for 6 social platforms\n- Tailwind CSS integration\n- TypeScript support\n- Responsive design\n- Accessibility features\n\n## 📚 Examples\n\n### Blog Post Sharing\n\n```tsx\nfunction BlogPost({ post }) {\n  return (\n    <article>\n      <h1>{post.title}</h1>\n      <p>{post.excerpt}</p>\n\n      <div className=\"mt-8\">\n        <h3>Share this post:</h3>\n        <SocialShareGroup\n          url={post.url}\n          text={post.title}\n          platforms={[\"twitter\", \"linkedin\", \"facebook\"]}\n          wrapClassName=\"flex gap-3 mt-4\"\n        />\n      </div>\n    </article>\n  );\n}\n```\n\n### Product Page Sharing\n\n```tsx\nfunction ProductPage({ product }) {\n  return (\n    <div>\n      <h1>{product.name}</h1>\n      <p>{product.description}</p>\n\n      <SocialShareGroup\n        url={product.url}\n        text={`Check out ${product.name} - ${product.description}`}\n        labels={{\n          twitter: \"Tweet this product\",\n          facebook: \"Share on Facebook\",\n          whatsapp: \"Share via WhatsApp\",\n        }}\n        buttonClassName=\"bg-gray-800 hover:bg-gray-900\"\n      />\n    </div>\n  );\n}\n```\n\n### Newsletter Signup\n\n```tsx\nfunction NewsletterSignup() {\n  return (\n    <div className=\"bg-blue-50 p-6 rounded-lg\">\n      <h3>Stay updated!</h3>\n      <p>Share our newsletter with your network:</p>\n\n      <SocialShareGroup\n        url=\"https://mycompany.com/newsletter\"\n        text=\"Subscribe to our amazing newsletter!\"\n        platforms={[\"twitter\", \"linkedin\"]}\n        wrapClassName=\"flex gap-2 mt-4\"\n        buttonClassName=\"text-sm px-3 py-2\"\n      />\n    </div>\n  );\n}\n```\n\n---\n\nBuilt with ❤️ using React, TypeScript, and Tailwind CSS\n","readmeFilename":"README.md"}