An open API service indexing awesome lists of open source software.

https://github.com/aldi/bulma-social

๐Ÿคณ Social Buttons and Colors for Bulma
https://github.com/aldi/bulma-social

bulma bulma-social font-awesome social-buttons

Last synced: 2 months ago
JSON representation

๐Ÿคณ Social Buttons and Colors for Bulma

Awesome Lists containing this project

README

          

Bulma-Social


Social Buttons and Colors for Bulma


npm version
jsDelivr hits
npm downloads
MIT License
Awesome


๐Ÿ“– View Documentation ยท
๐ŸŽจ Live Demo ยท
๐Ÿ› Report Bug

![bulma-social-preview](media/preview.webp)

## โœจ Features

- ๐ŸŽจ **24 Providers** โ€” All major social platforms included
- ๐Ÿงฉ **Bulma Native** โ€” Seamlessly integrates with Bulma's class naming conventions
- ๐Ÿ“ฆ **Modular Imports** โ€” Import only what you need, keep your bundle minimal
- ๐ŸŒ™ **Dark Mode Ready** โ€” Fully optimized for light and dark themes
- ๐Ÿ”ง **Framework Agnostic** โ€” Works with React, Vue, Angular, Svelte, or plain HTML
- ๐ŸŽฏ **Any Icon Library** โ€” Compatible with Font Awesome, Material Icons, Ionicons, and more

## ๐Ÿ“ฆ Installation

### NPM

```sh
npm install bulma-social
```

### Yarn

```sh
yarn add bulma-social
```

### pnpm

```sh
pnpm add bulma-social
```

After installation, import the CSS in your project:

```js
// Import all social providers
import "bulma-social/css/all.min.css";

// Or import specific providers for smaller bundle size
import "bulma-social/css/single/facebook/facebook.min.css";
import "bulma-social/css/single/github/github.min.css";
```

### CDN

Use via [jsDelivr](https://www.jsdelivr.com/package/npm/bulma-social) โ€” no installation required:

```html

```

---

## ๐ŸŽจ Supported Social Providers


.is-apple
.is-discord
.is-facebook
.is-github


.is-gitlab
.is-instagram
.is-linkedin
.is-microsoft


.is-pinterest
.is-reddit
.is-slack
.is-twitter


.is-youtube
.is-vimeo
.is-dropbox
.is-bitbucket


.is-flickr
.is-foursquare
.is-odnoklassniki
.is-openid


.is-soundcloud
.is-tumblr
.is-vk
.is-yahoo

---

## ๐ŸŽญ Button Styles & States

### Styles

| Class | Description |
| -------------- | ---------------------------------- |
| `.is-outlined` | Transparent background with border |
| `.is-inverted` | Inverted colors |
| `.is-light` | Light background variant |
| `.is-dark` | Dark background variant |

### States

| Class / Attribute | Description |
| ----------------- | -------------- |
| `.is-hovered` | Hover state |
| `.is-focused` | Focus state |
| `.is-active` | Active state |
| `.is-disabled` | Disabled state |

---

## ๐Ÿ–Œ๏ธ Color Utilities

### Text Colors

```html
Facebook Blue
Facebook Light
Facebook Dark
```

### Background Colors

```html

Facebook Background

Light Variant

Dark Variant

```

> ๐Ÿ’ก Replace `facebook` with any supported provider name.

---

## ๐Ÿ’ก Usage Examples

### Buttons with Text

```html




Sign in with Facebook





Continue with GitHub





Sign in with Google

```

### Icon-Only Buttons

```html







```

---

## ๐Ÿ“– Documentation

Full documentation with interactive examples is available at:

**๐Ÿ‘‰ [aldi.github.io/bulma-social](https://aldi.github.io/bulma-social)**

---

## ๐Ÿค Contributing

Contributions are welcome! Please read our [Contributing Guide](.github/CONTRIBUTING.md) before submitting a Pull Request.

1. Fork the repository
2. Create your feature branch (`git checkout -b new-provider`)
3. Commit your changes (`git commit -m 'Add new provider'`)
4. Push to the branch (`git push origin new-provider`)
5. Open a Pull Request

---

## ๐Ÿ“„ License

Released under the [MIT License](LICENSE).

---