Skip to content

Latest commit

 

History

History
88 lines (64 loc) · 2.92 KB

README.md

File metadata and controls

88 lines (64 loc) · 2.92 KB

DistroHopper Wheel of Fortune

Title Image

Welcome to the DistroHopper Wheel of Fortune! This project is a fun and interactive way to decide which Linux distribution you should try next. Built with React and Vite, it features a spinning wheel that randomly selects a Linux distro for you.

Table of Contents

Features

  • Interactive Wheel: Spin the wheel to randomly select a Linux distribution.
  • Easy Mode: Simplifies the selection process.
  • Super Easy Mode: Further simplifies the selection process.
  • Responsive Design: Works well on both desktop and mobile devices.
  • Confetti Animation: Celebrate your new distro with a confetti animation.
  • Help Menu: Access helpful links and report issues directly from the app.

Installation

To get started with the DistroHopper Wheel of Fortune, follow these steps:

  1. Clone the repository:

    git clone https://github.com/halsschmerzen/distrohopper-wheel.git
cd distrohopper-wheel

  2. Install dependencies:

    npm install

  3. Start the development server:

    npm run dev

  4. Open your browser and navigate to:

    http://localhost:5173/distrohopper-wheel/

Usage

Once the development server is running, you can start using the DistroHopper Wheel of Fortune:

  1. Spin the Wheel: Click on the wheel to spin it and randomly select a Linux distribution.
  2. View Result: A window will pop up displaying the selected distribution along with a brief description.
  3. Easy Mode: Enable Easy Mode to simplify the selection process.
  4. Super Easy Mode: Enable Super Easy Mode for an even simpler selection process.
  5. Help Menu: Click on the Help button in the toolbar to access helpful links and report issues.

Configuration

You can customize the behavior of the wheel and other features by modifying the configuration files:

  • [src/data/descriptions.js]: Contains descriptions for each Linux distribution.
  • [src/data/segments.js]: Customize the segments for the wheel.

Contributing

I welcome contributions to the DistroHopper Wheel of Fortune! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request on GitHub.

  1. Fork the repository
  2. Create a new branch: 
    git checkout -b feature/your-feature-name
  3. Make your changes and commit them: 
    git commit -m 'Add some feature'
  4. Push to the branch: 
    git push origin feature/your-feature-name
  5. Open a pull request

Made with ❤️ on EndeavourOS by halsschmerzen. If you enjoy this project, please consider leaving a star on GitHub!