Add automated tests, CI pipeline, and documentation improvements

.github/workflows/test.yml

@@ -0,0 +1,28 @@
+name: Run Tests
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install Dependencies
+        working-directory: ./server
+        run: npm ci
+
+      - name: Run Tests
+        working-directory: ./server
+        run: npx vitest run

README.md

@@ -27,6 +27,7 @@ Transfer files across your local network directly from device to device using We
   - [2. Install Dependencies](#2-install-dependencies)
   - [3. Run the Signaling Server](#3-run-the-signaling-server)
   - [4. Serve the Frontend](#4-serve-the-frontend)
+- [Running Tests](#running-tests)
 - [Self-Hosting](#self-hosting)
   - [Frontend — GitHub Pages](#frontend--github-pages)
   - [Backend — Signaling Server](#backend--signaling-server)
@@ -182,6 +183,31 @@ Then open `http://localhost:8080` in your browser.
 
 ---
 
+## Running Tests
+
+### Prerequisites
+
+- Node.js 16+ and npm installed
+- Server dependencies installed in the `server` folder (`npm install`)
+
+### Commands
+
+From the project root:
+
+```bash
+cd server
+npx vitest run
+```
+
+Or run the npm test script (watch mode):
+
+```bash
+cd server
+npm test
+```
+
+---
+
 ## Self-Hosting
 
 ### Frontend — GitHub Pages

server/index.js

@@ -366,6 +366,15 @@ wss.on('connection', (ws, req) => {
 });
 
 const PORT = process.env.PORT || 3000;
-server.listen(PORT, () => {
-    console.log(`Signaling server running on port ${PORT}`);
-});
+
+function startServer(port = PORT) {
+    return server.listen(port, () => {
+        console.log(`Signaling server running on port ${port}`);
+    });
+}
+
+if (require.main === module && process.env.NODE_ENV !== 'test') {
+    startServer();
+}
+
+module.exports = { app, server, startServer };