first commit

This commit is contained in:
Loi Phan
2025-08-20 16:33:11 +07:00
commit 13caefcbb3
20 changed files with 4218 additions and 0 deletions
+41
View File
@@ -0,0 +1,41 @@
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
# dependencies
/node_modules
/.pnp
.pnp.*
.yarn/*
!.yarn/patches
!.yarn/plugins
!.yarn/releases
!.yarn/versions
# testing
/coverage
# next.js
/.next/
/out/
# production
/build
# misc
.DS_Store
*.pem
# debug
npm-debug.log*
yarn-debug.log*
yarn-error.log*
.pnpm-debug.log*
# env files (can opt-in for committing if needed)
.env*
# vercel
.vercel
# typescript
*.tsbuildinfo
next-env.d.ts
+139
View File
@@ -0,0 +1,139 @@
# WebSocket Demo with Next.js
This project demonstrates real-time communication using WebSocket with a Next.js frontend and a standalone WebSocket server.
## Features
- Real-time messaging between multiple clients
- Connection status indicator
- Message history with timestamps
- Sender name customization
- Responsive design with Tailwind CSS
## Project Structure
```
src/
├── app/
│ ├── page.tsx # Main page component
│ └── layout.tsx # App layout
├── components/
│ └── WebSocketDemo.tsx # WebSocket client component
server/
└── websocket.js # WebSocket server
```
## Getting Started
### Prerequisites
- Node.js (version 18 or higher)
- pnpm (recommended) or npm
### Installation
1. Install dependencies:
```bash
pnpm install
```
### Running the Application
#### Option 1: Run both servers simultaneously (Recommended)
```bash
pnpm run dev:all
```
This will start:
- Next.js development server on http://localhost:3000
- WebSocket server on ws://localhost:8080
#### Option 2: Run servers separately
1. Start the WebSocket server:
```bash
pnpm run ws-server
```
2. In another terminal, start the Next.js development server:
```bash
pnpm run dev
```
### Usage
1. Open [http://localhost:3000](http://localhost:3000) in your browser
2. Enter your name (optional)
3. Click "Connect" to establish WebSocket connection
4. Start sending messages
5. Open multiple browser tabs/windows to test real-time messaging between clients
## WebSocket Server Details
The WebSocket server (`server/websocket.js`) provides:
- Connection management for multiple clients
- Message broadcasting to all connected clients
- Welcome messages for new connections
- Error handling and logging
### Message Format
Messages sent between client and server follow this JSON structure:
```json
{
"type": "broadcast",
"message": "Hello, World!",
"sender": "John Doe",
"timestamp": "2025-08-20T10:30:00.000Z"
}
```
## Technologies Used
- **Next.js 15** - React framework
- **React 19** - UI library
- **TypeScript** - Type safety
- **Tailwind CSS** - Styling
- **ws** - WebSocket library
- **WebSocket API** - Browser WebSocket implementation
## Development
### Scripts
- `pnpm run dev` - Start Next.js development server
- `pnpm run build` - Build for production
- `pnpm run start` - Start production server
- `pnpm run ws-server` - Start WebSocket server
- `pnpm run dev:all` - Start both servers simultaneously
- `pnpm run lint` - Run ESLint
### Customization
You can customize the WebSocket server by modifying `server/websocket.js`:
- Change the port (default: 8080)
- Add authentication
- Implement different message types
- Add message persistence
- Implement rooms/channels
## Troubleshooting
### Connection Issues
If you can't connect to the WebSocket server:
1. Ensure the WebSocket server is running on port 8080
2. Check if the port is already in use by another application
3. Verify firewall settings allow connections on port 8080
### CORS Issues
If running in production, you may need to configure CORS settings for the WebSocket server.
## License
This project is open source and available under the [MIT License](LICENSE).
+25
View File
@@ -0,0 +1,25 @@
import { dirname } from "path";
import { fileURLToPath } from "url";
import { FlatCompat } from "@eslint/eslintrc";
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
const compat = new FlatCompat({
baseDirectory: __dirname,
});
const eslintConfig = [
...compat.extends("next/core-web-vitals", "next/typescript"),
{
ignores: [
"node_modules/**",
".next/**",
"out/**",
"build/**",
"next-env.d.ts",
],
},
];
export default eslintConfig;
+7
View File
@@ -0,0 +1,7 @@
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
/* config options here */
};
export default nextConfig;
+32
View File
@@ -0,0 +1,32 @@
{
"name": "web-socket-demo",
"version": "0.1.0",
"private": true,
"scripts": {
"dev": "next dev --turbopack",
"build": "next build --turbopack",
"start": "next start",
"lint": "eslint",
"ws-server": "node server/websocket.js",
"dev:all": "concurrently \"pnpm run dev\" \"pnpm run ws-server\""
},
"dependencies": {
"@types/ws": "^8.18.1",
"next": "15.5.0",
"react": "19.1.0",
"react-dom": "19.1.0",
"ws": "8.18.3"
},
"devDependencies": {
"@eslint/eslintrc": "^3",
"@tailwindcss/postcss": "^4",
"@types/node": "^20",
"@types/react": "^19",
"@types/react-dom": "^19",
"concurrently": "^9.2.0",
"eslint": "^9",
"eslint-config-next": "15.5.0",
"tailwindcss": "^4",
"typescript": "^5"
}
}
+3593
View File
File diff suppressed because it is too large Load Diff
+5
View File
@@ -0,0 +1,5 @@
const config = {
plugins: ["@tailwindcss/postcss"],
};
export default config;
+1
View File
@@ -0,0 +1 @@
<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

