Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/max21dev/groups
NIP-29 Group Chat (Web Client)
https://github.com/max21dev/groups
bitcoin chat decentralized group nip29 nostr
Last synced: 2 months ago
JSON representation
NIP-29 Group Chat (Web Client)
- Host: GitHub
- URL: https://github.com/max21dev/groups
- Owner: max21dev
- Created: 2024-08-14T16:21:11.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-09-08T23:23:24.000Z (2 months ago)
- Last Synced: 2024-09-09T13:29:22.791Z (2 months ago)
- Topics: bitcoin, chat, decentralized, group, nip29, nostr
- Language: TypeScript
- Homepage: https://groups.nip29.com
- Size: 141 KB
- Stars: 7
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- awesome-nostr - Groups - NIP-29 Group Chat Web Client. (Clients / Relay lists)
README
# 💬 Groups
## Introduction
**"Groups"** is a free and open-source chat application built on the Nostr protocol, utilizing the NIP-29 standard to support relay-based groups with specific moderation capabilities.
This client enables users to participate in groups managed by relays, where access and participation are governed by rules enforced by the relay.
## Features
- **User-Friendly Interface**:
- ✅ Clean and intuitive design.
- ✅ Easy navigation and group management.
- ✅ Responsive layout for all devices.
- ✅ Animated transitions and effects.
- ✅ Real-time updates.
- ✅ Built-in caching and data persistence.
- ✅ Image and URL previews.
- ✅ Dark mode support.
- 🚧 Customizable settings.
- 🚧 Offline support.
- 🚧 PWA support.
- 🚧 Rich text formatting.
- **Messaging**:
- ✅ View and join existing groups.
- ✅ Send and delete messages.
- ✅ React to messages with emojis.
- ✅ Reply to messages.
- ✅ Zap to messages sender.
- 🚧 Reaction to message (kind:7 in supported relay).
- 🚧 Mention users in messages.
- 🚧 Pin important messages.
- 🚧 Receive notifications for new messages.
- 🚧 Attach images and files.
- 🚧 Create and manage threads.
- 🚧 Create and manage polls.
- **Group Moderation**:
- 🚧 Create new groups with custom settings.
- 🚧 Edit and customize existing groups.
- 🚧 View and manage group members and admins.
- 🚧 Moderate group content and messages.
- 🚧 Create and manage private groups.
## Live Demo
You can access the live demo of **"Groups"** at the following URL:
- [groups.nip29.com](https://groups.nip29.com)
## Installation
To install and run **"Groups"** locally, follow these steps:
1. **Clone the repository:**
```bash
git clone https://github.com/max21dev/groups.git
```
2. **Navigate to the project directory:**
```bash
cd groups
```
3. **Install dependencies:**
```bash
npm install
```
4. **Run the development server:**
```bash
npm run dev
```
## Usage
Once the development server is running, you can access the chat client through your web browser. The interface will allow you to create or join groups, participate in discussions, and manage group settings.
## Libraries and Tools Used
- **Vite:** Frontend build tool and development server. [→](https://github.com/vitejs/vite)
- **TypeScript**: Strongly typed programming language that builds on JavaScript. [→](https://github.com/microsoft/TypeScript)
- **React**: JavaScript library for building user interfaces. [→](https://github.com/facebook/react)
- **Tailwind CSS**: Utility-first CSS framework for styling. [→](https://github.com/tailwindlabs/tailwindcss)
- **Shadcn UI**: Beautiful designed components. [→](https://github.com/shadcn-ui/ui)
- **Zustand**: Bear necessities for state management in React. [→](https://github.com/pmndrs/zustand)
- **nostr-tools**: Tools for developing Nostr clients. [→](https://github.com/nbd-wtf/nostr-tools)
- **NDK (Nostr Dev Kit)**: NDK is a nostr development kit that makes the experience of building Nostr-related applications. [→](https://github.com/nostr-dev-kit/ndk)
- **Nostr-Hooks**: Nostr-Hooks is a stateful wrapper library of React hooks around NDK. [→](https://github.com/ostyjs/nostr-hooks)
## Contribution
We welcome contributions from the community! If you'd like to contribute, please follow these guidelines:
1. Fork the repository.
2. Create a new branch for your feature or bugfix.
3. Submit a pull request with a clear description of your changes.
## License
This project is licensed under the MIT License.
## Acknowledgements
Special thanks to the Nostr protocol community and all contributors who helped make this project possible.