💬 Global Chat 💬

A Modern Terminal-based Real-time Chat Application

Note

Global Chat is a feature-rich terminal-based chat application that enables real-time communication with a modern, stylish interface. Built with Rust for the client and Bun for the server, it combines performance with an excellent user experience.

bun terminal

bun x @arnavk-09/global-chat

npm terminal

npx @arnavk-09/global-chat

🌟 Features

Global Chat offers a comprehensive chat experience:

• Real-time Communication – Instant message delivery using WebSocket technology
• Modern Terminal UI – Stylish interface with custom colors and emoji support
• Fun Usernames – Automatic generation of unique, memorable usernames
• Message History – Access to recent chat history for new users
• User Status – Live tracking of user connections and disconnections
• Responsive Design – Smooth scrolling and message navigation
• System Messages – Automatic notifications for user join/leave events

💻 Installation

Get started with Global Chat in a few simple steps:

Client Setup (Rust)

# Build and run the client
cargo build --release
cargo run

Server Setup (Bun)

# Navigate to server directory
cd server

# Install dependencies
bun install

# Start the server
bun run index.ts

📷 Screenshots

Chat Interface

📷 Demo Video

Global.chat.alpha.preview.mp4

---

💻 Contributing

Tip

We welcome contributions to improve Global Chat! If you have suggestions, bug fixes, or new feature ideas, follow these steps:

1. Fork the Repository
   Click the Fork button at the top-right of the repo page.

2. Clone Your Fork
   Clone the repo locally:

   git clone https://github.com/ArnavK-09/global-chat.git

3. Create a Branch
   Create a new branch for your changes:

   git checkout -b your-feature-branch

4. Make Changes
   Implement your changes (bug fixes, features, etc.).

5. Commit and Push
   Commit your changes and push the branch:

   git commit -m "feat(scope): description"
   git push origin your-feature-branch

6. Open a Pull Request
   Open a PR with a detailed description of your changes.

7. Collaborate and Merge
   The maintainers will review your PR, request changes if needed, and merge it once approved.

🙋‍♂️ Issues

Found a bug or need help? Please create an issue on the GitHub repository with a detailed description.

👤 Author

Arnav K

---

📄 License

Global Chat is licensed under the MIT License. See the LICENSE file for more details.

---

🌟 If you find this project helpful, please give it a star on GitHub! 🌟