After

Width:  |  Height:  |  Size: 391 B

+1
View File
@@ -0,0 +1 @@
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

After

Width:  |  Height:  |  Size: 1.0 KiB

+1
View File
@@ -0,0 +1 @@
<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

After

Width:  |  Height:  |  Size: 1.3 KiB

+1
View File
@@ -0,0 +1 @@
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

After

Width:  |  Height:  |  Size: 128 B

+1
View File
@@ -0,0 +1 @@
<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

After

Width:  |  Height:  |  Size: 385 B

+53
View File
@@ -0,0 +1,53 @@
const { WebSocketServer } = require('ws');
const { createServer } = require('http');
const server = createServer();
const wss = new WebSocketServer({ server });
wss.on('connection', (ws) => {
console.log('Client connected');
// Send welcome message
ws.send(JSON.stringify({
type: 'welcome',
message: 'Connected to WebSocket server!',
timestamp: new Date().toISOString()
}));
// Handle incoming messages
ws.on('message', (data) => {
try {
const message = JSON.parse(data.toString());
console.log('Received:', message);
// Broadcast to all connected clients
wss.clients.forEach((client) => {
if (client.readyState === 1) { // WebSocket.OPEN
client.send(JSON.stringify({
type: 'broadcast',
message: message.message,
sender: message.sender || 'Anonymous',
timestamp: new Date().toISOString()
}));
}
});
} catch (error) {
console.error('Error parsing message:', error);
}
});
ws.on('close', () => {
console.log('Client disconnected');
});
ws.on('error', (error) => {
console.error('WebSocket error:', error);
});
});
const PORT = process.env.WS_PORT || 8080;
server.listen(PORT, () => {
console.log(`WebSocket server started on port ${PORT}`);
});
module.exports = { wss };
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

