Stocks Royale

Stocks Royale is a real-time stock trading and betting platform that combines traditional market mechanics with gamified elements.

Features

• Real-time Market Data: Interactive candlestick charts powered by lightweight-charts.
• Binary Betting: Place "Green or Red" bets on short-term price movements.
• Portfolio Management: Track holdings, positions, and account value in real-time.
• Gamified Trading: Unique mechanics to make trading more engaging.

Tech Stack

Client

• Framework: Next.js 16 (React 19)
• Styling: SCSS / Sass
• Charts: Lightweight Charts, Recharts

Server

• Runtime: Node.js
• Framework: Express.js
• Database: PostgreSQL
• Real-time: Socket.io

Getting Started

Prerequisites

• Node.js (v18+ recommended)
• PostgreSQL database
• npm or bun

Installation

1. Clone the repository:

   git clone https://github.com/Brkic365/Stocks-Royale.git
   cd Stocks-Royale

2. Install Dependencies:

   npm run install:all

   Or install individually:

   npm install
   cd server && npm install && cd ..
   cd client && npm install && cd ..

3. Set up your .env file in the server directory with your PostgreSQL database credentials.

4. Start Development Servers:

   Option 1: Run both together (Recommended):

   npm run dev

   This starts both the server and client concurrently.

   Option 2: Run separately:

   # Terminal 1 - Server
   npm run dev:server
   # or
   cd server && npm run dev
   
   # Terminal 2 - Client
   npm run dev:client
   # or
   cd client && npm run dev

5. Access the App:

   • Client: http://localhost:3000
   • Server API: http://localhost:4000