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

https://github.com/devstack-be/devstack-notify

Headless Vue 3 notification library with Tailwind CSS
https://github.com/devstack-be/devstack-notify

notifications nuxtui tailwindcss tailwindui toast vite vue3

Last synced: 3 months ago
JSON representation

Headless Vue 3 notification library with Tailwind CSS

Awesome Lists containing this project

README

        

# Devstack Notify - Vue 3 & Tailwind CSS
[![NPM](https://flat.badgen.net/npm/v/devstack-notify)](https://www.npmjs.com/package/devstack-notify) [![Vue 3](https://img.shields.io/badge/Vue-3-green)](https://img.shields.io/badge/Vue-3-green)

Headless Vue 3 notification library with Tailwind CSS.

Inspired by [NuxtUI Notifications](https://ui.nuxt.com/)
![Screenshot of a notification (1)](https://github.com/devstack-be/devstack-notify/blob/main/playground/public/teasing_1.png)
![Screenshot of a notification (2)](https://github.com/devstack-be/devstack-notify/blob/main/playground/public/teasing_2.png)
![Screenshot of a notification (3)](https://github.com/devstack-be/devstack-notify/blob/main/playground/public/teasing_3.png)

## 🌟 Features

- Vue 3 composition API support
- Fully written in Typescript
- Light and beautiful
- Easy to install and personnalisable
- Timeout, callback, actions

## 🤖 Demo

[Live Preview - coming soon]()

## ⚡️ Installation

```bash
yarn add devstack-notify
```

or

```bash
npm i devstack-notify
```

You can then register `Notifications` as a Vue plugin:

```js
import { createApp } from 'vue'
import Notifications from 'devstack-notify'
import App from './App.vue'

createApp(App)
.use(Notifications)
.mount('#app')
```

## 🍞 How to use

Add the "StackNotifications" components to your main layout or in `App.vue`:

```vue

```

Then, trigger notifications from your `.vue` files:

###### Composition API

```javascript
import { useToast } from "devstack-notify"

toast.add({
title: 'No type specified',
description: 'Small description'
})
toast.success({
title: 'Success',
description: 'Small description'
})
toast.error({
title: 'Error',
description: 'Small description'
})
toast.warning({
title: 'Warning',
description: 'Small description'
})
toast.info({
title: 'Info',
description: 'Small description'
})
```

## Props

* To do

## To do

* Complete documentation
* Tests

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

## License

MIT