+26
View File
@@ -0,0 +1,26 @@
@import "tailwindcss";
:root {
--background: #ffffff;
--foreground: #171717;
}
@theme inline {
--color-background: var(--background);
--color-foreground: var(--foreground);
--font-sans: var(--font-geist-sans);
--font-mono: var(--font-geist-mono);
}
@media (prefers-color-scheme: dark) {
:root {
--background: #0a0a0a;
--foreground: #ededed;
}
}
body {
background: var(--background);
color: var(--foreground);
font-family: Arial, Helvetica, sans-serif;
}
+34
View File
@@ -0,0 +1,34 @@
import type { Metadata } from "next";
import { Geist, Geist_Mono } from "next/font/google";
import "./globals.css";
const geistSans = Geist({
variable: "--font-geist-sans",
subsets: ["latin"],
});
const geistMono = Geist_Mono({
variable: "--font-geist-mono",
subsets: ["latin"],
});
export const metadata: Metadata = {
title: "Create Next App",
description: "Generated by create next app",
};
export default function RootLayout({
children,
}: Readonly<{
children: React.ReactNode;
}>) {
return (
<html lang="en">
<body
className={`${geistSans.variable} ${geistMono.variable} antialiased`}
>
{children}
</body>
</html>
);
}
+11
View File
@@ -0,0 +1,11 @@
import WebSocketDemo from "@/components/WebSocketDemo";
export default function Home() {
return (
<div className="min-h-screen bg-gray-100 py-8">
<div className="container mx-auto px-4">
<WebSocketDemo />
</div>
</div>
);
}
+220
View File
@@ -0,0 +1,220 @@
'use client';
import React, { useState, useEffect, useRef } from 'react';
interface Message {
type: string;
message: string;
sender?: string;
timestamp: string;
}
export default function WebSocketDemo() {
const [messages, setMessages] = useState<Message[]>([]);
const [inputMessage, setInputMessage] = useState('');
const [senderName, setSenderName] = useState('');
const [isConnected, setIsConnected] = useState(false);
const [connectionStatus, setConnectionStatus] = useState('Disconnected');
const ws = useRef<WebSocket | null>(null);
const messagesEndRef = useRef<HTMLDivElement>(null);
const scrollToBottom = () => {
messagesEndRef.current?.scrollIntoView({ behavior: 'smooth' });
};
useEffect(() => {
scrollToBottom();
}, [messages]);
const connectWebSocket = () => {
if (ws.current?.readyState === WebSocket.OPEN) {
return;
}
setConnectionStatus('Connecting...');
ws.current = new WebSocket('ws://localhost:8080');
ws.current.onopen = () => {
setIsConnected(true);
setConnectionStatus('Connected');
console.log('Connected to WebSocket server');
};
ws.current.onmessage = (event) => {
try {
const data = JSON.parse(event.data);
setMessages(prev => [...prev, data]);
} catch (error) {
console.error('Error parsing message:', error);
}
};
ws.current.onclose = () => {
setIsConnected(false);
setConnectionStatus('Disconnected');
console.log('Disconnected from WebSocket server');
};
ws.current.onerror = (error) => {
setConnectionStatus('Error');
console.error('WebSocket error:', error);
};
};
const disconnectWebSocket = () => {
if (ws.current) {
ws.current.close();
ws.current = null;
}
};
const sendMessage = () => {
if (ws.current?.readyState === WebSocket.OPEN && inputMessage.trim()) {
const message = {
message: inputMessage,
sender: senderName || 'Anonymous',
timestamp: new Date().toISOString()
};
ws.current.send(JSON.stringify(message));
setInputMessage('');
}
};
const handleKeyPress = (e: React.KeyboardEvent) => {
if (e.key === 'Enter' && !e.shiftKey) {
e.preventDefault();
sendMessage();
}
};
const getStatusColor = () => {
switch (connectionStatus) {
case 'Connected':
return 'text-green-600';
case 'Connecting...':
return 'text-yellow-600';
case 'Error':
return 'text-red-600';
default:
return 'text-gray-600';
}
};
return (
<div className="max-w-4xl mx-auto p-6 bg-white rounded-lg shadow-lg">
<div className="mb-6">
<h1 className="text-3xl font-bold text-gray-800 mb-2">WebSocket Demo</h1>
<p className="text-gray-600">Real-time messaging with Next.js and WebSocket</p>
</div>
{/* Connection Status */}
<div className="mb-4 p-3 bg-gray-100 rounded-lg">
<div className="flex items-center justify-between">
<span className={`font-semibold ${getStatusColor()}`}>
Status: {connectionStatus}
</span>
<div className="space-x-2">
<button
onClick={connectWebSocket}
disabled={isConnected}
className={`px-4 py-2 rounded font-medium ${
isConnected
? 'bg-gray-300 text-gray-500 cursor-not-allowed'
: 'bg-blue-500 text-white hover:bg-blue-600'
}`}
>
Connect
</button>
<button
onClick={disconnectWebSocket}
disabled={!isConnected}
className={`px-4 py-2 rounded font-medium ${
!isConnected
? 'bg-gray-300 text-gray-500 cursor-not-allowed'
: 'bg-red-500 text-white hover:bg-red-600'
}`}
>
Disconnect
</button>
</div>
</div>
</div>
{/* Sender Name Input */}
<div className="mb-4">
<input
type="text"
placeholder="Enter your name (optional)"
value={senderName}
onChange={(e) => setSenderName(e.target.value)}
className="w-full p-3 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
/>
</div>
{/* Messages Container */}
<div className="mb-4 h-96 border border-gray-300 rounded-lg p-4 overflow-y-auto bg-gray-50">
{messages.length === 0 ? (
<div className="text-gray-500 text-center py-8">
No messages yet. Connect to the WebSocket server and start chatting!
</div>
) : (
messages.map((msg, index) => (
<div key={index} className="mb-3 p-3 bg-white rounded-lg shadow-sm">
<div className="flex justify-between items-start mb-1">
<span className="font-semibold text-blue-600">
{msg.sender || 'Anonymous'}
</span>
<span className="text-xs text-gray-500">
{new Date(msg.timestamp).toLocaleTimeString()}
</span>
</div>
<div className="text-gray-800">{msg.message}</div>
{msg.type === 'welcome' && (
<div className="text-xs text-green-600 mt-1">Welcome message</div>
)}
</div>
))
)}
<div ref={messagesEndRef} />
</div>
{/* Message Input */}
<div className="flex gap-2">
<input
type="text"
placeholder="Type your message..."
value={inputMessage}
onChange={(e) => setInputMessage(e.target.value)}
onKeyPress={handleKeyPress}
disabled={!isConnected}
className={`flex-1 p-3 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500 ${
!isConnected ? 'bg-gray-100 cursor-not-allowed' : ''
}`}
/>
<button
onClick={sendMessage}
disabled={!isConnected || !inputMessage.trim()}
className={`px-6 py-3 rounded-lg font-medium ${
!isConnected || !inputMessage.trim()
? 'bg-gray-300 text-gray-500 cursor-not-allowed'
: 'bg-blue-500 text-white hover:bg-blue-600'
}`}
>
Send
</button>
</div>
{/* Instructions */}
<div className="mt-6 p-4 bg-blue-50 rounded-lg">
<h3 className="font-semibold text-blue-800 mb-2">Instructions:</h3>
<ol className="text-sm text-blue-700 space-y-1">
<li>1. Start the WebSocket server by running: <code className="bg-blue-100 px-1 rounded">node server/websocket.js</code></li>
<li>2. Click &quot;Connect&quot; to establish WebSocket connection</li>
<li>3. Enter your name (optional) and start sending messages</li>
<li>4. Open multiple browser tabs to see real-time messaging between clients</li>
</ol>
</div>
</div>
);
}
+27
View File
@@ -0,0 +1,27 @@
{
"compilerOptions": {
"target": "ES2017",
"lib": ["dom", "dom.iterable", "esnext"],
"allowJs": true,
"skipLibCheck": true,
"strict": true,
"noEmit": true,
"esModuleInterop": true,
"module": "esnext",
"moduleResolution": "bundler",
"resolveJsonModule": true,
"isolatedModules": true,
"jsx": "preserve",
"incremental": true,
"plugins": [
{
"name": "next"
}
],
"paths": {
"@/*": ["./src/*"]
}
},
"include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
"exclude": ["node_modules"]
}