README.md

---
title: Stock Rivals
emoji: 📈
colorFrom: yellow
colorTo: gray
sdk: docker
pinned: false
---

# Stock Rivals 📈

A high-stakes, turn-based multiplayer stock trading game where strategy meets market volatility. Styled with a dark Cosmic slate theme, elegant typography, real-time feedback, and dynamic socket connections.

## Features
- **Round-Based Card Mechanics**: Receive and hold market intelligence cards for entire rounds, planning multiple turns in advance before the final results are processed.
- **Dynamic Valuation & Volatility**: Different stocks feature varied volatility margins (e.g., Wockhardt has capped volatility while Infosys is a high-stakes, highly volatile asset).
- **Socket.IO Integration**: Robust real-time connectivity with reconnection backup, room sync, and keep-alive stability.
- **Your Holdings Sidebar**: Clear real-time visualization of all stock assets, purchase rates, and net portfolio assets.

## Hugging Face Spaces Deployment

This repository is pre-configured to build and run seamlessly on **Hugging Face Spaces** as a Docker app.

### Deployment Configuration
- **SDK**: Docker
- **Default Port**: 7860 (Hugging Face default)