🌌 Fugue — Ephemeral Anonymous Chat

“A conversation that leaves no trace.”
Inspired by the fugue state — a temporary amnesic condition — Fugue is a secure, in-memory, peer-to-peer chat where nothing persists.

---

✨ Features

Feature	Description
🔐 Account-Based Access	Users sign up and log in with username + password. Sessions persist via secure cookies until logout.
🎯 Interest Matching	Select multiple interests; chat pairing prioritises shared interests with optional "extend search" fallback.
🔄 Real-Time Sync	WebSocket-powered live messaging with automatic pairing and partner presence events.
🚪 Leave Any Time	Leave chat without logging out — return to the lobby with a single click.
🧼 Ephemeral by Design	Messages live only in memory — nothing saved after disconnect.
🎨 Dark Mode UI	Clean Tailwind UI with responsive layout.
🐳 Docker-Ready	Dev & prod Dockerfiles included.
🔄 CI/CD Pipeline	Automated testing, building, and deployment via GitHub Actions.

---

🚀 Quick Start (Local Dev)

Prerequisites

• Node.js v18+
• PostgreSQL (local or remote). The default dev DSN expects a local database named fugue_app.
• Docker (optional, for container testing)

1. Install dependencies

# Clone the repo
git clone https://github.com/umarmahmoodshk/fugue-app.git
cd fugue-app

# Backend deps
npm install

# Frontend deps
npm install --prefix client

2. Configure Postgres

# Create the local database (optional if you supply DATABASE_URL)
createdb fugue_app

Create a .env in the project root if you want to override defaults:

DATABASE_URL=postgres://user:password@localhost:5432/fugue_app
SESSION_SECRET=super-secret

3. Run the app

# Start the backend (ensures schema automatically)
npm run dev

# Option A: run the Vite dev server (hot reload)
npm run dev --prefix client
#   visit http://localhost:5173

# Option B: build the client once and let Express serve it
npm run build:client
#   reload http://localhost:8080

Sign up with a username/password, pick interests, then start matching. Use the Leave button to exit a chat without logging out.

---

🐳 Docker Usage

Build & Run Dev Image (Backend Only)

docker build -f Dockerfile.dev -t fugue-dev .
docker run -p 3000:3000 fugue-dev

Keep frontend running via npm run dev in client/.

Build & Run Production Image (Full App)

docker build -f Dockerfile.prod -t fugue-prod .
docker run -p 3000:3000 fugue-prod

👉 Visit http://localhost:3000 — frontend + backend in one container!

---

🔄 CI/CD Pipeline (GitHub Actions)

Based on the Trinity Bootstrap workflow:

Branch	Pipeline Action
dev	✅ Run tests → 🏗️ Build dev image
main	✅ Run tests → 🏗️ Build prod image → 🚀 Push to GHCR

📁 See: .github/workflows/ci.yml

---

📂 Project Structure

fugue-app/
├── client/               # React + Vite frontend
│   ├── src/              # Components, hooks, styles
│   └── vite.config.js    # Dev server config (host: 0.0.0.0)
├── index.js              # Node.js + WebSocket backend
├── package.json          # Backend dependencies
├── Dockerfile.dev        # Dev container (backend only)
├── Dockerfile.prod       # Production container (full app)
├── .gitignore
└── .github/workflows/ci.yml

---

🔐 Privacy & Security

• No data persistence: All state is in-memory (server + browser).
• No logs: Backend never stores messages after disconnect.
• Anti-screenshot: UI blurs on logout.
• No tracking: Zero analytics, cookies, or telemetry.

🕊️ Fugue respects your right to forget.

---

🌍 Deploy to Cloud (Coming Soon)

• Fly.io (1-command deploy)
• Render
• AWS ECS

---

🙌 Contributing

This is a learning project aligned with the Trinity Bootstrap DevOps workflow.
Feel free to:

• ✨ Improve UI/UX
• 🧪 Add unit tests
• 🚀 Add cloud deployment scripts

---

🔧 Key Features Implementation

Real-time WebSocket Communication

• Automatic user pairing system
• Room-based chat management
• Connection health monitoring
• Graceful disconnect handling

Production Optimizations

• Multi-stage Docker builds for minimal image size
• Non-root user execution for security
• Environment-based configuration
• Cloud Run with WebSocket support

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the project
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🙏 Acknowledgments

• Built as part of the Trinity Bootstrap project
• Real-time functionality powered by WebSockets
• Deployed on Google Cloud Platform
• Continuous deployment via GitHub Actions

---

⭐ Star this repo if you found it helpful!

“We met in the fog. We spoke. We vanished.”
— Fugue v1.0

---

🌍 Live Deployment

✅ Currently deployed on Google Cloud Run: Try Fugue Live