vtjhyn / ubuntu-play

ubuntu-play is a web-based interface that mimics the Ubuntu operating system

🌟 Ubuntu-Play

Ubuntu-Play is a web-based interface that mimics the Ubuntu operating system, built using React. This project aims to provide a familiar Ubuntu-like environment accessible through a web browser.

• Demo
• Preview Dev

---

📦 Installation

To get started with Ubuntu-Play, follow these steps:

1. Clone the repository:

   git clone https://github.com/vtjhyn/ubuntu-play.git
   cd ubuntu-play

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

   The app will be available at http://localhost:5173.

📝 Semantic Commit Messages

We follow the Conventional Commits specification for commit messages. Here's the structure:

• feat: A new feature
• fix: A bug fix
• docs: Documentation changes
• style: Code style changes (formatting, etc.)
• refactor: Code changes that neither fix a bug nor add a feature
• perf: Performance improvements
• test: Adding or correcting tests
• build: Changes to the build process or dependencies
• ci: Continuous Integration changes
• chore: Other changes that don't modify src or test files
• revert: Reverts a previous commit

Examples

feat(navbar): add new status indicator
fix(lockscreen): correct logic for unlocking screen on key press
docs: update README with installation instructions
style: improve code formatting in StatusCard component
refactor: extract utility functions from Navbar component
test: add unit tests for formatTime utility

🌈 Contributing

Contributions are welcome! Before contributing, please read our Contribution Guidelines.

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Commit your changes (git commit -m 'feat: add new feature').
4. Push to the branch (git push origin feature-branch).
5. Create a Pull Request.

📜 License

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

---

Happy coding! 🚀✨