A web application for simulating random events with customizable choices and weights.

It includes an Admin Dashboard for managing the choices and weights, as well as a User Interface for running events and exporting the results to Excel.

• Customizable Random Events
• Admin Dashboard
• User Interface
• Export to Excel
• Different Sessions

• Node.js
• pnpm

Clone the repository

git clone https://github.com/RedPhortex/random.git

Go to the cloned directory

cd random

Install dependencies

pnpm install

Run the development server

Create and adjust .env file.

See [.env.example](.env.example).

pnpm run dev

After running the development server, the app will be accessible at http://localhost:5173. The admin dashboard is accessible at /admin for modifying choices and weights.

Generate a production build

pnpm run build

Check if the code is well formatted

pnpm run format

pnpm run lint

• React - Front-end framework
• Joy UI - Component library
• Socket.io - Real-time communication
• Vite Express - Development server
• Tailwind CSS - Utility-first CSS framework
• Eslint - JavaScript linter
• Prettier - Code formatter
• Bunshi - Global state management
• Valtio - Proxy-based state management
• XLSX - Excel file generation

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