Skip to content

A terminal-style Next.js + Tailwind CSS frontend for chatting in anonymous rooms. Features a retro hacker aesthetic, real-time updates via WebSockets, dark mode and blazing-fast performance for seamless, keyboard-first conversation.

Notifications You must be signed in to change notification settings

jztchl/random-chat-front_end

Repository files navigation

App Logo

Terminal Styled Random Chat App

*Chat freely in rooms — terminal-style, real-time, anonymous*

⚡ Overview

Random Chat is a Terminal-themed, real-time web chat app where users can:

  • Join or create public chat rooms
  • Chat anonymously without signup
  • Experience a slick terminal-style UI
  • See who's active in real time
  • Send and receive messages live via WebSockets

Built with 💚 Next.js App Router + TailwindCSS + native WebSockets


🖼️ Preview


🧠 Features

  • 🔓 No signup — pick a nickname and go
  • 📡 Real-time messaging via WebSockets
  • 🧪 Terminal-style hacker UI
  • 🏠 Room creation & discovery
  • 🔐 Local username persistence
  • ⚙️ Deployed + environment-configurable frontend

🔧 Tech Stack

Layer Tech
Framework Next.js (App Router)
Styling TailwindCSS
Real-Time Native WebSocket API
Hosting Vercel or similar

🚀 Getting Started

1. Clone the repo

git clone https://github.com/jztchl/random-chat-frontend.git
cd random-chat-frontend

2. Install dependencies

npm install

3. Set up environment variables

Create a .env.local file in the root and add:

NEXT_PUBLIC_BACKEND_URL_HTTPS=https://your-url
NEXT_PUBLIC_BACKEND_URL_WSS=wss://your-url

🔒 Backend & WebSocket URLs are injected via environment variables for flexibility.

4. Run locally

npm run dev

Now open http://localhost:3000 and start chatting.


🧪 Project Structure

app/
│
├─ page.tsx              # Home - Join/Create rooms
├─ chat/
│   └─ [room]/page.tsx   # Dynamic Chat Room UI
│      
│
├─ styles/
│   └─ globals.css       # Global styles
│
└─ .env.local            # Environment variables

📦 Deployment

This project works seamlessly on Vercel:

  1. Link your repo on Vercel
  2. Add the same .env variables to the dashboard
  3. Deploy and go live 🌐

🙏 Credits

Backend API by random-room-chats

Built with ❤️ by jztchl


📄 License

MIT License — use it, remix it, own it.


About

A terminal-style Next.js + Tailwind CSS frontend for chatting in anonymous rooms. Features a retro hacker aesthetic, real-time updates via WebSockets, dark mode and blazing-fast performance for seamless, keyboard-first conversation.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published