https://github.com/leeocoder/ng-toastly
Modern, Lightweight, and Type-Safe Toast Notifications for Angular 17+ with zero dependencies. Features reactive Signals architecture, multi-positioning, dark mode, and full accessibility compliance.
https://github.com/leeocoder/ng-toastly
accessibility alert angular customable design library notification signals standalone-components system toast ui
Last synced: about 2 months ago
JSON representation
Modern, Lightweight, and Type-Safe Toast Notifications for Angular 17+ with zero dependencies. Features reactive Signals architecture, multi-positioning, dark mode, and full accessibility compliance.
- Host: GitHub
- URL: https://github.com/leeocoder/ng-toastly
- Owner: leeocoder
- Created: 2026-01-15T18:34:26.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-01-16T12:03:34.000Z (about 2 months ago)
- Last Synced: 2026-01-21T02:28:14.168Z (about 2 months ago)
- Topics: accessibility, alert, angular, customable, design, library, notification, signals, standalone-components, system, toast, ui
- Language: TypeScript
- Homepage:
- Size: 500 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Toastly
Modern, Lightweight, and Type-Safe Toast Notifications for Angular.
[](LICENSE)
[](https://angular.io)
[]()
[](https://leeocoder.github.io/ng-toastly/)
[](CONTRIBUTING.md)
---
## 📖 About The Project
**Toastly** is an open-source Angular library designed to provide a developer-friendly and accessible way to display toast notifications. Unlike many existing solutions, Toastly takes full advantage of **Angular 17+** features, utilizing **Signals** for reactive state management and **Standalone Components** for ease of use.
This repository serves as a monorepo containing:
1. **The Library**: The core `@toastly/toastly` package.
2. **The Documentation**: A static site showcasing features and usage examples.
### Key Features
- 🚀 **Modern Architecture**: Built with Signals and Standalone Components.
- 📐 **Multi-Positioning**: Support for multiple independent toast containers.
- 🎨 **Themable**: Native dark mode support and extensive CSS variable customization.
- ♿ **Accessible**: ARIA-compliant and keyboard navigable.
- 📦 **Lightweight**: Zero 3rd-party dependencies.
---
## 📂 Repository Structure
```
toastly/
├── docs/ # Documentation & Landing Page (Static Site)
├── projects/
│ └── toastly/ # The Core Angular Library Source
├── angular.json # Workspace Configuration
└── package.json # Root Dependencies
```
---
## 🛠️ Development
If you want to contribute to Toastly or run it locally, follow these steps.
### Prerequisites
- Node.js (v18 or higher)
- npm
- Angular CLI
### Installation
1. **Clone the repo**
```bash
git clone https://github.com/leeocoder/ng-toastly.git
cd toastly
```
2. **Install dependencies**
```bash
npm install ng-toastly
```
### Running the Library (Watch Mode)
To develop the library with hot reload:
```bash
ng build toastly --watch
```
### Building the Library
To generate a production build of the library (outputs to `dist/toastly`):
```bash
ng build toastly
```
### Running the Tests
To execute unit tests via Vitest/Karma:
```bash
ng test toastly
```
---
## 🚀 Publishing
To clean, build, and publish the library to npm:
```bash
# 1. Build the library
ng build toastly --configuration production
# 2. Navigate to dist
cd dist/toastly
# 3. Publish
npm publish
```
---
## 🤝 Contributing
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'feat: Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
---
## 📄 License
Distributed under the MIT License. See `LICENSE` for more information.
---
Made with ❤️ by Leonardo Albuquerque