@stefanobartoletti/nuxt-social-share

Simple social sharing for your Nuxt Sites

Documentation | Release Notes | Demo

🌟 Features

• Provides a minimal config <SocialShare> component
• The component is unstyled by default for easy integration in any design
• Optional styled version, that can still be further customized
• A useSocialShare composable is exposed, to provide even more flexibility if needed
• Many major social networks supported

🛠️ Quick Start

1. Add @stefanobartoletti/nuxt-social-share dependency to your project

npx nuxi@latest module add nuxt-social-share

1. Nuxi should have already added @stefanobartoletti/nuxt-social-share to the modules section of nuxt.config.ts, if not add it manually:

export default defineNuxtConfig({
  // module added by Nuxi
  modules: [
    '@stefanobartoletti/nuxt-social-share'
  ],
})

1. Configure the module options to your needs:

export default defineNuxtConfig({
  // configuration options
  socialShare: {
    baseUrl: 'https://www.yoursite.com' // required!
    // other optional module options
  }
})

📖 Documentation

The full docs are available in a dedicated documentation website

🤝 Contributing

[!NOTE] If you want to contribute you can start by reading the Contributing guidelines.

[!NOTE] Contributions to add more networks are welcome, but keep in mind that PR will be accepted only for networks that have a documentation available in English among other languages.

• Clone this repository
• Enable Corepack using corepack enable
• Install dependencies using pnpm install
• Run pnpm dev:prepare to generate type stubs.
• Use pnpm dev to start playground in development mode.
• Lint any new edit by running pnpm lint --fix

📝 License

MIT

© 2023-present Stefano Bartoletti

Changelog

1.2.0 (2024-10-24)

🚀 Features

• add threads network (14ac26c)
• add support for network aliases (i.e. twitter for x) (c84d2c8)
• migrate twitter network to x (b42e70f)

🩹 Bug Fixes

• deps: update dependency @iconify-json/simple-icons to ^1.2.9 (#286) (f2c25af)
• deps: update dependency @nuxt/fonts to ^0.10.1 (#288) (2369273)
• deps: update dependency @nuxt/fonts to ^0.10.2 (#291) (da56e8a)

⚙️ Refactor

• fix network names and remove unneeded capitalization function (32d10df)