The C&A certified 32-bit workstation built for trapped souls ⎛⎝( ` ᢍ ´ )⎠⎞ᵐᵘʰᵃʰᵃ

---

Caution

Photosensitivity/Epilepsy Warning This project features retro CRT screen shaders, flashing animations, and fast-moving visual effects (such as the CAINE animation sequence). If you have a history of epilepsy or photosensitivity, please exercise caution when interacting with the live demo.

Good News: You can completely disable the CRT and scanline effects! Check out the Settings & Customization Guide to learn how to toggle visual effects and protect your eyes.

What is KingOS 95?

An entirely local browser-based Operating System (OS) that is inspired by the computer in The Amazing Digitial Circus and by Windows 95 and 98. See a demo here : KingOS 95 - Vercel, fully in your browser.

Note

Useful Info:

• Login Credentials:
• • Username: kinger
• • Password: queenie123 or Leave Empty
• Classic Scenario : Go to My Computer -> Characters -> AI -> CAINE, then spam your keys or Enter to trigger the animation loop!

Windows Boot screen		Startup		Login
Desktop			Bios
Purge AI Error

Core feature

• Custom Vector Window Manager: A lightweight window manager supporting zIndex layering, minimizing, maximizing, dragging and resizing window
• Virtual JSON Filesystem Mapping: Dynamic folder and document structure using only a JSON file
• CRT Shader: Scanline and aesthetic from retro display. Overlays optimized for web performance
• Start Menu: Handles internal application spawns, external link, and direct OS state toggles (Log Off / Shut Down).
• BIOS Menu: You can now open an AMI like BIOS !
• Bespoke Digital Circus Ecosystem Applications:
  • CaineApp: The classic Cmd used in the show !
  • PurgeAIProgram: The app with the progress bar when Caine is being deleted
  • Netscape Inbox & Network Neighborhood
  • My Briefcase & Recycle Bin

Built with...

This project was built to be lightweight, fast, and free of heavy frontend frameworks. Here is what I used:

• Vanilla HTML, CSS, and JavaScript: for the whole app ! ദ്ദി(˵ •̀ ᴗ - ˵ ) ✧
• Vite: for local development and production bundling
• 98.css: for the pixel-perfect retro UI components (like the windows, buttons, etc...)

Stardance Devlogs ᕙ( •̀ ᗜ •́ )ᕗ

On Stardance you can watch the full development process via all the devlogs i've created here : KingOS 95 Devlogs

How to contribute ?

Contribution, bug reports and Easter Egg ideas are welcome (˶ᵔᗜᵔ˶)ﾉﾞ !

The Virtual Filesystem

If you are adding a new file, folder, or application that the user can open via the File Explorer, you must register it in the filesystem JSON.

1. Create your file/app logic in the src/ folder
2. Open src/data/filesystem.json
3. Add your file exactly like this :

"C:\\ParentDirectory": [
    { "name": "YourFileName.yourextension", "type": "(e.g: file or folder)" }
],

4. Test it locally before submitting a Pull Request

Development

Important

You must have Node, NPM or PNPM downloaded on your computer

Dependencies

• vite
• Node.js
• PNPM (or NPM)
• sass-embedded
• 98.css

Building

• Clone the repository with

git clone https://github.com/wirenux/KingOS-95.git
cd KingOS-95

• Then install the dependencies with:

pnpm install
# or npm install

Running KingOS 95 Locally

You can run KingOS 95 with the command:

pnpm dev

KingOS 95 should be running at localhost:5173

Boring Stuff

Other

🌐 Browser Compatibility & Quirks (Click to expand)

[!WARNING] KingOS 95 mainly targets Chromium and Firefox, but should work on most browser. For a list of know browser specific quirks check this document.

Use of AI

• Brainstorming + README.md idea

Credits

This project is created by @wirenux and use 98.css and modified code from CSS CRT screen effect.

License

This project use the MIT License