WZ Tournament Platform

A modern TypeScript-based tournament platform for gaming competitions, built with React, Express.js, and PostgreSQL.

🚀 Features

• Tournament Management: Create and manage gaming tournaments with customizable settings
• User Authentication: Telegram-based authentication system
• Real-time Updates: WebSocket support for live tournament updates
• Responsive Design: Modern UI built with React and Tailwind CSS
• Database Integration: PostgreSQL with Drizzle ORM for type-safe database operations

🏗️ Project Structure

├── client/          # React frontend application
├── server/          # Express.js backend API
├── shared/          # Shared types and database schemas
├── attached_assets/ # Static assets and media files
└── dist/           # Build output directory

🛠️ Tech Stack

Frontend

• React 18 with TypeScript
• Vite for fast development and building
• Tailwind CSS for styling
• Radix UI components for accessible UI
• TanStack Query for data fetching
• Framer Motion for animations

Backend

• Express.js with TypeScript
• PostgreSQL database
• Drizzle ORM for database operations
• WebSocket support for real-time features
• Passport.js for authentication

Development Tools

• TypeScript for type safety
• ESLint and Prettier for code quality
• Vite for development server and building

🚀 Getting Started

Prerequisites

• Node.js 18 or higher
• PostgreSQL database
• npm or yarn package manager

Installation

1. Clone the repository:

git clone <repository-url>
cd WZ

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.example .env
# Edit .env with your configuration

4. Set up the database:

npm run db:push

5. (Optional) Seed demo tournaments:

npm run seed

6. Start the development server:

npm run dev

The application will be available at http://localhost:5173

📝 Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Start production server
• npm run check - Type check with TypeScript
• npm run db:push - Push database schema changes
• npm run seed - Seed demo tournaments with sample data

🏆 Tournament Features

• Battle Royale Tournaments: Support for battle royale style competitions
• Entry Fees & Prizes: Configurable entry fees and prize pools
• Participant Management: Handle participant registration and limits
• Tournament Status: Track upcoming, active, and completed tournaments
• User Stars System: Track user achievements and standings

🔧 Development

Code Style

This project uses ESLint and Prettier for consistent code formatting. Run the linters before committing:

npm run lint
npm run format

Database

The project uses Drizzle ORM with PostgreSQL. Schema files are located in the shared/ directory.

To make database changes:

1. Edit schema files in shared/schema.ts
2. Run npm run db:push to apply changes

📦 Deployment

1. Build the project:

npm run build

2. Set production environment variables

3. Start the production server:

npm run start

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests and linting
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.