Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/kartikmanimuthu/phoenix-websocket-notifier

A high-performance real-time notification system built with Node.js, Express, Socket.io, and Redis.
https://github.com/kartikmanimuthu/phoenix-websocket-notifier

docker expressjs nodejs redis socket-io socket-programming websocket

Last synced: about 1 month ago
JSON representation

A high-performance real-time notification system built with Node.js, Express, Socket.io, and Redis.

Awesome Lists containing this project

README

        

Phoenix Websocket Notifier


GitHub Workflow Status

GitHub


A high-performance real-time notification system built with Node.js, Express, Socket.io, and Redis.

## ๐Ÿ› ๏ธ Prerequisites

Before you begin, ensure you have met the following requirements:

- Docker and Docker-compose
- Node.js 14.0 or higher
- Redis 6.0 or higher

## ๐Ÿš€ Getting Started

Clone the repository and install dependencies:

```bash
git clone https://github.com/Karthikmani345/phoenix-websocket-notifier.git
cd phoenix-websocket-notifier
npm install
```

### ๐Ÿ”ง Local Setup

Create a `.env` file in your root directory and provide your local setup configurations as per the `.env.example` file in the repository.

After configuring the environment variables, you can start the server in development mode:

```bash
npm run start:dev
```

To access the app, navigate to [`localhost:4000`](http://localhost:4000) from your browser.

For running the Redis server locally, you may need to install Redis on your machine and start the Redis server:

```bash
redis-server
```

### ๐Ÿณ Docker Setup

Build and start the Docker containers:

```bash
docker-compose up --build
```

### ๐Ÿž Debugging

For debugging, you can use:

```bash
npm run debug:vs
```

You can then attach a debugger to your running app on the port specified in your `.env` file.

## ๐ŸŽฎ Usage

Use the following commands as per your requirements:

- Clean the dist directory: `npm run clean`

## ๐Ÿงช Testing

Test cases and relevant documentation are in progress and will be updated soon.

## ๐Ÿค How to Contribute

Love this project? Great! We're open to contributions. To start, you can:

1. Fork this repository
2. Create your branch: `git checkout -b my-feature`
3. Commit your changes: `git commit -m "Add my feature"`
4. Push to your branch: `git push origin my-feature`
5. Create a pull request!

Read our [contributing guide](./CONTRIBUTING.md) for more info.

## ๐Ÿ“œ License

Phoenix Websocket Notifier is [ISC licensed](./LICENSE).