Skip to content

rupnil-codes/Override.exe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

108 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Override.exe

Override.exe

React.JS %5E19.2.4 GNU AGPL 3.0 Hackatime Badge Commit Activity Commit History

Your PC has been compromised by a group called the "HackClub". Can you regain control?


Table of Contents


Overview

Override (Override.exe) is a simple webOS inspired by Microsoft Windows 11 (no hate pls) that includes a special bonus! The special bonus is, ofc, a puzzle game divided into 6 simple steps (or 7 if you count the lockscreen) each testing a different knowledge/skill. I've tried to make the puzzles very easy to solve, while also providing info and hints.

Caution

Hints and Info can be found in the ProgressPanel on the top-right!

Caution

If you don't want to play the puzzles but want to view the puzzles, you can go to decrypt/puzzle.md


Backstory

You have applied for a Cybersecurity internship @Hackclub's HQ. They receive 100s of applications but there are only a handful of seats. They have devised a plan. They have organized a practical test. They have taken control over your PC. Can you regain control and show your skills?

You can skip this test and just use the webOS normally. Its optional but I highly recommend it.


Requirements

  • A modern browser with JS support,
  • A keyboard and a mouse,
  • Curiosity and sheer will, &
  • Basic problem-solving skills

Usage: Quick Start

Pre-hosted

An instance of the ReactJS app is hosted by me through Vercel. You can easily access this hosted instance at override.rupnil.codes! The hosted website is compatible with most modern browsers and thus most OS.

Building from source

Idk why you would want to build from the source when i have it deployed, but here u go anyways.

Before building make sure you have the following installed:

  • Node.js (Version 20 or higher)
  • npm (comes with Node.js) or similar, e.g. pnpm/yarn/etc.

1. Clone the repository

git clone https://github.com/rupnil-codes/Override.exe.git
cd Override.exe

2. Install Dependencies

npm install
npm update

3. Run Development Server

npm run dev

or

npx vite

4. Build for Production

npm run build

Then the final compiled webapp will be in the dist/ directory.


Features:

I've tried adding as many features as I could, here are some:

  • Windows like lockscreen and login animation
  • 1:1 replica of the taskbar (atleast i hope so)
  • Different apps!
  • Games!
  • Puzzles/ARG stuff!

Unfinished Features:

  • Start menu (non-functional)
  • Settings App (non-functional)
  • Explorer App (non-functional)
  • Other QOL changes check out CHANGELOG.md

What I Learnt

This project really taught me a ton of stuff and tbh i wanna work on this in the future!

Technical Skills

  • ReactJS: This was honestly my first time using ReactJS + Vite for web development, and I learnt so much during this journey! While there were some instances where I felt like giving up, I struggled through and reached a fruitful end!
  • CSS: Being fr, before this project i wasn't good at CSS but it changed!

Problem Solving

  • Asynchronous stuff with JS
  • Managing large codebases (although this may not be so big)
  • Structuring the codebase
  • Writing README's in detail!

Personal Note:

This project was really one of the fewest that I actually invested time and FINISHED with success! I'm sooo proud of my creation. I would like to extend my gratitude to Hackclub for providing such an awesome platform!


Project Status

Version: v0.4.7-beta

Latest Release Version: v0.4-beta

Status: Actively developing as of now


Contributors

There are several well-wishers and playtesters who have helped me improve the app, either by playtesting or providing valuable feedback. I've listed them in no particular order.

  1. @Flux3tor,
  2. @Snxhit_,
  3. @Matthias,
  4. @Nx75,
  5. @Keyboard1000n17,
  6. @abtheinnovator,
  7. @redac1ed, ← Supplied the browser!
  8. @TruthEntity, ← Thanks for the inspiration!
  9. @SeradedStripes, &
  10. @stunt

If i forgot to mention anyone, pls DM me on slack!


Made with πŸ’– by @rupnil.codes

If you found this project interesting, consider giving it a star :D

Report a Bug or Suggest a new Feature

About

Your PC has been compromised by a group called the "HackClub". Can you regain control?

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors