Skip to content

Hamstersarus/HamstersarusOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐹 HamstersarusOS

A personal website and portfolio built as a tiny web operating system. Instead of a plain "about me" page, you land on a desktop and get to know me and my work by clicking around, opening windows, browsing projects, playing games, and poking through apps.

Built for Hack Club Stardance, following the webOS jam.


✨ Features

Double click the desktop icons to open apps.

Portfolio

  • About Me 🐹 - who I am, plus my likes and dislikes.
  • Projects 📁 - cards for my projects (this OS, SENTINEL, Fight, 2048), each linked to its code.
  • Skills 🛠️ - languages and tools shown as proficiency bars.
  • Resume 📄 - education, experience, and awards.
  • Contact ✉️ - GitHub, LinkedIn, and email.

The OS itself

  • Welcome screen - a pixel logo and a fake "neofetch" terminal that boots you into the desktop.
  • Desktop & top bar - graph-paper wallpaper, a live clock, and clickable app icons.
  • Draggable windows - drag them by the title bar, click to bring one to the front, and close them with the ×.
  • Music player 🎵 - lofi tracks start playing the moment you enter, with a "now playing" notification. Play / pause / skip from the app, and it keeps playing even after you close its window.
  • 2048 🎮 - a fully playable, purple-themed version of the game.
  • Message me 💬 - leave a message and it goes straight to my inbox.
  • Magic Hamster Ball - magic-8-ball type fortune teller with a hamster telling your fortune.

🎮 Controls

  • Double-click a desktop icon to open its app.
  • Drag a window by its title bar to move it; click it to bring it forward; × to close.
  • In 2048, use the arrow keys or WASD to slide the tiles. Combine matching numbers to reach 2048!

🎨 The look

A dreamy lavender "Tokyo Night" desktop crossed with a Y2K Windows scrapbook vibe, soft purple graph paper, dark windows with neon-purple borders, and pixel + retro-terminal fonts. The wallpaper grid is pure CSS (no image!).

🪄 Inspiration

I really like customizing my desktop so I have spent a lot of time researching. The desktop aesthetic with the purple effects and the Y2K look comes from a combination of desktop rice looks and old aesthetics from my many moodboards. I also reallyyy like hamsters (sooo difficult to tell, I know).

💬 Message Me

While drafting ideas of different things I could make, I decided it would be interesting to make an app that would allow the user to send messages directly towards me. My first idea was to make a Gmail, but I decided to link a Discord webhook through Cloudflare.

🛠️ Built with

Plain HTML, CSS, and JavaScript.

HamstersarusOS/
├── index.html        # the whole OS
├── css/style.css     # all styling + the design system
├── js/
│   ├── os.js         # boot, desktop, clock, icons
│   ├── windows.js    # the draggable-window system + app registry
│   └── apps/
│       ├── game2048.js
│       └── music.js
└── assets/music/     # drop your songs here

▶️ Run it locally

No install needed. Either open index.html in a browser, or (recommended) serve it:

python3 -m http.server 8000

Then visit http://localhost:8000. Using a local server avoids browser caching issues while editing.

🎵 Adding your own music

  1. Put .mp3 files in assets/music/.
  2. List them in the playlist array in js/apps/music.js.

Made with 🐹 by Hamstersarus.

Releases

Packages

Contributors

Languages